- Rust 93.1%
- HTML 5.8%
- Shell 1%
- Dockerfile 0.1%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
|
Some checks failed
ci / test (push) Has been cancelled
Сервер: - 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: зелёные |
||
| .cargo | ||
| .github/workflows | ||
| crates | ||
| deploy | ||
| scripts | ||
| .dockerignore | ||
| .gitignore | ||
| Cargo.lock | ||
| Cargo.toml | ||
| README.md | ||
| REVIEW.md | ||
| rustfmt.toml | ||
| SETUP.md | ||
Вуаль
Как собрать и поднять 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. Клиент не ходит никуда, кроме адреса из конфига.