🧩 Тип payload и распознавание протоколов

О чём заметка

Что такое «тип payload» в Zapret 2, чем он отличается от протокола потока, как nfqws2 распознаёт протоколы по сигнатурам, какие типы бывают и как работает фильтр --payload. Также — как объявить свой детектор протокола на Lua. Фильтр --payload — одно из полей профиля рядом с --filter-*; где поля l7payload/l7proto лежат в данных пакета — см. структура desync и диссекта.

TL;DR

  • Тип payload (l7payload) — это распознанное содержимое одного пакета: tls_client_hello, http_req, quic_initial и т. д. Пустой пакет — empty, нераспознанный — unknown.
  • Протокол потока (l7proto) — ярлык на всё соединение; ставится по первому известному пейлоаду и держится до конца, даже если дальше идут unknown-пакеты.
  • Фильтр --payload ограничивает, к каким пакетам применится последующий --lua-desync. Сам он по умолчанию all — пропускает любые пакеты. Но большинство функций обхода проверяют тип ещё раз своим аргументом payload=, и там по умолчанию known (всё, кроме empty и unknown). Поэтому без явного фильтра fake или multisplit работают только на распознанных пакетах.
  • Спецзначения фильтра: all — любой пейлоад, known — не empty и не unknown. Префикс ~ — инверсия.
  • Распознавание сигнатурное и живёт в C-ядре. Свой тип можно назначить Lua-детектором (detect_payload_str), но такой тип не виден C-фильтру --payload — только payload-фильтрам самих desync-функций.

Что такое тип payload (и чем он отличается от протокола потока)

Это два разных понятия, и их постоянно путают.

Тип payload (в данных пакета — поле desync.l7payload) — это распознанный тип содержимого одного конкретного пакета. Например, в TLS-соединении первый пакет от клиента имеет тип tls_client_hello, ответ сервера — tls_server_hello, а дальше идут уже зашифрованные пакеты, которые распознать нельзя, — их тип unknown.

Протокол потока (поле desync.l7proto, а в фильтрах профиля — --filter-l7) — это ярлык на всё соединение целиком. Он присваивается, как только в потоке встретился первый известный пейлоад, и остаётся с потоком до конца его существования — даже если последующие пакеты имеют тип unknown.

Проще говоря

Протокол потока — как табличка на двери всего «разговора»: повесили один раз («это TLS») и не меняем. Тип payload — как ярлык на каждой отдельной реплике внутри разговора: у первой реплики tls_client_hello, у следующих может быть unknown. Одно соединение (tls) → много пакетов с разными типами payload.

Тип пакета меняется, протокол соединения — нет Пакеты одного TLS-соединения: SYN и пустые ACK имеют тип empty, приветствие браузера — tls_client_hello, ответ сервера — tls_server_hello, зашифрованные данные — unknown. Протокол соединения tls ставится на первом распознанном пакете и не меняется. С --payload=tls_client_hello стратегия получает только приветствие браузера. пакеты одного соединения с сайтом тип пакета (l7payload) протокол (l7proto) → SYN empty unknown → ClientHello tls_client_hello tls ← ServerHello tls_server_hello tls → данные unknown tls ← данные unknown tls → ACK empty tls --payload=tls_client_hello: стратегия получает только выделенный пакет Протокол tls держится на всём соединении, поэтому --filter-l7=tls выбирает профиль для всех его пакетов, а--payload внутри профиля отбирает из них нужные.

Два особых типа payload есть всегда:

  • empty — пакет без прикладных данных (например, «пустой» ACK).
  • unknown — данные есть, но их тип не распознан (зашифрованная середина соединения, неизвестный протокол).

Полное описание, где именно поля l7payload и l7proto лежат в таблице пакета, — в структура desync и диссекта.


Как nfqws2 распознаёт протоколы

Распознавание сигнатурное: C-ядро nfqws2 смотрит на характерные байты в начале пейлоада (или группы пакетов) и по ним определяет тип. Это происходит на быстрой стороне C-кода ещё до вызова Lua (см. схема обработки трафика).

