🗂 Пресет в Zapret 2: что внутри файла и как с ним работает программа

О чём заметка

Что такое пресет (его ещё называют конфигом) в Zapret 2 и программе Zapret GUI: из каких частей состоит файл, как его текст попадает в движок winws2, где лежат встроенные и ваши пресеты, что происходит с правкой встроенного пресета после обновления программы, как обмениваться пресетами и как тот же пресет выглядит в .bat-файле. Чем пресет отличается от профиля и как настраивать профили — в заметке о профиле.

TL;DR

  • Пресет — один .txt-файл с настройками движка: общая шапка (библиотеки Lua, перехват, заготовки фейков) и профили — по одному на сайт или вид трафика. Во встроенном пресете Default v1 543 строки из 620 — это профили.
  • Что написано, то и работает. При запуске программа передаёт текст пресета движку как файл параметров, без комментариев, и ничего скрытого не добавляет.
  • Где лежат: в папке программы, presets\winws2 — ваши пресеты, presets\winws2_builtin — встроенные (для режима Zapret 1 — winws1 и winws1_builtin).
  • Правка встроенного пресета сохраняется копией. Когда выходит новая версия этого встроенного пресета (растёт # BuiltinVersion:), копия заменяется ею, а прежняя сохраняется в presets\replaced.
  • Если не открывается один сайт, перебирать пресеты не нужно: возьмите пресет, где работает больше всего, и смените стратегию в профиле этого сайта.

Структура пресета

Пресет — обычный текстовый файл в кодировке UTF-8. Каждая строка — одна опция движка (--имя=значение), строки с # — комментарии. Формат тот же, что у командной строки winws2.exe, поэтому пресет можно читать как список флагов. Диаграмма в начале заметки показывает, из чего состоит реальный встроенный пресет Default v1 (game filter) версии 2.49: из 620 строк с опциями 77 приходятся на общую шапку, остальные 543 — на 77 профилей.

1. Служебная шапка для программы

# Preset: Default v1 (game filter)
# BuiltinVersion: 2.49
# IconColor: #a8c5ff

Это комментарии: движок их не читает, они нужны программе. # Preset: — имя пресета в списке, # BuiltinVersion: — номер версии встроенного пресета (о нём ниже), # IconColor: — цвет значка. У импортированного пресета есть ещё # PresetKind: imported. Старые строки # ActivePreset: и # Modified: из пресетов прошлых версий программа при сохранении убирает.

2. Общие настройки движка

--lua-init=@lua/zapret-lib.lua
--lua-init=@lua/zapret-antidpi.lua
--lua-init=@lua/zapret-auto.lua
--lua-init=@lua/custom_funcs.lua
--lua-init=@lua/custom_diag.lua
--lua-init=@lua/zapret-multishake.lua
--lua-init=@lua/fakemultisplit.lua
--lua-init=@lua/fakemultidisorder.lua
 
--ctrack-disable=0
--ipcache-hostname=0
 
--wf-tcp-out=80,443,1080,2053,2083,2087,2096,5050,8443,8080,45631
--wf-udp-out=443-65535
--wf-raw-part=@windivert.filter/windivert_part.discord_media.txt
  • --lua-init загружает библиотеки, в которых написаны функции обхода. В пресетах Zapret 2 GUI блок из этих восьми строк обязателен: без него строки --lua-desync вызывать нечего. Если строк не хватает, программа восстанавливает блок при сохранении — это одно из немногих изменений текста, которые она делает сама.
  • --wf-… — фильтр перехвата WinDivert: какие пакеты Windows вообще передаст движку. Соединение, которое сюда не попало, не увидит ни один профиль.
  • --ctrack-disable и --ipcache-hostname — общие настройки отслеживания соединений и запоминания имени сайта по адресу.

3. Заготовки фейков: --blob

--blob=tls_google:@bin/tls_clienthello_www_google_com.bin
--blob=quic_google:@bin/quic_initial_www_google_com.bin

--blob объявляет именованную заготовку пакета, на которую стратегии ссылаются через blob=имя. В Default v1 таких строк 62. Когда вы выбираете готовую стратегию с новым фейком, программа сама дописывает его объявление в шапку — и вы увидите эту строку в тексте пресета. Подробнее — blob.

4. Профили

Всё, что ниже шапки, — профили, разделённые строкой --new. Каждый профиль отвечает за свою часть трафика: условия (порты, списки сайтов или адресов) решают, какие соединения ему достаются, а строки --lua-desync — что с ними делать.

--name=GitHub · файлы и картинки
--filter-tcp=443
--hostlist=lists/githubusercontent.txt
--out-range=-d8
--lua-desync=send:repeats=2
--lua-desync=syndata:blob=stun_pat
--lua-desync=tls_multisplit_sni:seqovl=652:seqovl_pattern=stun_pat
 
--new

Профили проверяются сверху вниз, и соединение достаётся первому подходящему, поэтому порядок профилей в пресете важен. Выключенный в программе профиль остаётся в файле со строкой --skip — движок его пропускает. Как читать профиль строка за строкой — профиль, как выбирается профиль — фильтры профиля, что значит -d8 — out-range.

Как пресет попадает в движок

Программа не держит настроек «где-то ещё»: работает ровно то, что записано в тексте пресета. При запуске она берёт текст выбранного пресета, убирает комментарии и пустые строки, делит строки на отдельные параметры и записывает их во временный файл параметров. Движок winws2.exe получает этот файл через @файл — так в руководстве движка называется чтение опций командной строки из файла (руководство nfqws2).

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

Проще говоря: пресет — это и есть настройки. Если в тексте пресета чего-то нет, движок этого не получит.

Где лежат пресеты

Все пресеты хранятся в папке, куда установлена программа (например, C:\Zapret\Dev у Dev-версии), в подпапке presets:

ПапкаЧто в ней
presets\winws2_builtinвстроенные пресеты режима Zapret 2 (136 на ноябрь 2026 года); приходят с программой и обновляются вместе с ней
presets\winws2ваши пресеты и копии правок встроенных
presets\winws1_builtin, presets\winws1то же для режима Zapret 1 (171 встроенный пресет)
presets\replacedпоследняя копия, заменённая при обновлении встроенного пресета

Кнопка «Папка пресетов» на странице «Мои пресеты» открывает папку ваших пресетов.

Правка встроенного пресета и его обновление

Встроенные пресеты правят вместе с программой: обновляют стратегии под новые блокировки, добавляют профили. Чтобы эти исправления доходили до всех, у каждого встроенного пресета есть номер # BuiltinVersion:.

Правка встроенного пресета живёт копией — до первого обновления этого пресета Встроенный пресет лежит в presets\winws2_builtin. Правка сохраняется копией в presets\winws2, и дальше работает копия. Если после обновления программы номер BuiltinVersion у встроенного пресета стал больше, копия заменяется новой версией, а прежняя копия сохраняется в presets\replaced. presets\winws2_builtinприходит с программой presets\winws2ваши пресеты и копии правок presets\replacedпоследняя заменённая копия Default v1 · 2.49 1. Встроенный пресет версии 2.49 2.49 + ваша правка 2. Вы меняете стратегию — программа сохраняет копию, дальше работает она Default v1 · 2.50 3. Обновление программы: встроенный пресет стал версии 2.50 2.49 + ваша правка 4. Старая копия уходит в replaced Default v1 · 2.50 5. Копию заменяет новая версия; вы получаете уведомление Номер растёт только у правок, которые должны дойти до всех (стратегии, списки, профили). Переименованиепрофиля номер не меняет. Пресеты с другими именами файлов и пресеты по ссылке программа не трогает.

Как это работает:

  1. Вы меняете встроенный пресет — например, выбираете другую стратегию в профиле. Программа сохраняет вашу копию в presets\winws2 под тем же именем, и дальше работает копия.
  2. Выходит обновление программы, и номер # BuiltinVersion: у этого встроенного пресета становится больше, чем в вашей копии.
  3. После запуска программа в фоне заменяет копию новой версией. Прежняя копия сохраняется в presets\replaced\winws2\ (хранится одна, последняя), а вы получаете уведомление «Встроенные пресеты обновлены».

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

Чтобы правки точно сохранились

Сделайте свой пресет: «Дублировать» встроенный пресет и работайте в дубле. У дубля другое имя файла, и обновления встроенных пресетов его не заменяют. Если правка уже заменилась, её прежний вариант лежит в presets\replaced\winws2\.

Обмен пресетами

На странице «Мои пресеты» пресет можно экспортировать в .zip — архив кладёт рядом с пресетом и его файлы списков из папки lists, чтобы у получателя всё заработало сразу. При импорте программа добавляет в шапку # PresetKind: imported; если у вас уже есть список с тем же именем, но другим содержимым, список из архива сохраняется под новым именем, и ссылка в пресете меняется на него — это видно в тексте пресета. Готовые пресеты других пользователей можно найти через кнопку «Получить конфиги» на той же странице: она открывает раздел обмена пресетами и профилями на Forgejo.

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

Как пользоваться пресетами

Пресет — это набор стратегий, подобранных кем-то под своего провайдера. У вас блокировки могут быть устроены иначе, поэтому типичная картина такая: на одном пресете открывается YouTube, но не открывается Discord, на другом — наоборот. Перебирать пресеты целиком в поисках идеального — долго и часто бесполезно.

Работает другой порядок. Возьмите пресет, на котором открывается больше всего нужного, как основу. Найдите профиль, в который попадает неработающий сайт, и смените стратегию только в нём — на странице «Профили пресета». Подробно — профиль, как проверить стратегию — verify-strategy.

Кнопка «Что это такое?» на странице «Мои пресеты» коротко объясняет то же самое прямо в программе.

Тот же пресет в виде .bat-файла

Пресет — это те же самые флаги winws2.exe, только записанные в текстовый файл по одному на строку. Поэтому любой пресет можно превратить в обычный .bat-файл и запускать winws2.exe напрямую, без GUI, и наоборот: готовую командную строку из .bat можно разложить по строкам в текстовый файл и передать winws2.exe через @файл. Чтобы такой файл подхватил GUI, ему обычно нужны ещё служебные строки-комментарии в начале (# Preset: …, см. «Заголовок и метаданные»). Меняется только обвязка, логика профилей остаётся прежней.

В .bat появляется несколько элементов, которых нет в .txt-пресете:

  • start "zapret: http,https,quic" /min запускает winws2.exe в отдельном свёрнутом окне с заголовком из кавычек;
  • %~dp0 — папка, в которой лежит сам .bat. Через неё записываются пути к Lua-скриптам, блобам и спискам, чтобы файл работал из любого места;
  • ^ в конце строки переносит команду на следующую строку. Вся команда для Windows остаётся одной строкой, перенос нужен только для читаемости;
  • @ перед путём в --lua-init=@"…" и --blob=имя:@"…" означает «прочитать содержимое из файла», а не использовать строку как есть.

Ниже пример такого запуска с шестью профилями, разделёнными --new. Сначала идёт общая часть: —wf-tcp-out и —wf-raw-part решают, какой трафик WinDivert вообще передаст в программу, --lua-init подключает библиотеки стратегий и перенастраивает блоб fake_default_tls (tls_mod со случайными данными и случайным SNI), --blob загружает QUIC-фейк из файла. Затем каждый профиль выбирает свой трафик фильтрами --filter-tcp/--filter-udp/--filter-l7 и хостлистом, ограничивает момент срабатывания через —payload и —out-range и задаёт технику через —lua-desync.

start "zapret: http,https,quic" /min "%~dp0winws2.exe" ^
--wf-tcp-out=80,443 ^
--lua-init=@"%~dp0lua\zapret-lib.lua" --lua-init=@"%~dp0lua\zapret-antidpi.lua" ^
--lua-init="fake_default_tls = tls_mod(fake_default_tls,'rnd,rndsni')" ^
--blob=quic_google:@"%~dp0files\quic_initial_www_google_com.bin" ^
--wf-raw-part=@"%~dp0windivert.filter\windivert_part.discord_media.txt" ^
--wf-raw-part=@"%~dp0windivert.filter\windivert_part.stun.txt" ^
--wf-raw-part=@"%~dp0windivert.filter\windivert_part.wireguard.txt" ^
--wf-raw-part=@"%~dp0windivert.filter\windivert_part.quic_initial_ietf.txt" ^
--filter-tcp=80 --filter-l7=http ^
  --out-range=-d10 ^
  --payload=http_req ^
   --lua-desync=fake:blob=fake_default_http:ip_autottl=-2,3-20:ip6_autottl=-2,3-20:tcp_md5 ^
   --lua-desync=fakedsplit:ip_autottl=-2,3-20:ip6_autottl=-2,3-20:tcp_md5 ^
  --new ^
--filter-tcp=443 --filter-l7=tls --hostlist="%~dp0files\list-youtube.txt" ^
  --out-range=-d10 ^
  --payload=tls_client_hello ^
   --lua-desync=fake:blob=fake_default_tls:tcp_md5:repeats=11:tls_mod=rnd,dupsid,sni=www.google.com ^
   --lua-desync=multidisorder:pos=1,midsld ^
  --new ^
--filter-tcp=443 --filter-l7=tls ^
  --out-range=-d10 ^
  --payload=tls_client_hello ^
   --lua-desync=fake:blob=fake_default_tls:tcp_md5:tcp_seq=-10000:repeats=6 ^
   --lua-desync=multidisorder:pos=midsld ^
  --new ^
--filter-udp=443 --filter-l7=quic --hostlist="%~dp0files\list-youtube.txt" ^
  --out-range=-d10 ^
  --payload=quic_initial ^
   --lua-desync=fake:blob=quic_google:repeats=11 ^
  --new ^
--filter-udp=443 --filter-l7=quic ^
  --out-range=-d10 ^
  --payload=quic_initial ^
   --lua-desync=fake:blob=fake_default_quic:repeats=11 ^
  --new ^
--filter-l7=wireguard,stun,discord ^
  --out-range=-d10 ^
  --payload=wireguard_initiation,wireguard_cookie,stun,discord_ip_discovery ^
   --lua-desync=fake:blob=0x00000000000000000000000000000000:repeats=2

Что делает каждый профиль, по порядку:

  1. HTTP на порту 80. Перед запросом отправляется фейковый HTTP-запрос (fake), затем настоящий режется с подмешиванием фейков (fakedsplit). Фейки «умирают» до сервера за счёт ip_autottl=-2 (TTL на два хопа меньше пути) и tcp_md5, см. основные флаги.
  2. TLS для YouTube по хостлисту. 11 фейковых ClientHello с подменённым SNI www.google.com, затем настоящий ClientHello режется на три части и отправляется в обратном порядке (multidisorder).
  3. TLS для всего остального. Шесть фейков с tcp_md5 и сдвинутым номером последовательности и разрез по середине домена второго уровня. Профиль стоит после YouTube, поэтому ловит всё, что не попало в хостлист: выигрывает первый подходящий профиль, см. profile-independence.
  4. QUIC для YouTube. 11 фейковых QUIC Initial из заранее записанного пакета к www.google.com.
  5. QUIC для остальных сайтов. То же со встроенным блобом fake_default_quic.
  6. WireGuard, STUN и Discord. Два пакета из нулей перед каждым пакетом этих типов в пределах первых десяти пакетов с данными (--out-range=-d10). Порты не указаны, потому что такой трафик распознаётся по содержимому, а до программы его доводят --wf-raw-part-фильтры из общей части.

Устаревшее имя payload в старых копиях примера

В ранних копиях этого примера в последнем профиле стояло --payload=…,stun_binding_req,…. Такой тип был в первых версиях nfqws2, но в v0.4 его убрали и заменили общим stun (запись «remove stun_binding_req, replace to stun» в docs/changes.txt репозитория zapret2). Текущие версии на неизвестное имя в --payload отвечают Invalid payload filter и завершаются сразу при запуске, поэтому в примере выше уже стоит stun. Список допустимых типов — в payload.

Источники

📚 См. также


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

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