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

3.4 KiB
Raw Blame History

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/файлы этого форка).