🧯 Фильтры профиля в Zapret 2: как движок решает, какой профиль обработает соединение

О чём заметка

Что такое фильтры профиля в Zapret 2, как по ним выбирается профиль для соединения, в каком порядке проверяются условия внутри профиля, что важнее чего и почему профиль иногда «не срабатывает». Здесь же — справочник всех фильтров. Подробно о списках: сайты — hostlist, адреса — ipset. Не путать с фильтрами захвата nftables — те решают, какой трафик вообще попадёт в движок. Где выбор профиля стоит в общем конвейере, см. схема обработки трафика.

TL;DR

  • Профиль = фильтры (к какому трафику он относится) + стратегия (—lua-desync). Профили разделяются строкой --new.
  • Соединение проверяется по профилям сверху вниз; его забирает первый профиль, у которого прошли все проверки. Не подошёл ни один — соединение достаётся скрытому профилю no_action, который ничего не делает.
  • Внутри профиля условия объединяются логикой И, значения внутри одного фильтра — логикой ИЛИ (--filter-tcp=80,443 — порт 80 или 443), несколько файлов списков одного вида — тоже ИЛИ.
  • Порядок проверок внутри профиля: порты и протокол → исключения по адресам → адреса → (имя сайта известно?) → исключения по сайтам → сайты. Исключение всегда сильнее включения.
  • Адрес известен с первого пакета, имя сайта — только с приветствия TLS. Пока имени нет, профиль со списком сайтов в выборе не участвует, и первые пакеты обрабатывает профиль ниже.

Что такое фильтр профиля

Профиль в Zapret 2 состоит из двух половин. Фильтры отвечают на вопрос «это соединение — моё?»: какие порты, какой протокол, какие адреса и сайты. Действия — строки --lua-desync — отвечают на вопрос «что с ним делать». Пресет — это несколько профилей подряд, каждый со своими фильтрами и своей стратегией. Полный список фильтров с синтаксисом — в руководстве движка docs/manual.md; ниже он пересказан с примерами.

Это не фильтры захвата WinDivert/nftables

Отбор идёт на двух уровнях. Сначала фильтр захвата (--wf-* на Windows, правила nftables/iptables на Linux) решает, какие пакеты вообще передать из системы в движок nfqws2/winws2 — это грубое сито ради экономии. И только потом фильтры профиля из этой заметки выбирают, какой профиль и какая стратегия обработают уже захваченное соединение. Пакет, не прошедший фильтр захвата, до профилей не дойдёт.

Как выбирается профиль

Как движок выбирает профиль: сверху вниз, первый совпавший Для нового соединения движок проверяет профили сверху вниз и отдаёт соединение первому, у которого совпали все фильтры. Если не подошёл ни один, соединение достаётся скрытому профилю no_action, который ничего не делает. Выбор кэшируется в conntrack. профили пресета, пример новое соединение Профиль 1 Исключения (pass) --hostlist=ru-sites.txt Профиль 2 youtube.com --filter-tcp=443 --hostlist=youtube.txt Профиль 3 Весь TLS --filter-tcp=443 --filter-l7=tls № 0 no_action (скрытый) фильтров нет — совпадает со всем поиск идёт строго по порядку: первое совпадение побеждает, остальные профили не смотрят rutube.ru:443 ✓ совпал достаётся профилю 1: остальные не проверяются youtube.com:443 ✕ не подошёл ✓ совпал профиль 1 не подошёл, профиль 2 подошёл — стоп example.org:443 ✕ не подошёл ✕ не подошёл ✓ совпал профили 1 и 2 не подошли, профиль 3 подошёл — стоп UDP 3478 ✕ не подошёл ✕ не подошёл ✕ не подошёл ✓ совпал не подошёл ни один: действий нет, соединение идёт как есть Выбор запоминается в conntrack и пересматривается не больше двух раз: когда распознанпротокол и когда найдено имя сайта. Внутри профиля фильтры объединяются через И, значения внутри одного фильтра — через ИЛИ.