В фильтрах по типу payload и по протоколу потока доступны два спецзначения:

  • all — совпадает с любым пейлоадом (в том числе empty и unknown);
  • known — совпадает со всем, что не empty и не unknown (то есть только с реально распознанными типами).

Таблица распознаваемых типов

Ниже — какие протоколы потока nfqws2 умеет распознавать, на каком транспорте (L4) они работают и какие типы payload внутри них бывают.

Протокол потокаL4Типы payload внутри
httpTCPhttp_req, http_reply
tlsTCPtls_client_hello, tls_server_hello
xmppTCPxmpp_stream, xmpp_starttls, xmpp_proceed, xmpp_features
mtprotoTCPmtproto_initial
btTCPbt_handshake
quicUDPquic_initial
wireguardUDPwireguard_initiation, wireguard_response, wireguard_cookie, wireguard_keepalive
dhtUDPdht
utp_btUDPutp_bt_handshake
discordUDPdiscord_ip_discovery
stunUDPstun
dnsUDPdns_query, dns_response
dtlsUDPdtls_client_hello, dtls_server_hello
(любой)ICMPipv4, ipv6, icmp

Особые типы ipv4 / ipv6 / icmp

Это типы payload для ICMP-пакетов. ipv4 и ipv6 генерируются, когда ICMP несёт прикреплённый исходный пакет (например, ICMP «destination unreachable» с куском исходного соединения). Во всех остальных случаях ICMP получает тип payload icmp. Подробнее про обработку ICMP — структура desync и диссекта.


Фильтр --payload

--payload — поле профиля, которое ограничивает, к каким пакетам применятся последующие --lua-desync-инстансы. Пока --payload не переопределён, он действует на все идущие за ним инстансы (как и другие внутрипрофильные фильтры, см. схема обработки трафика).

Синтаксис

# Один тип
--payload=tls_client_hello
 
# Несколько типов через запятую
--payload=http_req,http_reply
 
# Все известные типы (не empty и не unknown)
--payload=known
 
# Вообще все пакеты, включая empty и unknown — это значение по умолчанию
--payload=all
 
# Инверсия: всё, КРОМЕ указанного
--payload=~empty

Значение по умолчанию: два фильтра, два умолчания

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

  1. --payload профиля — быстрый фильтр в C-коде движка. По умолчанию all: функции достаются любые пакеты. Так прямо сказано в руководстве движка: «по умолчанию стоит … пропуск любых пейлоадов (--payload=all)», это повторяет поведение старого nfqws1 с --dpi-desync-any-protocol.
  2. Аргумент payload= самой функции — проверка уже внутри Lua. Если аргумент не задан, большинство функций обхода берут known. Вот код этой проверки (lua/zapret-lib.lua):
function payload_match_filter(l7payload, l7payload_filter, def)
	local argpl = l7payload_filter or def or "known"
	local neg = string.sub(argpl,1,1)=="~"
	local pl = neg and string.sub(argpl,2) or argpl
	return neg ~= (in_list(pl, "all") or in_list(pl, l7payload) or in_list(pl, "known") and l7payload~="unknown" and l7payload~="empty")
end

Итог для типичной строки без фильтров: C-код пропускает всё, а функция вроде fake или multisplit сама отбросит пустые и нераспознанные пакеты. Автор движка называет такие внутренние проверки «предохранителем и защитой от дурака»: чтобы нельзя было случайно устроить поток фейков на каждый пакет скачивания. Но процессор при этом тратится — каждый пакет всё равно доходит до Lua. Поэтому в пресетах нужный тип задают на уровне профиля:

По подсчёту по 136 встроенным пресетам winws2 программы Zapret GUI (1 ноября 2026 года) значение all встречается 2682 раза — его ставят функциям, которым важны и пустые пакеты, и для UDP-игр. Из конкретных типов чаще всего фильтруют приветствие TLS (tls_client_hello, 1330 раз) и связку tls_client_hello,http_req (1052 раза).

