Геонастройки / Routing

Приложение поставляется с предустановленными геофайлами, что обеспечивает его готовность к работе сразу после установки. Актуальность геофайлов поддерживается обновлением версии ядра внутри приложения.

Добавление правил маршрутизации

Приложение позволяет добавлять правила маршрутизации автоматически, используя специальные ссылки, которые можно создать на сайте 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.

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

Пример профиля по умолчанию:

{
    "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"
}

Пример пользовательского профиля:

{
    "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, которая больше предыдущего значения, он будет обновлён.

Схема добавления / обновления профиля

Пример 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://[email protected]: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.

• Fake DNS (fakeDnsEnabled): Подмена реального IP-адреса виртуальным. Это гарантирует, что все запросы направляются только в Xray, исключая их перехват системным DNS, и обрабатываются строго согласно конфигурации Xray.

---

3. Правила и списки маршрутизации

Трафик распределяется по трем категориям:

1. Прямое подключение (directSites / directIp): Ресурсы, доступ к которым будет осуществляться без прокси.

2. Прокси (proxySites / proxyIp): Ресурсы, требующие туннелирования.

3. Блокировка (blockSites / blockIp): Запрещенные ресурсы (реклама, трекеры).

Ресурсы Geo-баз

• GeoIP URL (geoipUrl): https://github.com/Loyalsoldier/v2ray-rules-dat/releases/latest/download/geoip.dat

• Geosite URL (geositeUrl): https://github.com/Loyalsoldier/v2ray-rules-dat/releases/latest/download/geosite.dat

---

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), если в них были внесены изменения.

Внимание: Если вы используете JSON-конфигурацию подписки, помните, что нарезка секций осуществляется на основе профиля маршрутизации, а не JSON-конфигурации. Убедитесь, что в профиле маршрутизации созданы те же теги, что и в вашей JSON-конфигурации.

Порядок маршрутизации (routeOrder)

Определяет приоритет проверки правил. Трафик проверяется по списку почередно:

1. Приложение берет первое правило из списка routeOrder.

2. Если совпадения нет, переходит к следующему.

3. Если ни одно правило не подошло, трафик направляется в основной выход (Proxy, если globalProxy включен, или Direct, если выключен).

---