Выбор делает функция dp_match в исходнике nfq2/desync.c. Порядок такой:

  1. Соединение проверяется по профилям сверху вниз, от первого к последнему.
  2. Первый профиль, у которого прошли все проверки, забирает соединение, и поиск прекращается. Профили ниже его уже не видят.
  3. Если не подошёл ни один, соединение достаётся скрытому профилю no_action (служебный номер 0). Движок сам добавляет его последним при запуске; действий в нём нет, поэтому с соединением ничего не происходит. Подробнее — в заметке об исключениях.

Отсюда главное правило составления пресета: узкие профили ставьте выше широких. Профиль «YouTube» должен стоять над профилем «все сайты», иначе широкий профиль заберёт и YouTube.

Выбор запоминается, но может пересматриваться

Чтобы не искать профиль заново на каждый пакет, движок запоминает выбор в записи о соединении (conntrack — таблица, где движок хранит состояние каждого открытого соединения). Пересмотр возможен не больше двух раз за соединение: когда движок распознал протокол (например, понял, что это TLS) и когда узнал имя сайта. Именно поэтому профиль со списком сайтов может забрать соединение не с первого пакета, а позже.

Порядок проверок внутри профиля

Диаграмма в начале заметки показывает шесть проверок, через которые проходит соединение в одном профиле. Условия, которых в профиле нет, считаются пройденными: профиль без списков подходит любому сайту и адресу на своих портах.

  1. Порты и протокол — --filter-tcp, --filter-udp, --filter-l7 и остальные фильтры по заголовкам пакета (справочник ниже).
  2. Исключения по адресам — --ipset-exclude, --ipset-exclude-ip. Адрес нашёлся хотя бы в одном — профиль не подходит.
  3. Включения по адресам — --ipset, --ipset-ip. Хватит совпадения в любом списке.
  4. Имя сайта уже известно? Если у профиля есть списки сайтов, а имени у движка ещё нет, профиль сейчас не подходит. Он вернётся в выбор, когда имя появится.
  5. Исключения по сайтам — --hostlist-exclude, --hostlist-exclude-domains.
  6. Включения по сайтам — --hostlist, --hostlist-domains. Хватит совпадения в любом списке.

Не прошла хотя бы одна проверка — профиль не подходит, и соединение проверяет следующий профиль.

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

Адрес известен сразу, имя сайта — позже

Адрес сервера есть в самом первом пакете соединения. Имя сайта движок берёт из приветствия TLS (ClientHello — первое сообщение браузера в HTTPS-соединении, где открытым текстом написано имя сайта), из заголовка Host в HTTP или из приветствия QUIC. В обычном HTTPS-соединении это четвёртый пакет, после трёх пакетов установки соединения.

Профиль со списком сайтов ждёт имя сайта, профиль по адресам — нет Пока в соединении не пришло приветствие TLS с именем сайта, профиль со списком сайтов в выборе не участвует, и первые пакеты достаются профилю ниже. Когда имя появилось, движок пересматривает выбор, и соединение переходит к профилю со списком сайтов. Профиль 1 · YouTube--hostlist=youtube.txt Профиль 2 · Все сайты (айпи)--ipset-exclude=ipset-ru.txt профили пресета пакеты одного соединения с youtube.com SYNимени нет → профиль 2 SYN-ACKимени нет → профиль 2 ACKимени нет → профиль 2 TLS ClientHelloимя: youtube.com → профиль 1 данныеимя известно → профиль 1 Пока имени нет, профиль 1 пропускается целиком, и первые пакеты обрабатывает профиль 2 своейстратегией. С приветствия TLS движок знает имя и отдаёт соединение профилю 1 — выборпересматривается не больше двух раз. Профиль по адресам (ipset) решает с первого пакета: адрес сервера известен сразу.

Пример. В пресете два профиля: «YouTube» со списком сайтов и ниже «Все сайты (айпи)», у которого только исключения по адресам. Пока имени нет, «YouTube» в выборе не участвует, и первые пакеты соединения с youtube.com достаются «Все сайты (айпи)» — его стратегия успевает на них сработать. С приветствием TLS движок узнаёт имя, пересматривает выбор, и соединение переходит к «YouTube».

На практике это важно для стратегий, которые работают с самых первых пакетов (например, syndata). Если такая стратегия стоит в широком профиле по адресам, она сработает и для сайтов, у которых есть свой профиль по именам. Подробно этот случай разобран в заметке об исключениях.

Что важнее чего: сводная таблица