Инверсия через ~ означает «всё, кроме»: --payload=~empty — любой непустой пакет, --payload=~unknown — всё, кроме нераспознанного.

--payload (C-уровень) vs payload-фильтр инстанса (Lua)

--payload на уровне профиля обрабатывается быстрым C-кодом. У многих desync-функций есть свой аргумент payload= — это дополнительный фильтр уже на стороне Lua. Практика: держите основной фильтр на --payload профиля (быстрее), а payload= инстанса используйте для тонкой донастройки. Разница станет важной ниже, в разделе про кастомные детекторы.


Свой детектор протокола на Lua (detect_payload_str)

Иногда нужного протокола нет в списке распознаваемых, но у его пакетов есть характерная подстрока. Тогда тип payload можно назначить самому — простейшим Lua-детектором. В комплекте есть пример-функция detect_payload_str:

function detect_payload_str(ctx, desync)
    -- arg: pattern    — подстрока для поиска в desync.dis.payload
    -- arg: payload    — какое значение присвоить desync.l7payload, если подстрока найдена
    -- arg: undetected — какое значение присвоить, если подстрока НЕ найдена (необязательно)
end

Логика простая: функция ищет подстроку pattern в пейлоаде текущего пакета (desync.dis.payload); если находит — присваивает desync.l7payload = desync.arg.payload; иначе, если задан undetected, присваивает desync.l7payload = desync.arg.undetected.

Кастомный тип не виден C-коду и фильтру --payload

Такие Lua-детекторы не имеют силы для C-кода: ядро ничего не знает о вашем протоколе и вашем типе payload. Поэтому ваше значение нельзя указать в --payload (это C-уровневый фильтр). Но его можно использовать в payload-фильтрах (payload=) многих desync-функций — они работают уже на стороне Lua, после того как ваш детектор отработал. Схема такая: сначала инстанс detect_payload_str проставляет l7payload, а следующий инстанс с payload=ваш_тип на него реагирует.


Практика: MTProto (Telegram)

Хороший пример, где важна разница «пакет vs поток». В соединении MTProto распознаётся только первый пакет:

Пакетl7payloadПройдёт фильтр known?
Первый пакет с даннымиmtproto_initial✅ Да
Последующие пакетыunknown❌ Нет

Нужно ли добавлять payload=unknown? Обычно нет. Для обхода блокировки Telegram, как правило, достаточно обработать только mtproto_initial, потому что:

  1. DPI анализирует только начало соединения (сигнатуру MTProto);
  2. после initial данные зашифрованы — DPI их не парсит;
  3. если initial прошёл — соединение установлено.
# Рекомендуемый вариант — обрабатываем только initial
nfqws2 --filter-l7=mtproto \
  --payload=mtproto_initial \
  --lua-desync=fake:blob=0x00000000:repeats=3

Если же нужны все пакеты MTProto (initial + последующие), укажите unknown явно или используйте all:

# Явно добавить unknown-пакеты отдельным фильтром
nfqws2 --filter-l7=mtproto \
  --payload=mtproto_initial --lua-desync=fake:blob=... \
  --payload=unknown --lua-desync=send:ip_ttl=3
 
# Или разом все пакеты
nfqws2 --filter-l7=mtproto \
  --payload=all \
  --lua-desync=fake:blob=...

Детальный разбор распознавания Telegram — в распознавание mtproto.


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

В программе --payload виден на вкладке «Текст профиля» — строкой перед --lua-desync. Во встроенных профилях программы он уже задан как часть условий профиля: у профилей сайтов по HTTPS обычно --payload=tls_client_hello, у игр по UDP — список игровых типов; при выборе готовой стратегии он сохраняется. Кнопка «Что это?» рядом с «Сохранить текст профиля» объясняет, что значат строки профиля, и открывает статьи вики, в том числе эту.

Источники

📚 См. также


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

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