xah30
083c441e4c
- docs/protocol.md, pki.md, split-tunnel.md, sing-box.md переведены на русский и сверены с текущим кодом (транспорт v2: свой UDP + TCP/443 + QUIC fallback, handover; PKI; split-tunnel; sing-box-план). - docs/deployment.md (новый, 369 строк): пошаговое руководство для удалённого сервера — сборка, PKI init/issue-server/issue-client (проверено бинарём), server.toml/client.toml на основе фактических config/*.example, firewall + NAT/IP-форвардинг, sudo-запуск, бандл клиента (ca.crt + client.crt + client.key + server addr/sni), на каком транспорте идёт трафик, ограничения v1. - README.md (новый, корень): краткий обзор + таблица крейтов + быстрый старт. Всё на русском (проза); команды/идентификаторы/конфиги — как есть. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
37 lines
3.0 KiB
Markdown
37 lines
3.0 KiB
Markdown
# Aura VPN
|
||
|
||
Aura — гибридный пост-квантовый VPN на Rust. Внутреннее рукопожатие гибридное и взаимно
|
||
аутентифицированное (X25519 + ML-KEM-768 по FIPS 203 со взаимной X.509-проверкой), данные
|
||
шифруются ChaCha20-Poly1305 с explicit-nonce, обфускация — паддинг датаграмм под «корзины»
|
||
HTTPS-размеров.
|
||
|
||
На проводе по умолчанию идёт **собственный UDP-транспорт Aura** (без QUIC и без внешнего TLS на
|
||
основном пути). Если сеть режет UDP, клиент автоматически переключается на **TCP/443** или **QUIC**
|
||
(мимикрия HTTP/3), последовательно пробуя транспорты из настраиваемого `[transport] order`. На
|
||
стороне клиента есть TUN-интерфейс и split-tunnel (longest-prefix matching по CIDR + правила по
|
||
доменам), которым можно управлять на лету через admin-сокет.
|
||
|
||
## Крейты
|
||
|
||
| Крейт | Что внутри |
|
||
|------------------|----------------------------------------------------------------------------|
|
||
| `aura-crypto` | Гибридный KEM (X25519 + ML-KEM-768), HKDF, AEAD ChaCha20-Poly1305, helpers |
|
||
| `aura-pki` | Самоподписанный CA, выпуск server/client-сертификатов, проверка, плоский CRL |
|
||
| `aura-proto` | Рукопожатие Aura, фрейминг, датаграмный/потоковый кодек данных |
|
||
| `aura-transport` | Транспорты: собственный UDP, TCP/443, QUIC; единый dialer с handover |
|
||
| `aura-tunnel` | TUN, маршрутизатор, split-tunnel (CIDR + домены), DNS-резолв в host-маршруты |
|
||
| `aura-cli` | Бинарь `aura`: `pki`, `server`, `client`, `route`, `status`, `bench-crypto` |
|
||
|
||
## Быстрый старт
|
||
|
||
Подъём сервера на удалённой машине и подключение клиента описаны в
|
||
[`docs/deployment.md`](docs/deployment.md). Это основная точка входа для развёртывания.
|
||
|
||
## Документация
|
||
|
||
- [`docs/deployment.md`](docs/deployment.md) — руководство по развёртыванию (сервер + клиент)
|
||
- [`docs/protocol.md`](docs/protocol.md) — wire-протокол: рукопожатие, кадры, выбор транспорта
|
||
- [`docs/pki.md`](docs/pki.md) — модель PKI, команды `aura pki`, верификация и CRL
|
||
- [`docs/split-tunnel.md`](docs/split-tunnel.md) — split-tunnel, статика и admin-сокет на лету
|
||
- [`docs/sing-box.md`](docs/sing-box.md) — план интеграции с sing-box (для мобильных клиентов)
|