Оптимизированные конфигурации маршрутизации (роутинга) для мобильных устройств для клиентов Happ, INCY и Shadowrocket на базе кастомных легковесных баз GeoIP и Geosite.
Проект автоматически собирает компактные бинарные базы правил (geoip.dat и geosite.dat), блокирует крупные рекламные сети и обеспечивает прямое соединение (Direct) с российскими сервисами без задержек VPN, направляя заблокированные и зарубежные ресурсы в прокси-туннель.
| Профиль | Файл диплинка (.DEEPLINK) | JSON-конфиг (для подписки) | Описание |
|---|---|---|---|
| DEFAULT | DEFAULT.DEEPLINK | DEFAULT.JSON | Основной профиль: RU/BY, банки, гос. сервисы, Twitch напрямую. YouTube, Telegram, GitHub и зарубежный интернет — через прокси. Реклама заблокирована. |
| WHITELIST | WHITELIST.DEEPLINK | WHITELIST.JSON | Белый список: Напрямую идут только проверенные ресурсы из geosite:whitelist и geoip:whitelist (банки, Госуслуги и др.). Весь остальной интернет — через прокси. |
| BASIC | BASIC.DEEPLINK | BASIC.JSON | Базовый профиль: Настроены DoH DNS, ссылки на кастомные базы geodata и прямой доступ для системных пуш-уведомлений (geosite:apple-push, geosite:android-push), без других правил (для ручной настройки). |
| Профиль | Автообновление (Autorouting) | Разовый импорт (.DEEPLINK) | JSON-конфиг | Описание |
|---|---|---|---|---|
| DEFAULT | DEFAULT.AUTOLINK | DEFAULT.DEEPLINK | DEFAULT.JSON | Основной профиль: Полная маршрутизация с разделением RU-трафика и зарубежных ресурсов. |
| WHITELIST | WHITELIST.AUTOLINK | WHITELIST.DEEPLINK | WHITELIST.JSON | Белый список: Прямой доступ только к доверенным государственным и банковским сервисам. |
| BASIC | BASIC.AUTOLINK | BASIC.DEEPLINK | BASIC.JSON | Базовый профиль: Системные пуши напрямую, DNS и базы geodata для тонкой ручной кастомизации. |
Импортируйте нужный .CONF файл по ссылке в Shadowrocket (Config ➔ + ➔ вставить URL):
- 🛡️ DEFAULT.CONF — основной профиль со всеми оптимизациями.
- 📋 WHITELIST.CONF — режим строгого белого списка.
- ⚙️ BASIC.CONF — базовый профиль без предустановленных правил маршрутизации сайтов.
Правила проверяются по порядку block → proxy → direct (RouteOrder: block-proxy-direct), и срабатывает первое совпадение. Поэтому домен из списка Proxy уйдёт в VPN, даже если он (или его родительский домен) есть в списке Direct.
- Блокировка (Block / Reject):
- Рекламные сети и баннеры (
geosite:category-ads). Аналитика (Google Analytics, AppsFlyer и т.п.) не блокируется: без неё ломаются сайты и ссылки в приложениях. - Торрент-трекеры (
geosite:torrent), предотвращающие утечки в туннель и нагрузку на сервер.
- Рекламные сети и баннеры (
- Проксирование (Proxy):
- Заблокированные и международные социальные сети: YouTube (
geosite:youtube), Telegram (geosite:telegram), Instagram / Threads (geosite:instagram), X / Twitter (geosite:twitter). - Инструменты разработки: GitHub (
geosite:github). - Ресурсы, блокирующие пользователей из РФ (GeoBlock): AI-сервисы (ChatGPT, Claude, Gemini, Copilot), Canva, Spotify, Notion и др. (
geosite:category-geoblock-ru).
- Заблокированные и международные социальные сети: YouTube (
- Системные исключения (Direct):
- Push-уведомления Apple (
geosite:apple-push) и Google FCM / Huawei HMS / Xiaomi (geosite:android-push). - Загрузка системных обновлений iOS/macOS (
geosite:apple-update). - Скачивание APK и приложений из Google Play (
geosite:google-play). - Домены локального определения IP (
geosite:domains-geo-detect). - VoWiFi / IMS операторов связи: домен
3gppnetwork.orgвgeosite:whitelistи IP шлюзов ePDG вgeoip:whitelist(IKE/IPsec не несёт домена, поэтому маршрут выбирается по IP).
- Push-уведомления Apple (
- Прямое соединение (Direct):
- Локальные и приватные адреса (
geosite:private,geoip:private). - Российские ресурсы, порталы и банки (
geosite:category-ru,geoip:direct— IP РФ/РБ без заблокированных РКН и зарубежных CDN, плюсCUSTOM-LIST-ADD.txt). - Ресурсы белого списка (
geosite:whitelist,geoip:whitelist). - Стриминг и медиа: Twitch (
geosite:twitch), Pinterest (geosite:pinterest).
- Локальные и приватные адреса (
- Финальное правило (Catch-all): весь остальной трафик, не попавший ни в одно правило выше (в том числе по IP), направляется через Proxy.
В профиле WHITELIST в Proxy идут category-geoblock-ru, youtube, instagram и twitter, а напрямую — только системные исключения и белый список. Сайт, домен которого не найден в списках, проверяется по IP: Happ/INCY (DomainStrategy: IPIfNonMatch) и Shadowrocket одинаково узнают IP и сверяют его с geoip:direct / geoip:whitelist.
Все сгенерированные конфигурации по умолчанию используют защищённые и оптимизированные DoH/DoH3 резолверы с разделением запросов:
- Remote DNS (для зарубежных и заблокированных доменов):
Quad9 DoH3/DoH—https://dns.quad9.net/dns-query(IP:9.9.9.9)
- Domestic DNS (для прямого соединения и российских ресурсов):
Yandex DoH—https://common.dot.dns.yandex.net/dns-query(IP:77.88.8.8)
- Статические DNS-записи (
DnsHosts):- Прямой резолвинг кабинетов ФНС (
lkfl2.nalog.ru,lknpd.nalog.ru) для гарантированного доступа.
- Прямой резолвинг кабинетов ФНС (
Скомпилированные файлы всегда доступны в ветке release и через глобальный CDN:
| Файл | Описание | Прямая ссылка через jsDelivr CDN |
|---|---|---|
geoip.dat |
Бинарная база диапазонов IP | https://cdn.jsdelivr.net/gh/pincetgore/PinRouting@release/geoip.dat |
geosite.dat |
Бинарная база доменных правил | https://cdn.jsdelivr.net/gh/pincetgore/PinRouting@release/geosite.dat |
geoip.dat.sha256 |
Контрольная сумма SHA-256 | https://cdn.jsdelivr.net/gh/pincetgore/PinRouting@release/geoip.dat.sha256 |
geosite.dat.sha256 |
Контрольная сумма SHA-256 | https://cdn.jsdelivr.net/gh/pincetgore/PinRouting@release/geosite.dat.sha256 |
text.tar.gz |
Текстовые дампы CIDR списков | В релизах GitHub Releases |
JSON-профили Happ и INCY (подписка и автообновление) ссылаются не на @release, а на конкретный коммит ветки release (@<sha>): такие ссылки jsDelivr отдаёт без устаревшего кэша, а новый коммит приходит с ежедневным обновлением профиля. Разовый импорт через .DEEPLINK профиль не обновляет, поэтому в диплинках стоит @release: по нему всегда скачивается последняя сборка, хотя jsDelivr может несколько часов отдавать прежние файлы.
В репозитории настроен автоматический пайплайн GitHub Actions:
- Проверяет синтаксис и валидность всех профилей и правил (
ruff,pinrouting lint). - Загружает свежие списки GeoLite2, DB-IP, IPinfo, Re:filter, Antifilter и CDN (пустой, битый или сократившийся вдвое против прошлого релиза список останавливает сборку; если сокращение настоящее, запустите workflow вручную с
accept_list_sizes). - Компилирует бинарные файлы
geoip.datиgeosite.datчерезgeoip-toolиdomain-list-community(версии сборщиков закреплены по SHA). Слишком большой итоговый списокdirect/whitelist(например,0.0.0.0/0в чужом списке) останавливает сборку. - Генерирует клиентские конфигурации Happ, INCY и Shadowrocket (IP-списки Shadowrocket строятся из тех же
direct/whitelist, что иgeoip.dat). - Запускает тесты (
pinrouting test): модульные тесты изtests/и симуляцию роутинга всех профилей на только что собранных конфигурациях. - Публикует релизы: сначала ветку
releaseс бинарниками и контрольными суммами (профили ссылаются на её коммит), затем GitHub Release с архивомtext.tar.gz. Предыдущие релизы и их теги удаляются, остаётся только последний.
Расписание запуска: ежедневно в 01:00 UTC, при каждом коммите в репозиторий или вручную через Actions.
- Проверяет домены через 3 независимых DNS-резолвера (
1.1.1.1,8.8.8.8,77.88.8.8): домен считается неживым, только если все резолверы ответилиNXDOMAIN. Ошибки и таймауты считаются «жив». - Формирует детальный отчет в Markdown и JSON (прикрепляется к GitHub Step Summary и артефактам).
- Удаляет неживые домены, пересобирает конфиги, прогоняет линтер и тесты и создает Pull Request (
action: pr) либо коммитит в ветку.
IP-списки не проверяются: APNs и RU-only хосты не отвечают зарубежным CI-раннерам, поэтому «нет ответа» не значит «не используется».
Расписание запуска: ежемесячно 1-го числа в 03:00 UTC или вручную через Actions (workflow_dispatch).
├── .github/workflows/
│ ├── build-and-update.yml # Автоматизированный CI/CD пайплайн сборки
│ └── check-dead-entries.yml # Проверка и очистка неживых доменов (PR / Commit)
├── HAPP/ # Конфигурации и диплинки для клиента Happ
│ ├── DEFAULT.JSON / .DEEPLINK
│ ├── WHITELIST.JSON / .DEEPLINK
│ └── BASIC.JSON / .DEEPLINK
├── INCY/ # Конфигурации для клиента INCY (автообновление и разовый импорт)
│ ├── DEFAULT.JSON / .AUTOLINK / .DEEPLINK
│ ├── WHITELIST.JSON / .AUTOLINK / .DEEPLINK
│ └── BASIC.JSON / .AUTOLINK / .DEEPLINK
├── SHADOWROCKET/ # Конфигурации и списки правил для Shadowrocket
│ ├── DEFAULT.CONF # Основной профиль маршрутизации
│ ├── WHITELIST.CONF # Профиль белого списка РФ
│ ├── BASIC.CONF # Базовый профиль для подписки
│ ├── EXTENDED.CONF # Шаблон пользовательских правил (include)
│ └── rules/ # Сгенерированные списки правил (.list)
├── geoip/ # Конфигурация и кастомные списки GeoIP
│ ├── config.json # Правила объединения баз и вычитания списков РКН
│ ├── CUSTOM-LIST-ADD.txt # Зарубежная инфраструктура Yandex и Apple APNs
│ └── CUSTOM-WHITELIST.txt # Кастомный белый список подсетей
├── geosite/
│ ├── buildtools/ # Скрипты тестирования, линтинга и дедупликации доменов
│ │ ├── lint_rules.py # Линтер синтаксиса (по правилам v2fly) и избыточности правил
│ │ ├── test_routing.py # Симуляция и регрессионное тестирование роутинга
│ │ └── deduplicate.py # Анализатор пересечений IP и доменов
│ └── data/ # Текстовые списки доменов по категориям
├── profiles/ # SSOT JSON-манифесты профилей (DEFAULT, WHITELIST, BASIC)
├── tools/ # Пакет PinRouting CLI и инструментов автоматизации
│ └── pinrouting/
│ ├── cli/
│ │ ├── build.py # Сборка конфигураций всех клиентов
│ │ ├── check_dead.py # Проверка и очистка неживых доменов
│ │ ├── check_iplists.py # Проверка размеров IP-списков при сборке geoip
│ │ ├── lint.py # Линтинг профилей и правил
│ │ └── test.py # Модульные тесты и регрессионные тесты роутинга
│ ├── emitters/ # Генераторы форматов HAPP/INCY (json_client.py) и Shadowrocket
│ ├── geosite.py # Единый разбор строк geosite (как в v2fly)
│ └── models.py # Модели конфигураций и профилей
├── tests/ # Модульные тесты (запускаются в make test)
├── Makefile # make lint, make test, make build, make check-dead
├── pyproject.toml # Конфигурация Python проекта и линтера Ruff
├── LICENSE # Лицензия MIT
└── README.md # Документация проекта
Проект агрегирует данные, списки и инструменты из следующих открытых источников:
- Loyalsoldier/geoip — инструмент компиляции бинарных баз
geoip.dat. - v2fly/domain-list-community — компилятор бинарных баз правил
geosite.dat.
- @ip-location-db — ежедневные выгрузки сопоставления IP и стран (GeoLite2, DB-IP Lite).
- Davoyan/ipinfo — ежедневные списки IP-диапазонов IPinfo Lite для России и Беларуси.
- Loyalsoldier/geoip (ветка release) — зеркало базы MaxMind GeoLite2 ASN для фильтрации подсетей по номерам автономных систем (ASN).
- Re:filter — актуальные списки заблокированных ресурсов (ipsum, community).
- Antifilter.Network — выгрузка заблокированных IP-адресов.
- Antifilter Community — общественный список блокировок.
- PentiumB/CDN-RuleSet — сводная база диапазонов глобальных CDN.
- mansourjabin/cdn-ip-database — база IP-адресов сетей доставки контента.
- DigneZzZ/routing — архитектурные подходы к оптимизации мобильного роутинга и концепции сквозного тестирования правил.
- escapingworm/russia-whitelist — проверенные белые списки подсетей РФ (CIDR).
- kirilllavrov/RU-domain-list-for-whitelist — списки российских доменов для белого списка.
- hxehex/russia-mobile-internet-whitelist — белые списки ресурсов мобильного интернета РФ.
- pincetgore/amnezia-app-ru-list — структурированные базы доверенных доменов РФ по отраслям.
- misha-tgshv/shadowrocket-configuration-file — база сайтов кредитных организаций ЦБ РФ, чекеры доступности и шаблоны конфигураций Shadowrocket.
- roscomvpn-routing, roscomvpn-geoip, roscomvpn-geosite — базовые правила маршрутизации от hydraponique.
Проект распространяется под открытой лицензией MIT. Вы можете свободно использовать, модифицировать и распространять его как в личных, так и в коммерческих целях с обязательным сохранением указания авторства.
Если проект оказался вам полезен и помогает удобно маршрутизировать трафик, вы можете поддержать его развитие и поблагодарить автора: