# Геонастройки / Routing Приложение поставляется с предустановленными геофайлами, что обеспечивает его готовность к работе сразу после установки. Актуальность геофайлов поддерживается обновлением версии ядра внутри приложения. #### **Добавление правил маршрутизации** Приложение позволяет добавлять правила маршрутизации автоматически, используя специальные ссылки, которые можно создать на сайте [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, если выключен). ***