ПравилоЧто значит на практике
Профиль выше важнее профиля нижесоединение забирает первый подошедший профиль
Исключение важнее включенияадрес или сайт из --ipset-exclude/--hostlist-exclude профиль не возьмёт, даже если он есть во включающем списке
Все условия профиля — через «И»профиль с --filter-tcp=443, --ipset и --hostlist сработает, только если совпали порт, адрес и сайт
Несколько файлов одного вида — через «ИЛИ»хватит совпадения в любом --hostlist (или любом --ipset)
Адреса решают раньше сайтовпрофиль по адресам участвует в выборе с первого пакета, по сайтам — с приветствия TLS
В списке сайтов самая конкретная запись важнее общей!torrents.ru сильнее ru — см. hostlist
Пустой список = нет условияпрофиль с пустым файлом списка подходит всем сайтам или адресам
Профиль с автосписком (--hostlist-auto) забирает соединения с известным именем всегдаего список решает только, применять ли стратегию

Фильтры по заголовкам пакета

Почти все фильтры принимают несколько значений через запятую, поддерживают инверсию (~ перед значением — «всё, кроме») и * — «любое».

ФильтрЧто отбираетСинтаксис
--filter-l3версия IP-протоколаipv4 или ipv6 (можно оба через запятую)
--filter-tcpпорты TCP[~]port[-port] или *, через запятую
--filter-udpпорты UDP[~]port[-port] или *, через запятую
--filter-icmpтип и код ICMPtype[:code] или *, через запятую
--filter-ippномер «сырого» IP-протоколаproto или *, через запятую
--filter-l7протокол соединенияproto[,proto,…]
--filter-ssidимя Wi-Fi-сети (не на всех платформах)ssid[,ssid,…]

--filter-tcp и --filter-udp — порты

Отбирают по портам TCP или UDP. Порт — номер «двери» на сервере: HTTPS обычно на 443, HTTP на 80, QUIC (HTTP/3) — UDP 443. Поддерживаются одиночный порт, диапазон port1-port2, инверсия ~port и *.

--filter-tcp=80,443        # порт 80 или 443
--filter-tcp=1000-2000     # диапазон 1000–2000
--filter-tcp=~443          # все TCP-порты, кроме 443
--filter-tcp=*             # все TCP-порты
--filter-udp=443           # QUIC (UDP 443)

Указание только TCP отключает UDP (и наоборот)

Если в профиле есть --filter-tcp, но нет --filter-udp, UDP этот профиль не обрабатывает вовсе, и наоборот. Чтобы профиль работал с обоими, укажите оба фильтра (при необходимости с *).

--filter-l7 — протокол соединения

Отбирает по протоколу всего соединения — ярлыку, который движок ставит, распознав соединение по содержимому: http, tls, quic, wireguard, mtproto, dns, stun, discord, dht, xmpp, dtls, bt, utp_bt. Спецзначения: all — любой, known — любой распознанный, unknown — нераспознанный.

--filter-l7=tls            # только TLS/HTTPS
--filter-l7=tls,http       # TLS или HTTP
--filter-l7=quic           # только QUIC (HTTP/3)

Протокол распознаётся не с первого пакета, поэтому профиль с --filter-l7 тоже может забрать соединение не сразу — это первый из двух пересмотров выбора. Разница между протоколом соединения и типом отдельного пакета разобрана в payload.

--filter-l3, --filter-icmp, --filter-ipp, --filter-ssid

--filter-l3=ipv6              # только IPv6
--filter-icmp=3:4,11          # ICMP type 3 code 4 или type 11 с любым кодом
--filter-ipp=47               # GRE (протокол 47)
--filter-ssid=MyHomeWiFi      # только в этой Wi-Fi-сети

--filter-ipp нужен для протоколов, которые не TCP, не UDP и не ICMP (подробнее — структура desync и диссекта). --filter-ssid доступен не на всех платформах.

Списки IP и доменов

Кроме фильтров по заголовкам, профиль отбирают по спискам: адресов серверов — ipset и сайтов — hostlist. У обоих есть исключающие варианты (--ipset-exclude, --hostlist-exclude): «профиль для всех, кроме…». На них строятся исключения в пресетах.

