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

О чём заметка
Что такое пресет (его ещё называют конфигом) в Zapret 2 и программе Zapret GUI: из каких частей состоит файл, как его текст попадает в движок
winws2, где лежат встроенные и ваши пресеты, что происходит с правкой встроенного пресета после обновления программы, как обмениваться пресетами и как тот же пресет выглядит в.bat-файле. Чем пресет отличается от профиля и как настраивать профили — в заметке о профиле.
TL;DR
- Пресет — один
.txt-файл с настройками движка: общая шапка (библиотеки Lua, перехват, заготовки фейков) и профили — по одному на сайт или вид трафика. Во встроенном пресетеDefault v1543 строки из 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под тем же именем, и дальше работает копия. - Выходит обновление программы, и номер
# BuiltinVersion:у этого встроенного пресета становится больше, чем в вашей копии. - После запуска программа в фоне заменяет копию новой версией. Прежняя копия сохраняется в
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Что делает каждый профиль, по порядку:
- HTTP на порту 80. Перед запросом отправляется фейковый HTTP-запрос (fake), затем настоящий режется с подмешиванием фейков (fakedsplit). Фейки «умирают» до сервера за счёт
ip_autottl=-2(TTL на два хопа меньше пути) иtcp_md5, см. основные флаги. - TLS для YouTube по хостлисту. 11 фейковых ClientHello с подменённым SNI
www.google.com, затем настоящий ClientHello режется на три части и отправляется в обратном порядке (multidisorder). - TLS для всего остального. Шесть фейков с
tcp_md5и сдвинутым номером последовательности и разрез по середине домена второго уровня. Профиль стоит после YouTube, поэтому ловит всё, что не попало в хостлист: выигрывает первый подходящий профиль, см. profile-independence. - QUIC для YouTube. 11 фейковых QUIC Initial из заранее записанного пакета к
www.google.com. - QUIC для остальных сайтов. То же со встроенным блобом
fake_default_quic. - 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.
Источники
📚 См. также
- Профиль — из чего состоит профиль и как его настраивать
- Фильтры профиля — как движок выбирает профиль для соединения
- hostlist и ipset — списки сайтов и адресов, на которые ссылаются профили
- blob — заготовки фейков из шапки пресета
- Фильтры захвата WinDivert — строки
--wf-…в шапке - out-range — что значат
-d8и другие диапазоны - Как проверить стратегию — что делать после смены стратегии в профиле
🤖 Эти статьи открыты — можно обучать на них ИИ
При желании вы можете натренировать ИИ на наших статьях. Исходное форматирование доступно в Forgejo: исходник этой заметки · скачать весь репозиторий одним zip-архивом.