Skip to content

Latest commit

 

History

1,157 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

apex-parser

Warrior of Internet Freedom

Telegram Bot License


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

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

GitHub

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

GitVerse

https://gitverse.ru/api/repos/bikinitw22/apelsintel/raw/branch/main/alive_bs.txt

jsDelivr

https://cdn.jsdelivr.net/gh/Diversan313/apex-parser/subs/main/alive_bs.txt

🌐 BlackList (Wi-Fi)

GitHub

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

GitVerse

https://gitverse.ru/api/repos/bikinitw22/apelsintel/raw/branch/main/alive_bl.txt

jsDelivr

https://cdn.jsdelivr.net/gh/Diversan313/apex-parser/subs/main/alive_bl.txt

🚀 Full List (All-in-One)

GitHub

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

GitVerse

https://gitverse.ru/api/repos/bikinitw22/apelsintel/raw/branch/main/alive_full.txt

jsDelivr

https://cdn.jsdelivr.net/gh/Diversan313/apex-parser/subs/main/alive_full.txt

О проекте

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

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

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

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

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

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

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

  • Сбор конфигураций из нескольких источников (sources файлы с отобранными источниками, Telegram модуль).
  • Разделение на WhiteList (для белых списков) и BlackList (для Wi-Fi использования).
  • Проверка живости конфигураций, дедупликация, геофильтрация, ограничение по IP и подсетям для уникальности.
  • Автоматическое формирование итоговых списков: alive_bs.txt, alive_bl.txt, alive_full.txtsubs/main/).
  • Поддержка как наиболее устойчивых протоколов (например 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, parse.py, xray.py, fetch.py, dedup.py, classify.py, geoip.py и др.).
  • apex/parser.py — точка входа.
  • apex/modules/parser_tg.py — модуль обновления источников через Telegram.
  • white_ip.txt — список белых IP-адресов для белых списков.
  • subs/main/alive_*.txt — публикуемые готовые списки рабочих конфигураций.
  • 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_sources.txt / incoming_subs.txt — файлы для работы и связи бота с apex-sources.

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

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

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

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

Спасибо

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


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