ipset — адресаhostlist — сайты
Что в строкеадрес или подсеть: 1.2.3.4, 10.0.0.0/8, IPv6домен: youtube.com (поддомены учитываются сами)
Когда решаетс первого пакетас приветствия TLS / HTTP / QUIC
Префиксынет^домен — без поддоменов, !домен — исключение из этого файла
Повтор записине мешаетработает первая запись домена
Список прямо в строке--ipset-ip, --ipset-exclude-ip--hostlist-domains, --hostlist-exclude-domains
Пустой файлподходит всем адресамподходит всем сайтам

Один и тот же файл нельзя подключить в профиле дважды одного типа — с 31 октября 2026 года движок на это не запускается. Всё о формате, примерах и частых ошибках — в заметках hostlist и ipset.

Внутрипрофильные фильтры: --payload, --in-range, --out-range

Кроме фильтров выбора профиля, есть фильтры внутри профиля. Они не решают, подходит ли профиль, а ограничивают отдельные строки --lua-desync: к каким пакетам соединения применять действие. После определения такой фильтр действует на все следующие строки --lua-desync до переопределения.

  • --payload — тип содержимого пакета (tls_client_hello, http_req, all и другие); полный разбор — payload.
  • --out-range и --in-range — какие по счёту пакеты обрабатывать; разбор — out-range.
  • Аргументы dir и payload у самой функции --lua-desync — то же на уровне одного действия.
--payload=tls_client_hello
--lua-desync=fake:blob=fake_default_tls:dir=out

Примеры пресетов

Сайты по списку и всё остальное по адресам

--filter-tcp=443 --hostlist=lists/youtube.txt
--lua-desync=multisplit
--new
--filter-tcp=80,443 --ipset-exclude=lists/ipset-ru.txt
--lua-desync=fake:blob=fake_default_tls

YouTube обрабатывает первый профиль, но только с приветствия TLS; до него и для всех остальных сайтов, кроме российских адресов, работает второй.

Исключение внутри исключения

--filter-tcp=443
--hostlist-exclude-domains=ru,!torrents.ru
--lua-desync=fake:blob=fake_default_tls

Профиль для всех сайтов, кроме зоны .ru — но torrents.ru он всё-таки обрабатывает: ! вычёркивает его из исключающего списка. Подробно — hostlist.

UDP Discord по адресам и портам

Профиль из стандартного пресета Zapret GUI «complex multidisorder»:

--name=Discord · UDP (обычно не нужно)
--filter-udp=443-65535
--ipset=lists/ipset-discord.txt
--out-range=-n4
--payload=all
--lua-desync=fake:blob=quic_google:repeats=12:ip_autottl=2,3-20:ip6_autottl=2,3-20:payload=all

В UDP-трафике голоса и видео нет приветствия TLS с именем сайта, поэтому профиль отбирает его по портам и адресам серверов Discord, а --out-range=-n4 ограничивает стратегию первыми четырьмя пакетами.

Как это выглядит в Zapret GUI

В программе условия профиля видны на его странице: строка с портами, списком и диапазонами пакетов в шапке и вкладка со списком сайтов или адресов. На вкладке «Текст профиля» видны сами строки фильтров так, как они записаны в пресете; кнопка «Что это?» рядом с «Сохранить текст профиля» объясняет, что значит каждая часть и что важнее чего, и открывает статьи вики. Порядок профилей меняется на странице «Профили пресета».

Источники

📚 См. также

  • hostlist — списки сайтов: поиск домена, ^ и !, исключения из исключений
  • ipset — списки адресов и подсетей
  • Исключения — профиль pass и исключающие списки: два способа пустить трафик мимо обхода
  • Профиль — блок, к которому относятся фильтры
  • Пресет — файл со всеми профилями
  • nftables — грубое сито до профилей
  • Тип payload — распознаваемые протоколы и разница «соединение или пакет»
  • out-range — отбор по номеру пакета
  • Механизм —lua-desync — действия, которые адресуют фильтры
  • Схема обработки трафика — где выбор профиля стоит в конвейере

🤖 Эти статьи открыты — можно обучать на них ИИ

При желании вы можете натренировать ИИ на наших статьях. Исходное форматирование доступно в Forgejo: исходник этой заметки · скачать весь репозиторий одним zip-архивом.