No description
  • Rust 93.1%
  • HTML 5.8%
  • Shell 1%
  • Dockerfile 0.1%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
nikit0s 007dfc367d
Some checks failed
ci / test (push) Has been cancelled
0.1.59: надёжность активаций и роутер-режима для продакшена
Сервер:
- fail-rate больше не штрафует адрес за просроченный по сроку, но
  верно подписанный cookie: плывущие часы клиента (роутер без NTP)
  не банят весь NAT-адрес на 600 с
- порядок проверок активации: websocket-заголовки и лимит сессий
  идут до replay-кэша, отказ на них больше не «сжигает» cookie
  до конца окна
- limits.idle_s (по умолчанию 300 с): мёртвая сессия освобождает
  слот через 5 минут тишины, а не через 30; CONFIG+SETUP+тест
- серверный TUN: ридер на AsyncFd вместо поллинга 5 мс; ответы
  ICMP доставляются адресно по (адрес, id эха), не broadcast;
  iptables MASQUERADE снимается и vuals0 удаляются при остановке
  vuald (Ctrl-C)

Клиент:
- --router и --tun получили пул точек: две неудачи соединения
  снимают точку, заморозка сразу берёт другую без чужого резюма,
  единственная точка пережидает и резюмит себя (как socks-режим)
- исправлена потеря уже поднятой сессии в цикле ротации

Панель:
- гонка links.json закрыта сериализацией create/delete

Деплой:
- compose: cap_add NET_ADMIN/NET_RAW + /dev/net/tun для
  серверного TUN (ICMP в Docker)

cargo fmt / clippy -D warnings / cargo test --workspace: зелёные
2026-11-19 22:00:33 +03:00
.cargo Вуаль 0.1.58: слияние, фиксы роутер-режима, новая веб-панель 2026-11-19 21:41:34 +03:00
.github/workflows Вуаль 0.1.58: слияние, фиксы роутер-режима, новая веб-панель 2026-11-19 21:41:34 +03:00
crates 0.1.59: надёжность активаций и роутер-режима для продакшена 2026-11-19 22:00:33 +03:00
deploy 0.1.59: надёжность активаций и роутер-режима для продакшена 2026-11-19 22:00:33 +03:00
scripts Вуаль 0.1.58: слияние, фиксы роутер-режима, новая веб-панель 2026-11-19 21:41:34 +03:00
.dockerignore Вуаль 0.1.58: слияние, фиксы роутер-режима, новая веб-панель 2026-11-19 21:41:34 +03:00
.gitignore Вуаль 0.1.58: слияние, фиксы роутер-режима, новая веб-панель 2026-11-19 21:41:34 +03:00
Cargo.lock 0.1.59: надёжность активаций и роутер-режима для продакшена 2026-11-19 22:00:33 +03:00
Cargo.toml 0.1.59: надёжность активаций и роутер-режима для продакшена 2026-11-19 22:00:33 +03:00
README.md Вуаль 0.1.58: слияние, фиксы роутер-режима, новая веб-панель 2026-11-19 21:41:34 +03:00
REVIEW.md Вуаль 0.1.58: слияние, фиксы роутер-режима, новая веб-панель 2026-11-19 21:41:34 +03:00
rustfmt.toml Вуаль 0.1.58: слияние, фиксы роутер-режима, новая веб-панель 2026-11-19 21:41:34 +03:00
SETUP.md 0.1.59: надёжность активаций и роутер-режима для продакшена 2026-11-19 22:00:33 +03:00

Вуаль

Как собрать и поднять SOCKS на одном компьютере: SETUP.md. Там же полный режим --tun nftables или --tun iptables: он нужен root и сервер на другой машине. Обычный vualc run сеть не трогает.

Корпоративный транспорт: TLS 1.3 на BoringSSL, decoy-сайт и туннель в том же соединении. Этап M0 — зашифрованный echo. Этап M1 — cookie-активация, SOCKS5 и кредитный flow control. Этап M2 (срез) — паддинг коротких STREAM, ACK на живом mux (кумулятивно, не реже 16 кадров или 20 мс; повтор шифртекста по RTO нет — nonce неявный), rekey с перекрытием приёма прошлой эпохи 2 с, keepalive PING 30 с без эхо-шторма, детектор заморозки и пейсинг записей отдельно от горячего пути. Побайтовый ClientHello, netns, CDN и iperf этим срезом не закрываются. Этап M3 начат с UDP: кадр DGRAM (best-effort, паддинг как у STREAM, ответ тем же sid) и SOCKS5 UDP ASSOCIATE для IPv4. Отдельно разбирается ссылка vual:// и проверяется ed25519-подпись текста подписки. vualc run с секцией [subscription] качает список сам, пока сессия жива, и меняет точки только в памяти. Автомат health пула в vualc run выбирает точку. Текст GET /metrics есть. vualc run --tun nftables или --tun iptables открывает TUN и ставит kill-switch; без флага правила не пишутся.

