apex-parser

Warrior of Internet Freedom

---

🔗 Ссылки на подписки

🛡 WhiteList (Белые списки)

GitHub

https://raw.githubusercontent.com/Diversan313/apex-parser/main/subs/main/alive_bs.txt

🌐 BlackList (Wi-Fi)

GitHub

https://raw.githubusercontent.com/Diversan313/apex-parser/main/subs/main/alive_bl.txt

🚀 Full List (All-in-One)

GitHub

https://raw.githubusercontent.com/Diversan313/apex-parser/main/subs/main/alive_full.txt

Форматы и зеркала

Список	Base64	Plain	YAML
🛡 WhiteList	GitHub · GitVerse · jsDelivr	GitHub · GitVerse · jsDelivr	GitHub · GitVerse · jsDelivr
🌐 BlackList	GitHub · GitVerse · jsDelivr	GitHub · GitVerse · jsDelivr	GitHub · GitVerse · jsDelivr
🚀 Full List	GitHub · GitVerse · jsDelivr	GitHub · GitVerse · jsDelivr	GitHub · GitVerse · jsDelivr

---

🧩 Other

Список	Base64	Plain	YAML
🤖 AI	GitHub · GitVerse · jsDelivr	GitHub · GitVerse · jsDelivr	GitHub · GitVerse · jsDelivr
🧲 Torrent	GitHub · GitVerse · jsDelivr	GitHub · GitVerse · jsDelivr	GitHub · GitVerse · jsDelivr

🌍 Countries

Для каждой страны доступны три формата: Base64, Plain и YAML.

Замените XX на двухбуквенный код нужной страны.

Base64

https://raw.githubusercontent.com/Diversan313/apex-parser/main/subs/other/countries/XX/alive_XX.txt

Plain

https://raw.githubusercontent.com/Diversan313/apex-parser/main/subs/other/countries/XX/alive_plain_XX.txt

YAML

https://raw.githubusercontent.com/Diversan313/apex-parser/main/subs/other/countries/XX/alive_XX.yaml

Примеры кодов: NL — Нидерланды · DE — Германия · US — США.

Полный список доступных стран: Countries.

---

О проекте

apex-parser — открытый проект, созданный с нуля для автоматического сбора, фильтрации, проверки и публикации рабочих конфигураций.

Цель проекта — автоматизировать сбор, проверку и агрегацию сетевых конфигураций из открытых источников, предоставляя актуальные списки для мобильного интернета (белые списки) и глобального Wi-Fi использования.

FNAP (Free Network Access Provider) — собственный термин проекта, обозначающий модель работы Sentinel: бесплатное предоставление доступа к агрегированным сетевым конфигурациям без коммерческой составляющей. Это авторское обозначение роли конкретного компонента проекта, а не заявление о юридическом статусе оператора связи или провайдера в официальном смысле.

Весь код, представленный в данном репозитории (за исключением закрытых уникальных частей проекта в apex-sources), полностью открыт для использования, изучения, доработки и распространения.

Это один из немногих проектов, который действительно открыл уникальный код и свои наработки для сообщества. В отличие от большинства аналогичных решений, которые работают исключительно на закрытых машинах авторов, здесь логика доступна каждому.

Проект написан полностью с нуля. Никаких заимствований чужих или готовых решений — только собственная разработка, прошедшая через ошибки и баги, ведущая к постоянным улучшениям, адаптированная под реальные задачи.

Основные возможности

• Сбор конфигураций из нескольких источников (sources-файлы с отобранными источниками, Telegram-модуль).

• Разделение на WhiteList (для белых списков) и BlackList (для Wi-Fi использования).

• Дополнительная классификация: AI и Torrent.

• Проверка живости конфигураций, дедупликация, геофильтрация, ограничение по IP и подсетям для уникальности.

• Автоматическое формирование итоговых списков в subs/main/:

  • alive_*.txt (Base64)
  • alive_plain_*.txt (Plain)
  • alive_*.yaml (YAML / Clash)

• Дополнительные списки в subs/other/:

  • AI (alive_AI.*)
  • Torrent (alive_torrent.*)
  • списки по странам (countries/)

• Поддержка протоколов: VLESS, Hysteria2, VMess, Trojan, Shadowsocks и др.

• Интеграция с Telegram-ботом @Sent1nel0_bot для удобного доступа, статистики и работы с закрытым apex-sources.

Проверенные приложения (кроме iOS / macOS)

* — не рекомендуется

Клиент	Платформы	Источник для скачивания
Exclave	Android	GitHub (Релизы)
v2rayNG	Android	GitHub (Релизы)
v2rayN	Windows, macOS, Linux	GitHub (Релизы)
Throne	Windows, Linux, macOS	GitHub
INCY	Android, iOS, macOS	GitHub
Karing	Android, iOS, Windows, macOS, Linux	Официальный сайт · GitHub
Streisand	iOS, macOS	App Store
V2Box	Android, iOS, macOS	App Store · Google Play
NekoBox *	Android, Windows, Linux	GitHub Android · GitHub Desktop
Hiddify *	Android, iOS, Windows, macOS, Linux	Официальный сайт · GitHub

Клиент Happ и похожие из списка клиенты не рассчитаны на подписки такого объёма (плохо справляются с большим количеством конфигов) — лучше используйте один из клиентов вверху списка (автор сидит на них).

Что и для чего?

• apex/ — основной набор парсера:

  • main.py — основная логика
  • parser.py — точка входа (wrapper)
  • parse.py, xray.py, fetch.py, dedup.py, classify.py, geoip.py
  • diversify.py, incoming.py, sni_whitelist.py, utils.py, config.py
  • modules/parser_tg.py — модуль обновления источников через Telegram

• white_ip.txt — список белых IP-адресов для белых списков

• subs/main/ — публикуемые готовые списки (alive_*.txt, alive_plain_*.txt, alive_*.yaml)

• subs/other/ — дополнительные списки (AI, Torrent, countries)

• arch/ — архив, вспомогательные данные

• stats/ — статистика

• .github/workflows/ — автоматизация обновлений

• requirements.txt — зависимости (Python 3.10+)

Весь этот код можно свободно использовать, модифицировать и запускать у себя.

Если вы разработчик и хотите подробнее разобрать логику и правила работы, то вам в Инструкция и логика.

Полные условия использования и политика обработки данных — в DISCLAIMER.md.

Закрытый репозиторий apex-sources

Для стабильной и защищённой работы основной логики используется закрытый репозиторий apex-sources. Он содержит уникальные части бэкенда, которые намеренно не публикуются в открытом доступе.

Ключевые файлы и их назначение:

• sources_wl.txt — перечень источников для WhiteList (белые списки). Источники, оптимизированные под мобильный интернет.
• sources_bl.txt — перечень источников для BlackList (Wi-Fi). Источники, используемые для Wi-Fi с зарубежными локациями.
• sources_tg.txt — конфигурация Telegram-источников. Указывает, из каких топиков и каналов автоматически подтягиваются свежие ссылки.
• incoming_subs.txt — файл для работы и связи бота с apex-sources.

Остальные файлы в закрытом репозитории носят вспомогательный характер (резервные копии, временные данные) и иногда могут использоваться как среда для тестирования. Основная публичная логика и готовые результаты всегда находятся в открытом репозитории apex-parser.

Закрытый репозиторий обеспечивает защиту уникальных источников и настроек, при этом результаты работы регулярно публикуются в открытый доступ.

Лицензия и использование (MIT)

Код открытого репозитория доступен свободно по лицензии MIT. Вы можете использовать его в личных и коммерческих целях, дорабатывать, запускать на своих серверах и делиться улучшениями. Уникальные части бэкенда (закрытый репозиторий) остаются приватными и не предназначены для публичного распространения.

Спасибо

Благодарность проектам, инструментам и источникам, которые используются или вдохновили apex-parser:

• Xray-core (Project X) — ядро для проверки живости конфигураций
• ip-api.com, ip.sb, ip2location.io — онлайн GeoIP-сервисы
• cron-job.org — сервис для запуска Github Actions по расписанию
• MaxMind GeoLite2 / P3TERX/GeoLite.mmdb — оффлайн база GeoIP
• hxehex/russia-mobile-internet-whitelist — SNI-список для мобильного интернета
• RKP_bypass_configs (RKP)
• zieng2/wl (zieng)
• goida-vpn-configs (Avencores)
• MIFA

---

Проект создан и поддерживается как pet-проект в области сетевых технологий. Код написан с нуля, через собственные ошибки и решения. Если вы используете или дорабатываете проект — будет приятно узнать об этом.