# Геонастройки / Routing Приложение поставляется с предустановленными геофайлами, что обеспечивает его готовность к работе сразу после установки. Актуальность геофайлов поддерживается обновлением версии ядра внутри приложения. {% hint style="info" %} Важно! В JSON-подписках приложение использует только гео-файлы от активного или дефолтного профиля. Все правила берутся исключительно из самой JSON-конфигурации подписки. {% endhint %} #### **Добавление правил маршрутизации** Приложение позволяет добавлять правила маршрутизации автоматически, используя специальные ссылки, которые можно создать на сайте [https://routing.happ.su](https://routing.happ.su/). Ссылки могут быть переданы одним из следующих способов: * Через буфер обмена. * С использованием deeplink. * Через QR-код. * В виде HTTP-заголовков или тела подписки. Для передачи через HTTP-заголовок используется параметр `routing`, а для добавления в тело подписки достаточно указать ссылку. #### **Обработка ошибок загрузки** Приложение использует менеджер загрузки геофайлов, который работает в фоновом режиме. * Если загрузка геофайлов не завершается в течение 3 минут, процесс останавливается. * На главном экране появляется сообщение об ошибке. * В списке профилей рядом с проблемным профилем отображается красный восклицательный знак. #### **Устранение ошибок** Проблемное состояние профиля исчезает автоматически после: * Успешного завершения загрузки файлов. * Удаления проблемного профиля. Если в списке больше нет проблемных профилей, уведомления об ошибках удаляются. #### **Виды ссылок:** * `happ://routing/add/{base64}`: Добавляет профиль в список профилей. Первый добавленный профиль становится активным только после успешной загрузки геофайлов. Если профиль с таким именем уже существует, он перезаписывается. * `happ://routing/onadd/{base64}`: Добавляет и автоматически активирует профиль, даже если другие профили уже активны. Если профиль с таким именем уже существует, он перезаписывается. * `happ://routing/off`: Отключит функционал маршрутизации `{base64}`:это JSON-профиль, преобразованный в текстовый формат base64. #### **Структура профилей** Приложение использует профили маршрутизации, которые настраиваются через JSON. **Профиль по умолчанию** содержит базовые настройки, используемые для заполнения отсутствующих или некорректных параметров. **Пример профиля по умолчанию:** ```json { "GlobalProxy": "true", "RemoteDNSType": "DoH", "RemoteDNSDomain": "https://cloudflare-dns.com/dns-query", "RemoteDNSIP": "1.1.1.1", "DomesticDNSType": "DoH", "DomesticDNSDomain": "https://dns.google/dns-query", "DomesticDNSIP": "8.8.8.8", "Geoipurl": "https://github.com/Loyalsoldier/v2ray-rules-dat/releases/latest/download/geoip.dat", "Geositeurl": "https://github.com/Loyalsoldier/v2ray-rules-dat/releases/latest/download/geosite.dat", "DnsHosts": { "cloudflare-dns.com": "1.1.1.1", "dns.google": "8.8.8.8" }, "DirectSites": [], "DirectIp": [ "10.0.0.0/8", "172.16.0.0/12", "192.168.0.0/16", "169.254.0.0/16", "224.0.0.0/4", "255.255.255.255" ], "DomainStrategy": "IPIfNonMatch", "FakeDNS": "false" } ``` **Пример пользовательского профиля:** ```json { "Name": "China", "GlobalProxy": "true", "RemoteDNSType": "DoH", "RemoteDNSDomain": "https://cloudflare-dns.com/dns-query", "RemoteDNSIP": "1.1.1.1", "DomesticDNSType": "DoU", "DomesticDNSDomain": "", "DomesticDNSIP": "8.8.8.8", "Geoipurl": "https://github.com/Loyalsoldier/v2ray-rules-dat/releases/latest/download/geoip.dat", "Geositeurl": "https://github.com/Loyalsoldier/v2ray-rules-dat/releases/latest/download/geosite.dat", "LastUpdated": "", "DnsHosts": { "cloudflare-dns.com": "1.1.1.1" }, "DirectSites": ["geosite:cn", "geosite:geolocation-cn"], "DirectIp": [ "geoip:cn", "10.0.0.0/8", "172.16.0.0/12", "192.168.0.0/16", "169.254.0.0/16", "224.0.0.0/4", "255.255.255.255" ], "ProxySites": ["geosite:cn"], "ProxyIp": ["geoip:amazon"], "BlockSites": ["geosite:ads"], "BlockIp": ["geoip:ads"], "DomainStrategy": "IPIfNonMatch", "FakeDNS": "false" } ``` #### **Особенности работы с профилями** * Если профиль с таким же именем уже существует, его данные обновляются. * Если у профиля есть параметр `"LastUpdated": ""` и он содержит дату в формате Unix, которая больше предыдущего значения, он будет обновлён. #### Схема добавления / обновления профиля {% embed url="" %} **Пример http headers:** ``` HTTP/2 200 date: Wed, 24 Nov 2024 10:00:52 GMT content-type: application/json content-length: 3798 content-disposition: attachment; filename="213" routing: happ://routing/onadd/ewogICAgIk5hbWUiOiAidGVzdCIsCiAgICAiR2xvYmFsUHJveHkiOiAidHJ1ZSIsCiAgICAiUmVtb3RlRG5zIjogIiIsCiAgICAiRG9tZXN0aWNEbnMiOiAiIiwKICAgICJHZW9pcHVybCI6ICIiLAogICAgIkdlb3NpdGV1cmwiOiAiIiwKICAgICJEbnNIb3N0cyI6IHt9LAogICAgIkRpcmVjdFNpdGVzIjogW10sCiAgICAiRGlyZWN0SXAiOiBbXSwKICAgICJQcm94eVNpdGVzIjogW10sCiAgICAiUHJveHlJcCI6IFtdLAogICAgIkJsb2NrU2l0ZXMiOiBbXSwKICAgICJCbG9ja0lwIjogW10sCiAgICAiRG9tYWluU3RyYXRlZ3kiOiAiQXNJcyIKfQ== ``` **Пример тела подписки:** ``` happ://routing/onadd/ewogICAgIk5hbWUiOiAidGVzdCIsCiAgICAiR2xvYmFsUHJveHkiOiAidHJ1ZSIsCiAgICAiUmVtb3RlRG5zIjogIiIsCiAgICAiRG9tZXN0aWNEbnMiOiAiIiwKICAgICJHZW9pcHVybCI6ICIiLAogICAgIkdlb3NpdGV1cmwiOiAiIiwKICAgICJEbnNIb3N0cyI6IHt9LAogICAgIkRpcmVjdFNpdGVzIjogW10sCiAgICAiRGlyZWN0SXAiOiBbXSwKICAgICJQcm94eVNpdGVzIjogW10sCiAgICAiUHJveHlJcCI6IFtdLAogICAgIkJsb2NrU2l0ZXMiOiBbXSwKICAgICJCbG9ja0lwIjogW10sCiAgICAiRG9tYWluU3RyYXRlZ3kiOiAiQXNJcyIKfQ== vmess://eyJob3N0IjoiZ3Vhdmypc3RhbmJ1bC5jb20iLCJwYXRoIjoiXC8xUyIsInRscyI6InRscyIsImFkZCI6Ind3dy5ndWF2ZWlzdGFuYnVsLmNvbSIsInBvcnQiOjQ0MywiYWlkIjowLCJuZXQiOiJ3cyIsInR5cGUiOiJub25lIiwiZnAiOiJjaHJvbWUiLCJhbHBuIjoiaHR0cFwvMS4xIiwibm9kZV9zc19wdWJsaWNrZXkiOiIiLCIiOmZhbHNlLCJ2IjoiMiIsInBzIjoiXHVkODNjXHVkZGU5XHVkODNjXHVkZGVhIDRHIC0gR2VybWFueSAtIDAxIiwiaWQiOiI4YjhkYWI4NC03OGEzLTNhMWItYTE1NS03M2FkNDk1ZTY0NmUifQ== vless://70cc43c5-b2f4-34ac-a092-d806984a6b8c@1.13.7.91:443?encryption=none&security=reality&pbk=qGPTy8EZokn3hWp6hKBQ0MVvEuLRJCcv5UdWeP4TVhI&headerType=none&fp=chrome&type=tcp&flow=xtls-rprx-vision&sni=booking.com&sid=6ba85179e30d4fc2#%F0%9F%87%B1%F0%9F%87%B9%20Test ``` #### Настройки маршрутизации, которые определяют логику обработки трафика, работу DNS и правила фильтрации ресурсов. *** ### 1. Основные настройки * **Название (`name`)**: Имя профиля для идентификации пользователем **По умолчанию: Default**. * **Глобальный прокси (`globalProxy`)**: * `true`: Весь трафик по умолчанию идет через прокси (первым в списке устанавливается `outbound` с тэгом `proxy`) **По умолчанию: `true`**. * `false`: По умолчанию используется прямое соединение (первым в списке устанавливается `outbound` с тэгом `direct`). *Примечание: Это также определяет «выход» (outbound) по умолчанию, если ни одно правило маршрутизации не сработало.* * **Дата обновления (lastUpdatedDate):** Это метка времени последнего изменения профиля или геофайлов. Она управляет актуальностью геофайлов (`geoip.dat`, `geosite.dat`) на устройствах пользователей. Как это работает: * Первая установка: Если при сохранении профиля поле `lastUpdatedDate` заполнено, приложение принудительно скачает геофайлы. Это произойдет даже в том случае, если их URL совпадают со стандартными. * Обновление (Force Download): С помощью этого параметра можно инициировать принудительное перекачивание баз (например, при обновлении подписки). Условие срабатывания: Скачивание начнется, если новая дата `lastUpdatedDate` позже текущей или если старая дата в профиле отсутствует. ### 2. Конфигурация DNS Система разделяет DNS-запросы на локальные (Domestic) и удаленные (Remote) для оптимизации скорости отклика и учета географического расположения ресурсов. #### Удаленный DNS (Remote) — для запросов `proxy` ресурсов через прокси сервер * **Тип (`remoteDnsType`)**: Протокол запроса (например, DoH — DNS over HTTPS, DoU — DNS over UDP). * *По умолчанию:* `DoU`. * **Домен (`remoteDnsDomain`)**: Адрес сервера. **Обязателен**, если выбран тип `DoH`. * *По умолчанию:* `https://cloudflare-dns.com/dns-query`. * **IP (`remoteDnsIp`)**: Статический IP-адрес сервера для исключения проблем с поиском самого DNS-сервера. * *По умолчанию:* `1.1.1.1`. #### Локальный DNS (Domestic) — для запросов `direct` ресурсов в минуя прокси сервера (напрямую) * **Тип (`domesticDnsType`)**: Протокол запроса. * *По умолчанию:* `DoU`. * **Домен (`domesticDnsDomain`)**: Адрес сервера. **Обязателен**, если выбран тип `DoH` * *По умолчанию:* `dns.google/dns-query`. * **IP (`domesticDnsIp`)**: Статический IP-адрес сервера для исключения проблем с поиском самого DNS-сервера. * *По умолчанию:* `8.8.8.8`. #### Дополнительно * **DNS Hosts (`dnsHosts`)**: Список ручных соответствий «Домен: IP». Работает как системный файл `hosts`. Не отображается в интерфейсе приложения, встраивается напрямую в секцию `dns.hosts` конфигурации Xray. Для подробностей см. [документацию Project X](https://xtls.github.io/ru/config/dns.html). * **Fake DNS (fakeDnsEnabled)**: Подмена реального IP-адреса виртуальным. Это гарантирует, что все запросы направляются только в Xray, исключая их перехват системным DNS, и обрабатываются строго согласно конфигурации Xray. *** ### 3. Правила и списки маршрутизации Трафик распределяется по трем категориям: 1. **Прямое подключение (`directSites` / `directIp`)**: Ресурсы, доступ к которым будет осуществляться без прокси. 2. **Прокси (`proxySites` / `proxyIp`)**: Ресурсы, требующие туннелирования. 3. **Блокировка (`blockSites` / `blockIp`)**: Запрещенные ресурсы (реклама, трекеры). #### Ресурсы Geo-баз * **GeoIP URL (`geoipUrl`)**: * **Geosite URL (`geositeUrl`)**: *** ### 4. Продвинутые параметры #### Стратегия доменов (`domainStrategy`) Определяет, как Xray сопоставляет домены с правилами IP: * **AsIs**: Xray вообще не пытается резолвить (узнавать IP) домен на этапе маршрутизации. Он передает доменное имя «как есть» следующему этапу. * **IPIfNonMatch**: Сначала Xray пытается сопоставить запрос с правилами по домену. Если подходящего правила не нашлось, он делает DNS-запрос, получает IP и проверяет правила еще раз, но уже по IP. * **IPOnDemand**: Как только запрос попадает в систему маршрутизации, Xray всегда резолвит домен в IP-адрес перед тем, как проверять любые правила. #### Использование оптимизированных файлов (`useChunkFiles`) Эта функция позволяет вырезает из геофайлов указанные секции и передаёт ядру уже обрезанные геофайлы. Это позволяет не падать ядру на старте при ограничениях памяти в iOS (50мб). Нарезка и сохранение оптимизированных файлов выполняется по условиям: 1. При сохранении нового профиля с путями по умолчанию (loyalsoldier). Скачивание не происходит, создаются урезанные файлы (ip/site) из уже существующих в приложении. 2. После завершения скачивания геофайла (site/ip) — независимо от того, произошло это при сохранении профиля, авто-обновлении или запуске пользователем вручную. 3. После выхода из редактора правил (direct/proxy/block), если в них были внесены изменения. {% hint style="warning" %} Внимание: Если вы используете JSON-конфигурацию подписки, помните, что нарезка секций осуществляется на основе профиля маршрутизации, а не JSON-конфигурации. Убедитесь, что в профиле маршрутизации созданы те же теги, что и в вашей JSON-конфигурации. {% endhint %} #### Порядок маршрутизации (`routeOrder`) Определяет приоритет проверки правил. Трафик проверяется по списку почередно: 1. Приложение берет первое правило из списка `routeOrder`. 2. Если совпадения нет, переходит к следующему. 3. Если ни одно правило не подошло, трафик направляется в основной выход (Proxy, если `globalProxy` включен, или Direct, если выключен). *** --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://www.happ.su/main/ru/dev-docs/routing.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.