Files
free-turn-proxy/docs/flags.md
T
samosvalishe 4bedd00662 refactor(wire): переименовать srtpmimicry → rtpopus, заменить bool -obf на -obf-profile
Готовим зонтик `internal/wire/` под будущие профили мимикрии (rtph264, vp8
и т.д.). Сейчас интерфейс/registry не вводим — родится при появлении второго
профиля; пока только перепаковываем единственный профиль в собственный namespace.

Пакет:
- `internal/wire/srtpmimicry` → `internal/wire/rtpopus`
- error-префикс `"wrap: ..."` → `"rtpopus: ..."`
- wire-формат не тронут (заморожен — совместимость с задеплоенными пирами)

CLI (breaking):
- `-obf` (bool) удалён
- добавлен `-obf-profile none|rtpopus` (default `none`)
- `ObfOpts.Mode bool` → `Profile ObfProfile` + `Enabled()` helper
- консты `ObfProfileNone`/`ObfProfileRTPOpus`
- validation invalid-value error для `-obf-profile`

Docker (breaking):
- env `OBF_MODE=true` → `OBF_PROFILE=rtpopus`

Callsites:
- `common.NewClientWrap` → `NewClientObf`
- vars `wc`/`relayWC` → `obfConn`, `wrapListener` → `obfListener`
- log `obf=%t` → `obf-profile=%s`

Доки + тесты подтянуты под новые имена.
2026-05-23 15:24:00 +03:00

2.7 KiB

Флаги

Клиент

Флаг По умолчанию Описание
-listen 127.0.0.1:9000 локальный адрес ip:port, куда подключается WireGuard или Xray клиент
-peer обязательный адрес сервера на VPS, host:port
-provider vk источник TURN-creds: vk (см. docs/providers.md)
-link обязательный для -provider vk ссылка VK Calls https://vk.com/call/join/...
-n 10 параллельных TURN-потоков
-transport tcp транспорт до TURN-реле: tcp (TCP/TLS) | udp
-mode udp режим туннеля: udp (UDP-релей для WireGuard) | tcp (TCP-форвардер для Xray/sing-box)
-bond false распределять одно TCP-соединение по всем активным smux-сессиям (только с -mode tcp)
-turn из creds переопределить IP TURN-сервера
-port из creds переопределить порт TURN-сервера
-obf-profile none wire-профиль обфускации payload: none | rtpopus (RTP/opus + ChaCha20-Poly1305 AEAD)
-obf-key пусто общий ключ для -obf-profile != none, 32 байта hex (64 символа)
-gen-obf-key false напечатать новый ключ и выйти
-manual-captcha false сразу ручной режим captcha (только -provider vk)
-streams-per-cred 10 потоков на один кеш VK-учёток (только -provider vk)
-dns-mode auto plain (UDP/53) | doh | auto
-dns-servers пусто свои UDP/53 резолверы, ip[:port][,ip[:port]...]
-debug false debug-логи

Сервер

Флаг По умолчанию Описание
-listen 0.0.0.0:56000 адрес прослушивания ip:port
-connect обязательный локальный backend host:port (WG 127.0.0.1:51820 / Xray 127.0.0.1:443)
-mode udp режим туннеля: udp | tcp (bond автоопределяется)
-obf-profile none wire-профиль обфускации payload: none | rtpopus (RTP/opus + ChaCha20-Poly1305 AEAD)
-obf-key пусто общий ключ для -obf-profile != none, 32 байта hex
-gen-obf-key false напечатать новый ключ и выйти
-debug false debug-логи