Files
luci-app-owrt-remote/docs/REALITY_TRANSPORT.md
T
cyril d482ed97c4 fork: REALITY client must carry shortId; default camo moved off www.microsoft.com
Verified 22.11.2026 (xray 26.7.28 + 26.11.9, matrix of 4 version pairs):
- REALITY authenticates fine both directions ONLY when the client
  realitySettings includes "shortId"; without it the server silently
  falls back to passthrough ("received real certificate").
- dest www.microsoft.com is broken for REALITY MITM (Microsoft now
  serves post-quantum cert chains); www.cloudflare.com / www.apple.com /
  www.google.com / download.windowsupdate.com / www.jetbrains.com all work.
- hub transport: expose shortId in summary/payload/uci line; agent reads
  uci reality_short_id and emits "shortId" in realitySettings.

NOTE: new tag-form VLESS reverse (Rvs, PR #5101) does NOT register its
control connection when the bridge transport is REALITY on xray >= 26.7
(portal logs show handshake auth OK but no v1.rvs.cool request;
security=none works). See XTLS/Xray-core #6242 #6248. Reverse-over-REALITY
e2e therefore blocked pending core-version bisect (26.4.25) or upstream fix.
2026-11-22 12:15:22 +03:00

48 lines
3.4 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# REALITY-транспорт hops роутер↔хаб (наш форк)
## Суть
Upstream: один VLESS-inbound хаба на `:8443` c `network=tcp, security=none`.
Роутер дIAL-OUTит к хабу; reverse-порталы (LuCI/SSH) живут за тем же conn.
Без TLS: весь трафик и логин-данные в панели — открытым текстом внутри hops.
Форк: тот же единственный inbound, но `security=reality` — полноценное TLS-рукопожатие,
замаскированное под handshake публичного сайта-прикрытия (`dest`), без CA-сертификатов
и продлений. Аутентификация по-прежнему per-router UUID (LuCI + SSH = два UUID).
## Где что генерируется
- Хаб: `transport.json` в `STATE_DIR` (`/var/lib/owrt-remote/`), создаётся лениво
(`xray x25519` → приват/публик, `shortId` = 8 hex, `dest`=SNI из env).
- Серверный inbound: `privateKey`, `serverNames=[SNI]`, `shortIds=[shortId]`,
`dest=<SNI>:443`, `xver=0`.
- Клиент (роутер): `publicKey`, `serverName`, `fingerprint` (chrome). shortId клиенту
не нужен (сервер кодирует его в «фейковом» сертификате).
- Конфиг роутера хаб отдаёт готовыми `uci set owrtremote.main.security/reality_*`
(карточка роутера / print-openwrt-config / панельный «Xray настройки» на роутере).
- Heartbeat остаётся отдельным HTTPS-каналом (через панель/Pangolin), к xray не относится.
## Пин версии xray на хабе (важно!)
Upstream-регрессия **XTLS/Xray-core#7259**: REALITY-сервер 26.9.8+ не принимает
рукопожатия клиентов (клиент: `received real certificate (potential MITM or redirection)`).
Практика 22.11.2026: связка 26.11.9↔26.11.9 не работает, ~~26.7.28~~ (см. таблицу матрицы
в коммите форка/заметку хаба) — хаб держим на **26.7.28**, пока upstream не выпустит фикс.
Обновление хаба на новую версию core — только после повторного прогона e2e-матрицы
(hub-generators → две локации xray → reverse-туннель через reality).
## Смена camouflage-домена
env хаба: `OWRT_REMOTE_REALITY_DEST=download.windowsupdate.com`, рестарт `owrt-remote`,
затем пересоздать конфиги роутеров (карточка → новая команда uci; shortId/pk те же, если
не трогать transport.json). Удаление `transport.json` = новая x25519-пара и новый shortId
⇒ всем роутерам нужны новые конфиги.
## Совместимость / откат
`OWRT_REMOTE_TRANSPORT=none` + рестарт = ровно upstream-поведение (но генератор конфига
роутера продолжит писать `security=none`, роутер-агент умеет оба).
Старые агенты (без полей security) не работают с reality-hub — роутер нужно обновить
(установить ipk/файлы этого форка).