🧯 Фильтры профиля в 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— это грубое сито ради экономии. И только потом фильтры профиля из этой заметки выбирают, какой профиль и какая стратегия обработают уже захваченное соединение. Пакет, не прошедший фильтр захвата, до профилей не дойдёт.
Как выбирается профиль
Выбор делает функция dp_match в исходнике nfq2/desync.c. Порядок такой:
- Соединение проверяется по профилям сверху вниз, от первого к последнему.
- Первый профиль, у которого прошли все проверки, забирает соединение, и поиск прекращается. Профили ниже его уже не видят.
- Если не подошёл ни один, соединение достаётся скрытому профилю
no_action(служебный номер 0). Движок сам добавляет его последним при запуске; действий в нём нет, поэтому с соединением ничего не происходит. Подробнее — в заметке об исключениях.
Отсюда главное правило составления пресета: узкие профили ставьте выше широких. Профиль «YouTube» должен стоять над профилем «все сайты», иначе широкий профиль заберёт и YouTube.
Выбор запоминается, но может пересматриваться
Чтобы не искать профиль заново на каждый пакет, движок запоминает выбор в записи о соединении (conntrack — таблица, где движок хранит состояние каждого открытого соединения). Пересмотр возможен не больше двух раз за соединение: когда движок распознал протокол (например, понял, что это TLS) и когда узнал имя сайта. Именно поэтому профиль со списком сайтов может забрать соединение не с первого пакета, а позже.
Порядок проверок внутри профиля
Диаграмма в начале заметки показывает шесть проверок, через которые проходит соединение в одном профиле. Условия, которых в профиле нет, считаются пройденными: профиль без списков подходит любому сайту и адресу на своих портах.
- Порты и протокол —
--filter-tcp,--filter-udp,--filter-l7и остальные фильтры по заголовкам пакета (справочник ниже). - Исключения по адресам —
--ipset-exclude,--ipset-exclude-ip. Адрес нашёлся хотя бы в одном — профиль не подходит. - Включения по адресам —
--ipset,--ipset-ip. Хватит совпадения в любом списке. - Имя сайта уже известно? Если у профиля есть списки сайтов, а имени у движка ещё нет, профиль сейчас не подходит. Он вернётся в выбор, когда имя появится.
- Исключения по сайтам —
--hostlist-exclude,--hostlist-exclude-domains. - Включения по сайтам —
--hostlist,--hostlist-domains. Хватит совпадения в любом списке.
Не прошла хотя бы одна проверка — профиль не подходит, и соединение проверяет следующий профиль.
Проще говоря: внутри профиля всё должно совпасть, исключения проверяются раньше включений и побеждают их, а сайты проверяются только тогда, когда движок узнал имя.
Адрес известен сразу, имя сайта — позже
Адрес сервера есть в самом первом пакете соединения. Имя сайта движок берёт из приветствия TLS (ClientHello — первое сообщение браузера в HTTPS-соединении, где открытым текстом написано имя сайта), из заголовка Host в HTTP или из приветствия QUIC. В обычном HTTPS-соединении это четвёртый пакет, после трёх пакетов установки соединения.
Пример. В пресете два профиля: «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 | тип и код ICMP | type[: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_tlsYouTube обрабатывает первый профиль, но только с приветствия 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
В программе условия профиля видны на его странице: строка с портами, списком и диапазонами пакетов в шапке и вкладка со списком сайтов или адресов. На вкладке «Текст профиля» видны сами строки фильтров так, как они записаны в пресете; кнопка «Что это?» рядом с «Сохранить текст профиля» объясняет, что значит каждая часть и что важнее чего, и открывает статьи вики. Порядок профилей меняется на странице «Профили пресета».
Источники
- Руководство nfqws2, docs/manual.md — профили, фильтры и списки
- Исходник nfq2/desync.c — выбор профиля (dp_match)
📚 См. также
- hostlist — списки сайтов: поиск домена,
^и!, исключения из исключений - ipset — списки адресов и подсетей
- Исключения — профиль
passи исключающие списки: два способа пустить трафик мимо обхода - Профиль — блок, к которому относятся фильтры
- Пресет — файл со всеми профилями
- nftables — грубое сито до профилей
- Тип payload — распознаваемые протоколы и разница «соединение или пакет»
- out-range — отбор по номеру пакета
- Механизм —lua-desync — действия, которые адресуют фильтры
- Схема обработки трафика — где выбор профиля стоит в конвейере
🤖 Эти статьи открыты — можно обучать на них ИИ
При желании вы можете натренировать ИИ на наших статьях. Исходное форматирование доступно в Forgejo: исходник этой заметки · скачать весь репозиторий одним zip-архивом.