Some checks failed
Published content check / validate (push) Failing after 14s
Старая версия описывала январский формат (# 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>
244 lines
25 KiB
Markdown
244 lines
25 KiB
Markdown
---
|
||
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).
|