Свои правила маршрутизации в Happ: формат, порядок, примеры

Как устроено правило маршрутизации в Happ: условие, действие, порядок проверки. Как записать домен, подсеть, geo-список, порт или приложение, рабочие наборы и ошибки.

Правило маршрутизации в Happ — это условие плюс действие: «если соединение подходит под условие, отправить его туда-то». Условий много, действий три, а главное свойство — порядок: список читается сверху вниз, срабатывает первое подходящее правило, до остальных дело не доходит. Все «правило не работает» упираются либо в порядок, либо в формат условия.

Из чего состоит правило

Условия (в одном правиле может быть несколько, тогда должны совпасть все):

• домен — суффикс (example.com покрывает поддомены), точное имя (full:…), ключевое слово (keyword:…), регулярное выражение — редко нужно;
• geo-список — geosite:… по доменам или geoip:… по адресам, что это;
• IP или подсеть — 203.0.113.0/24, 2001:db8::/32;
• порт — например, port:25 для почты или диапазон;
• протокол сети — TCP или UDP;
• приложение — только Android, по имени пакета.

Действия: через сервер (proxy), напрямую (direct), заблокировать (block). В некоторых версиях вместо «через сервер» можно выбрать конкретный сервер или группу.

1. Сформулируйте задачу словами: «сайт такой-то — напрямую», «всё по UDP на порт такой-то — через сервер».
2. Выберите самое узкое условие, которое её описывает. Домен точнее geo-списка, geo-список точнее «всё остальное».
3. Добавьте правило и поставьте его выше более широких правил, которые могли бы перехватить то же соединение.
4. Переподключитесь.
5. Проверьте на реальном соединении, а не на глаз: адрес на сайте, лог в приложении с пометкой, по какому правилу ушло соединение.

Рабочие наборы

Минимальный, «как в подписке»:

geoip:private            → direct
geosite:ru, geoip:ru     → direct
всё остальное            → proxy

С исключениями под себя — добавляются выше:

bank.example             → direct     (сайт банка на зарубежном CDN)
geosite:telegram         → proxy      (мессенджер всегда через сервер)
geosite:category-ads-all → block
geoip:private            → direct
geosite:ru, geoip:ru     → direct
всё остальное            → proxy

Правила по конкретным доменам — как их записывать — всегда сверху, списки ниже, «всё остальное» последним. Подписка Вятка приходит с базовым набором, и добавлять к нему стоит только строки первого блока.

Типичные ошибки

• Правило ниже «всего остального». Не сработает никогда. Переместите.
• example.com вместо суффикса. В некоторых версиях точное совпадение без поддоменов; www.example.com пройдёт мимо. Проверьте на поддомене.
• Домен, а приложение ходит по IP. Имя не видно — правило по домену молчит. Добавьте правило по IP или geoip.
• Правило «напрямую» для домена, который напрямую недоступен. Сайт перестаёт открываться вообще. Уберите или замените на «через сервер».
• Block на домен, от которого зависит приложение. Приложение зависает при старте. Отключите правило и посмотрите, поможет ли.
• Правки без переподключения. Изменения применяются при поднятии туннеля.