todo/Zapret2/preset.md
loop-uh 2e14d0eb8c
Some checks failed
Published content check / validate (push) Failing after 14s
preset: статья переписана под текущую программу — устройство файла, запуск, папки, обновление встроенных пресетов, обмен
Старая версия описывала январский формат (# ActivePreset, # Modified,
файл %AppData%\ZapretTwoDev\preset-zapret2.txt, пресет Gaming) и на
600 строк состояла из трёх устаревших пресетов целиком. Теперь: шапка
# Preset / # BuiltinVersion / # IconColor, обязательный блок --lua-init,
--blob, профили; запуск через @файл и проверку --dry-run; папки
presets\winws2, winws2_builtin, replaced; замена копии правки при росте
BuiltinVersion (анимация); экспорт .zip со списками и импорт; совет
настраивать профиль. Раздел про .bat сохранён. Диаграмма: из чего
состоит Default v1. Факты сверены с presets/preset_contract.py и
папками на win10.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-01 21:40:34 -05:00

244 lines
25 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

---
date: 2026-11-01
tags:
- zapret
- zapret2
- gui
- preset
- profile
aliases:
- пресет
- конфиги
- Что такое пресет Zapret 2
- Где лежат пресеты Zapret
- Почему пропали мои правки в пресете
- BuiltinVersion
- presets replaced
- Как обменяться пресетом
description: "Пресет в Zapret 2: из чего состоит файл, как он попадает в движок, где лежат встроенные и свои пресеты, почему правка встроенного пресета может замениться — с примерами."
image: Zapret2/attachments/preset-anatomy.png
link: https://github.com/bol-van/zapret2/blob/master/docs/manual.md
---
> [!mirror] Резервное зеркало
> Актуальная версия этой страницы — на основной вики: [jzesawgjsz.zapret.moe/Zapret2/preset](https://otukcszfwr.zapret.moe/Zapret2/preset)
# 🗂 Пресет в Zapret 2: что внутри файла и как с ним работает программа
![[preset-anatomy.png]]
> [!info] О чём заметка
> Что такое пресет (его ещё называют конфигом) в [[Zapret2/Zapret2|Zapret 2]] и программе Zapret GUI: из каких частей состоит файл, как его текст попадает в движок `winws2`, где лежат встроенные и ваши пресеты, что происходит с правкой встроенного пресета после обновления программы, как обмениваться пресетами и как тот же пресет выглядит в `.bat`-файле. Чем пресет отличается от профиля и как настраивать профили — в [[Zapret2/profile|заметке о профиле]].
## 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. Служебная шапка для программы
```text
# Preset: Default v1 (game filter)
# BuiltinVersion: 2.49
# IconColor: #a8c5ff
```
Это комментарии: движок их не читает, они нужны программе. `# Preset:` — имя пресета в списке, `# BuiltinVersion:` — номер версии встроенного пресета (о нём ниже), `# IconColor:` — цвет значка. У импортированного пресета есть ещё `# PresetKind: imported`. Старые строки `# ActivePreset:` и `# Modified:` из пресетов прошлых версий программа при сохранении убирает.
### 2. Общие настройки движка
```text
--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-…`** — фильтр [[wf|перехвата WinDivert]]: какие пакеты Windows вообще передаст движку. Соединение, которое сюда не попало, не увидит ни один профиль.
- **`--ctrack-disable`** и **`--ipcache-hostname`** — общие настройки отслеживания соединений и запоминания имени сайта по адресу.
### 3. Заготовки фейков: `--blob`
```text
--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` — что с ними делать.
```text
--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` — движок его пропускает. Как читать профиль строка за строкой — [[Zapret2/profile|профиль]], как выбирается профиль — [[Zapret2/filter|фильтры профиля]], что значит `-d8` — [[out-range]].
## Как пресет попадает в движок
Программа не держит настроек «где-то ещё»: работает ровно то, что записано в тексте пресета. При запуске она берёт текст выбранного пресета, убирает комментарии и пустые строки, делит строки на отдельные параметры и записывает их во временный файл параметров. Движок `winws2.exe` получает этот файл через `@файл` — так в руководстве движка называется чтение опций командной строки из файла ([руководство nfqws2](https://github.com/bol-van/zapret2/blob/master/docs/manual.md)).
Перед настоящим запуском программа проверяет пресет тем же движком в режиме `--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:`.
![[wiki-anim-preset-builtin-update.svg|Анимация: правка встроенного пресета Default v1 2.49 сохраняется копией; после обновления до 2.50 копия уходит в presets\replaced, а её место занимает новая версия]]
Как это работает:
1. Вы меняете встроенный пресет — например, выбираете другую стратегию в профиле. Программа сохраняет вашу копию в `presets\winws2` под тем же именем, и дальше работает копия.
2. Выходит обновление программы, и номер `# BuiltinVersion:` у этого встроенного пресета становится больше, чем в вашей копии.
3. После запуска программа в фоне заменяет копию новой версией. Прежняя копия сохраняется в `presets\replaced\winws2\` (хранится одна, последняя), а вы получаете уведомление «Встроенные пресеты обновлены».
Номер поднимают только у правок, которые должны дойти до всех: другие стратегии, списки, добавленные или убранные профили. Переименование профиля или правка комментария номер не меняет, и ваша копия остаётся. Пресеты с вашими собственными именами файлов и пресеты, обновляемые по ссылке, программа не трогает.
> [!tip] Чтобы правки точно сохранились
> Сделайте свой пресет: «Дублировать» встроенный пресет и работайте в дубле. У дубля другое имя файла, и обновления встроенных пресетов его не заменяют. Если правка уже заменилась, её прежний вариант лежит в `presets\replaced\winws2\`.
## Обмен пресетами
На странице «Мои пресеты» пресет можно экспортировать в `.zip` — архив кладёт рядом с пресетом и его файлы списков из папки `lists`, чтобы у получателя всё заработало сразу. При импорте программа добавляет в шапку `# PresetKind: imported`; если у вас уже есть список с тем же именем, но другим содержимым, список из архива сохраняется под новым именем, и ссылка в пресете меняется на него — это видно в тексте пресета. Готовые пресеты других пользователей можно найти через кнопку «Получить конфиги» на той же странице: она открывает раздел обмена пресетами и профилями на Forgejo.
Пресет можно подключить и по ссылке: тогда программа сама обновляет его из источника, а ваше локальное имя сохраняется.
## Как пользоваться пресетами
Пресет — это набор стратегий, подобранных кем-то под своего провайдера. У вас блокировки могут быть устроены иначе, поэтому типичная картина такая: на одном пресете открывается YouTube, но не открывается Discord, на другом — наоборот. Перебирать пресеты целиком в поисках идеального — долго и часто бесполезно.
Работает другой порядок. Возьмите пресет, на котором открывается больше всего нужного, как основу. Найдите профиль, в который попадает неработающий сайт, и смените стратегию только в нём — на странице «Профили пресета». Подробно — [[Zapret2/profile|профиль]], как проверить стратегию — [[verify-strategy]].
Кнопка «Что это такое?» на странице «Мои пресеты» коротко объясняет то же самое прямо в программе.
## Тот же пресет в виде .bat-файла
Пресет — это те же самые флаги `winws2.exe`, только записанные в текстовый файл по одному на строку. Поэтому любой пресет можно превратить в обычный `.bat`-файл и запускать `winws2.exe` напрямую, без GUI, и наоборот: готовую командную строку из `.bat` можно разложить по строкам в текстовый файл и передать `winws2.exe` через `@файл`. Чтобы такой файл подхватил GUI, ему обычно нужны ещё служебные строки-комментарии в начале (`# Preset: …`, см. «Заголовок и метаданные»). Меняется только обвязка, логика [[profile|профилей]] остаётся прежней.
В `.bat` появляется несколько элементов, которых нет в `.txt`-пресете:
- `start "zapret: http,https,quic" /min` запускает `winws2.exe` в отдельном свёрнутом окне с заголовком из кавычек;
- `%~dp0` — папка, в которой лежит сам `.bat`. Через неё записываются пути к Lua-скриптам, блобам и спискам, чтобы файл работал из любого места;
- `^` в конце строки переносит команду на следующую строку. Вся команда для Windows остаётся одной строкой, перенос нужен только для читаемости;
- `@` перед путём в `--lua-init=@"…"` и `--blob=имя:@"…"` означает «прочитать содержимое из файла», а не использовать строку как есть.
Ниже пример такого запуска с шестью профилями, разделёнными `--new`. Сначала идёт общая часть: [[wf|--wf-tcp-out и --wf-raw-part]] решают, какой трафик WinDivert вообще передаст в программу, `--lua-init` подключает библиотеки стратегий и перенастраивает [[blob|блоб]] `fake_default_tls` (`tls_mod` со случайными данными и случайным SNI), `--blob` загружает QUIC-фейк из файла. Затем каждый профиль выбирает свой трафик [[filter|фильтрами]] `--filter-tcp`/`--filter-udp`/`--filter-l7` и хостлистом, ограничивает момент срабатывания через [[payload|--payload]] и [[out-range|--out-range]] и задаёт технику через [[desync|--lua-desync]].
```bash
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`-фильтры из общей части.
> [!warning] Устаревшее имя 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]].
## Источники
- [Руководство nfqws2, docs/manual.md — запуск с файлом параметров, профили и фильтры](https://github.com/bol-van/zapret2/blob/master/docs/manual.md)
## 📚 См. также
- [[Zapret2/profile|Профиль]] — из чего состоит профиль и как его настраивать
- [[Zapret2/filter|Фильтры профиля]] — как движок выбирает профиль для соединения
- [[Zapret/hostlist|hostlist]] и [[Zapret/ipset|ipset]] — списки сайтов и адресов, на которые ссылаются профили
- [[blob]] — заготовки фейков из шапки пресета
- [[wf|Фильтры захвата WinDivert]] — строки `--wf-…` в шапке
- [[out-range]] — что значат `-d8` и другие диапазоны
- [[verify-strategy|Как проверить стратегию]] — что делать после смены стратегии в профиле
---
> [!quote] 🤖 Эти статьи открыты — можно обучать на них ИИ
> При желании вы можете натренировать ИИ на наших статьях. Исходное форматирование доступно в Forgejo: [исходник этой заметки](https://iianajhlkh.zapret.moe/zapretdiscordyoutube/todo/src/branch/main/Zapret2/preset.md) · [скачать весь репозиторий одним zip-архивом](https://iianajhlkh.zapret.moe/zapretdiscordyoutube/todo/archive/main.zip).