Сборка требует cmake, clang и libclang (bindgen для boring-sys). Интеграционные тесты TLS ещё вызывают openssl для выпуска сертификатов (echo_tls, vual-transport). На машине без openssl они падают, даже если сам cargo test -p vual-core зелёный.

Если libclang не в системных путях:

export LIBCLANG_PATH=/usr/lib/llvm-14/lib
export LD_LIBRARY_PATH="$LIBCLANG_PATH${LD_LIBRARY_PATH:+:$LD_LIBRARY_PATH}"
cargo fmt --all -- --check
cargo clippy --workspace --all-targets -- -D warnings
cargo test --workspace

Сервер:

vuald gen-pq-keys /etc/vuald
vuald serve --config /etc/vuald/server.toml
vuald echo --listen 127.0.0.1:9443 --cert server.pem --key server.key --pq-sec mlkem.sec

Клиент:

vualc run --config /etc/vual/client.toml
vualc echo --connect 127.0.0.1:9443 --host localhost --ca ca.pem --pq-pub mlkem.pub

Журнал по умолчанию — info: это ход сессии (принятие TCP, TLS, decoy или причина отказа активации, VERIFY/RESUME, открытие TCP и UDP, rekey, заморозка, простой, закрытие). Кадры без тел — RUST_LOG=debug, длины кусков TCP — RUST_LOG=trace. PSK, cookie, ключи, резюм-токен и байты полезной нагрузки в журнал не пишутся. Проект к боевому запуску не готов: это смотровая трасса, не критерий M3.

Пул точек участвует в vualc run: одна точка после заморозки ждёт и резюмит её, несколько точек — заморозка сразу берёт другую без чужого резюма. Две неудачи соединения подряд снимают точку. Дополнительные точки — [[member]] в toml, секреты общие с [endpoint]. Пока сессия жива, клиент раз в 30 минут делает обычный GET / без cookie. Чужую точку из пула он ещё и активирует, но не чаще раза в 6 часов. Неудача единственной точки туннель не рвёт. mode = "cdn" — тот же туннель: host и sni это имя сайта, tcp открывается на addr. Своего протокола CDN нет.

Текст kill-switch (nftables и RouterOS) собирается в vual-client fw и в систему не ставится. TUN — отдельный крейт vual-tun: ioctl и MTU 1420. В этой среде ядро ответило «operation not permitted», интерфейс не создан, маршруты не менялись. vualc run без --tun TUN не открывает. Подписка по https качается в vualc import --sub-url и, если в toml есть [subscription], ещё и во время сессии. Каталог deploy/ — Dockerfile и compose. Демона здесь нет, образ не собирался. Скрипт входа проверен отдельно: без сертификата и без [acme] он не стартует. scripts/build-aarch64.sh собирает glibc-бинарники aarch64; на x86_64 они не запускаются.

Счётчики vuald — текст Prometheus на GET /metrics, если в toml задан [metrics]. Слушателя по умолчанию нет, авторизации нет, адрес не должен смотреть в сеть. В текст входят байты STREAM (после паддинга на выходе, после снятия на входе) и последняя оценка RTT в миллисекундах. Потерь ACK и Frozen там нет: повтора кадра нет, заморозку видит только клиент.

Секция [control] включает панель управления на том же порту 443: вход по секретному пути /control-<суффикс> и/или только из туннеля по имени panel.vual (в DNS его нет, резолвится внутри туннеля). Ссылки, подписки, клиенты, журнал, редактор конфига с мягким применением. Без секции панели нет совсем; сканер на любом неверном пути получает байт-в-байт 404 сайта. Пароль печатает vuald control-pass. Подробно — в SETUP.md, раздел 7.

Конфиг сервера — TOML (не YAML из примера спеки: парсер toml уже в белом списке). Пути в файле относительны к самому файлу. PSK — ровно 32 байта.

[listener]
addr = "0.0.0.0:443"
cert = "fullchain.pem"
key = "privkey.pem"

[activator]
path = "/assets/app-9f3c1a.js"
window_s = 120
mlkem_secret = "mlkem.sec"
psk = "psk.bin"

[limits]
max_sessions = 15

[dns]
resolver = "127.0.0.1:53"

[fail_rate]
limit = 8
window_s = 60
penalty_s = 600

# Необязательно. Без секции порта метрик нет.
# [metrics]
# listen = "127.0.0.1:9101"

Конфиг клиента. [[member]] необязателен: без него точка одна. Пошагово — в SETUP.md.

[endpoint]
host = "docs.example.com"
addr = "203.0.113.10:443"
path = "/assets/app-9f3c1a.js"
ca = "ca.pem"
pq_public = "mlkem.pub"
psk = "psk.bin"

[socks]
listen = "127.0.0.1:1080"

Проверка с локального стенда: curl --socks5-hostname 127.0.0.1:1080 http://example.org. Клиент не ходит никуда, кроме адреса из конфига.