release: prepare 0.2.0 for sing-box 1.14

2026-09-08 19:26:00 +05:00
parent 81ea89f7fa
commit 76dce5b47a
42 changed files with 1634 additions and 549 deletions
@@ -1,15 +1,51 @@
-# Почему sing-box 1.14 не поддерживается
+# Контракт sing-box 1.14.0

-Ветка 1.14 меняет конфигурационный контракт TUN, TLS/QUIC и Hysteria2. Проект не
-пытается угадать совместимость и не содержит `--allow-unsupported`.
+Проект поддерживает ровно `sing-box 1.14.0`. RC, alpha, другие patch-релизы и
+будущие версии отклоняются до записи файлов.

-Отдельная миграция на 1.14 потребует:
+## Принятые изменения 1.14

- аудита release notes и tagged schema;
- нового renderer с отдельными golden fixtures;
- проверки удалённых/deprecated полей;
- повторного TUN/nftables/strict-route canary;
- тестов Hysteria2 reconnect, DNS и rollback;
- отдельного package release и runbook.
+### Gecko

-До завершения этой работы любой 1.14.x отклоняется до записи файлов.
+```json
+{
+  "type": "gecko",
+  "password": "...",
+  "min_packet_size": 512,
+  "max_packet_size": 1200
+}
+```
+
+512/1200 совпадает с profile HY2XS и текущими upstream defaults, но рендерится
+явно. Hysteria отмечает Gecko как experimental; проект осознанно принимает его
+как единственный production obfs сервера HY2XS.
+
+### TUN DNS
+
+Новый default `dns_mode=hijack` не используется. Renderer задаёт `disabled`,
+потому что проект уже имеет явную DNS route rule и отдельные bootstrap/DoH
+маршруты. Это решение должно подтверждаться privileged Linux acceptance.
+
+### Chrome QUIC parroting
+
+Renderer явно задаёт `disable_chrome_parrot=false`. Серверный certificate должен
+быть RSA/ECDSA/ACME, не Ed25519.
+
+### Congestion control
+
+Policy задаёт `up_mbps/down_mbps`, поэтому используется Hysteria CC. Поле
+`bbr_profile` не добавляется: оно предназначено для режима BBR при пустых
+bandwidth values.
+
+## Не включено
+
+Realm, mimic, ECH, certificate pinning, random hop interval, TLS spoof, custom
+Gecko sizes и новые UDP NAT knobs не входят в контракт 0.2.0.
+
+## Официальные источники
+
+- <https://github.com/SagerNet/sing-box/releases/tag/v1.14.0>
+- <https://sing-box.sagernet.org/configuration/outbound/hysteria2/>
+- <https://sing-box.sagernet.org/configuration/inbound/tun/>
+- <https://v2.hysteria.network/docs/developers/URI-Scheme/>
+- <https://v2.hysteria.network/docs/advanced/Full-Client-Config/>