Reality: чужая вывеска
REALITY - модификация TLS. Свой клиент с ключом остаётся на вашем сервере. Соединение без ключа туннель не открывает: ядро пересылает его на ресурс из поля target. В target ставят только свой сайт или узел, на который есть письменное разрешение владельца. Модуль про поля и про границы: адрес машины, журнал, закон этот слой не заменяет.
ВВОДНАЯ
Держите открытой страницу REALITY. Английская и русская на xtls.github.io совпадают по полям. Сегодня не ставим сервер и не выбираем живой домен в интернете. Имя example.com ниже - образец из документации и зарезервированное имя для примеров. Свой target подставите в уроке 5.2, когда машина уже будет вашей.
ВЫ УЗНАЕТЕ
- куда девается байтовый поток, если сервер узнал клиента, и куда он девается без ключа;
- что такое пара x25519, shortId, отпечаток и зачем они лежат в разных карманах;
- чего этот слой не закрывает: адрес машины, журнал назначений, частные сети.
2.1 Куда уходит чужой запрос
REALITY - модификация TLS. Поля target и serverNames задают, какой TLS-ответ получит соединение без ключа. Это обработка неузнанного захода на ваш порт, не «режим доступа». Целевой ресурс в конфигурации называется target. Старое имя того же поля - dest. В текущих версиях это алиасы. Учебные тексты и старые заметки ещё говорят dest. В новом файле пишите target и помните, что сосед может принести старое имя.
Клиент подключается к вашему серверу, по адресу вашей машины. В Client Hello он кладёт имя из serverName. Это имя должно входить в серверный список serverNames. Клиент подключается к вашему IP и предъявляет имя из serverNames. Сертификат незнакомцу отдаёт ресурс из target. Адрес машины от этого не меняется.
Дальше развилка, и она вся из страницы REALITY. Это обработка неузнанного TLS-соединения на вашем порту: без ключа туннель не открывается. Это не отдельный «режим доступа».
Ключ подошёл. Сервер продолжает сессию как REALITY и везёт VLESS. Куда идти после туннеля, решает назначение, которое попросил клиент. На учебном сервере его выпустит исходящий Freedom. Донор в этой ветке не участвует.
Ключ не подошёл. Ядро пересылает байты на target без дополнительной проверки и туннель не открывает. Поэтому в target нельзя ставить чужой адрес, которым вы не распоряжаетесь: вы начнёте возить чужой трафик. Берите свой сайт или узел с разрешением владельца.
sequenceDiagram
participant K as Клиент
participant S as Ваш сервер
participant W as Сайт клиента
participant T as target
K->>S: Client Hello, SNI из serverNames
alt сервер узнал сессию
S-->>K: дальше идёт VLESS
K->>S: запрос к своему сайту
S->>W: Freedom открывает этот сайт
else сервер не узнал
S->>T: трафик уходит на target
T-->>K: страница донора
end
Ядро отличает серверный конфиг от клиентского по полю target. На клиенте его нет. Если вписать target в клиент, ядро решит, что перед ним сервер. Роль перепутается.
REALITY сочетается только с тремя транспортами: RAW, XHTTP и gRPC. Так написано на странице. На Xray 26.11.9 ядро отвергает транспорт вне этой тройки и пишет ту же границу. Наш курс едет на RAW. В конфиге это "method": "raw". В ссылке, урок 3.2, то же самое записано как type=tcp, потому что стандарт ссылки ещё называет RAW словом tcp и всё ещё указывает на поле network. Страница транспорта уже пишет method и значение raw. На Xray 26.11.9 проверка файла принимает и method со значением tcp, и старое поле network. В учебном JSON остаётся имя со страницы.
- Гость без ключа попадает ко мне в комнату? - Нет. Он видит сайт из target. Комната открывается тому, кого сервер узнал. Если гость «успешно» открыл чужую главную, проверка как раз не прошла.
2.2 Ключи, shortId и отпечаток
На сервере обязательны target, serverNames, privateKey и список shortIds. На клиенте обязательны serverName, fingerprint, password и один shortId из серверного списка. Поле show в образце документации равно false. Это выключатель отладочной печати, не поле входа.
Пара x25519. Команда xray x25519 печатает три строки. PrivateKey остаётся на сервере, в поле privateKey. Password (PublicKey) уезжает клиенту. В конфиге клиента поле называется password. В ссылке тот же набор байтов называется pbk. Третья строка, Hash32, ни туда, ни туда не кладётся.
Имя Password легко прочитать как «пароль от сервера, его никому не дают». Смысл другой. Это открытая половина пары, но проект сознательно не называет её публичным ключом в конфиге: строку не выкладывают на всеобщее обозрение, ею пользуется свой клиент. Старое имя поля было publicKey. Новые файлы пишите password. На сборке старше смены подписи строка может называться короче. Смотрите, что это не Hash32.
Повторить Password от уже известного PrivateKey можно так: xray x25519 -i "приватный ключ". Так страница REALITY и описывает клиентское поле.
shortId. Это метка внутри REALITY, не UUID пользователя. Длина до 8 байт, то есть до 16 символов из диапазона 0-f. Число символов чётное: один байт - два знака. Если строка короче 16, ядро дописывает нули справа. В документации разобран пример. aa1234 превращается в aa12340000000000. aaa1234 даёт ошибку. Пустая строка тоже чётная. Она допустима, только если пустая строка есть и в серверном shortIds.
Список на сервере может содержать несколько меток. Клиент приносит одну. Отдельной команды xray shortid в списке xray help нет. Подойдёт любая чётная строка нужного алфавита. Как добыть случайные байты, решает система, не ядро.
Отпечаток. Поле fingerprint для клиента REALITY обязательно по странице протокола. Библиотека uTLS задаёт вид первого пакета Client Hello. Полного браузера из этого не выходит, так пишет страница TLS. Остальное поведение остаётся поведением Go.
Список имён на странице TLS широкий: chrome, firefox, safari, ios, android, edge, 360, qq, плюс random и randomized. Для REALITY гарантия узкая. Страница REALITY пишет, что отпечаток должен поддерживать MLKEM, постквантовый обмен ключами, и работоспособность обещана только для chrome, firefox и safari. В учебном файле стоит chrome. Значение unsafe на странице TLS возвращает родной Go. Для REALITY курс его не предлагает.
В ссылке то же поле называется fp. Стандарт ссылки говорит: для REALITY fp опускать нельзя. Если опустить его в другом режиме, подразумевается chrome. Почему именно chrome, стандарт объясняет так: отпечаток Go уже выделяли, а Chrome он называет браузером с самой большой долей. Почему не random, там же два других соображения. Доля случайных отпечатков может сползти к той, что заложена в ядре. И один криво реализованный отпечаток uTLS портит всю пачку. Долю браузеров курс сам не мерил. Это слова стандарта.
Поле spiderX - начальный путь краулера. Страница рекомендует разные значения разным клиентам. В ссылке это spx. Пустым оно быть может. В базовый учебный файл мы его не кладём, чтобы не добавить второй обязательный секрет там, где документация секрет не требует.
HASH32 - НЕ КЛЮЧ КЛИЕНТА
В pbk идёт строка Password. PrivateKey остаётся на сервере. Hash32 не является ни тем, ни другим. Перепутанная строка выглядит как обычный base64, поэтому глаз её пропускает. Смотрите на подпись строки, не на длину.
2.3 Что делает flow
flow выбирает алгоритм XTLS. На пользователе VLESS в нашем курсе стоит xtls-rprx-vision.
Пустая строка или отсутствие поля - обычный TLS, без Vision. xtls-rprx-vision добавляет случайное заполнение внутреннего рукопожатия. На исходящей стороне та же страница описывает ещё одну деталь про QUIC. UDP к порту 443 перехватывается, чтобы браузер ушёл в обычный HTTPS, а не в QUIC. Так больше трафика можно отдать splice: внутри остаётся TLS 1.3 по TCP. Рядом есть xtls-rprx-vision-udp443. Он то же самое, но UDP 443 не перехватывает. Его берут, когда программа обязана говорить по QUIC и без этого ломается.
Порт 443 в этом абзаце - порт назначения у внутреннего UDP, не порт, на котором слушает ваш Xray. Их легко склеить в одну цифру. Это разные места.
XTLS на связке TCP с TLS или REALITY умеет splice, если внутри идёт TLS 1.3. Splice - функция ядра Linux: ядро перекладывает TCP само, без лишней копии через память Xray. Страница исходящего VLESS перечисляет условия. Среда Linux. Входящий на той стороне - чистый TCP, в списке до сих пор упомянут старый dokodemo-door, а также SOCKS, HTTP и другие входящие с XTLS. Исходящий - VLESS с XTLS. Пока ядро везёт поток само, счётчик скорости во всплывающем окне отстаёт и догоняет факт уже после разрыва. Это не зависание. Так страница описывает splice.
На сервере в списке пользователей flow стоит у того пользователя, которому режим нужен. На клиенте то же значение приезжает полем flow в ссылке. Пустое с одной стороны означает обычный режим, как он назван в документации. Держите одну и ту же непустую строку на обоих концах, если выбрали Vision.
Про скорость ещё раз, чтобы цифра не уехала в разряд обещания. Документация говорит про возможный прирост «в несколько раз или даже больше чем в десять раз» у REALITY вместе с подходящим Vision. Курсом это не измерялось. Имеет смысл другое наблюдение, и оно качественное. Vision уменьшает внутренний слой TLS-in-TLS, который документация проекта считает характерным следом VLESS. Это описание поля flow, не обещание, что поток «не виден».
2.4 Донор и границы
Донор - это target плюс имена в serverNames. Не «какой-нибудь большой сайт из памяти». Страница задаёт условия.
Имя в serverNames - то, которое target готов принять. Обычно смотрят на SAN сертификата, который сайт отдаёт. Звёздочка не поддерживается. Пустая строка в списке разрешает Client Hello без SNI. Тогда клиентский serverName как раз не пустой: туда кладут IP-заглушку. В базовом курсе мы так не делаем. Нам хватает одного имени, которое сайт принимает.
Проверка с вашей машины, когда Xray уже стоит: xray tls ping и домен цели. Та же команда показывает, как сервер ведёт себя на запрос без SNI. Пока ядра нет, домен из примера не «пингуйте» в надежде, что он годится в доноры. example.com в образце документации - имя для примера.
Чего избегать, страница говорит прямо. Если адрес target особенный, пример в тексте - сайт за Cloudflare CDN, ваш сервер после проверки начинает пересылать чужой трафик в эту сеть. Неузнанный заход вы увезёте дальше сами. Лучшая практика курса: target - ваш собственный сайт или узел в вашей инфраструктуре, лучше на той же машине или в вашей сети. Совпадение ASN с чужим популярным сайтом как приём не рекомендуем и не разбираем. Ограничители limitFallbackUpload и limitFallbackDownload существуют, но страница называет само ограничение отпечатком и не рекомендует его. В учебный файл они не входят.
Вывеска не защищает несколько вещей, и это стоит произнести спокойно.
- Адрес сервера остаётся вашим. Сосед по сети и площадка по-прежнему видят ваш IP. Форма рукопожатия не делает машину чужим сайтом и не заменяет закон. Равенства с обычным HTTPS курс не обещает.
- Площадка видит машину. REALITY не прячет VPS от того, кто эту VPS продал.
- Ссылка - секрет. UUID, Password и shortId вместе пускают внутрь. Кто скопировал ссылку, тот клиент.
- Журнал на сервере видит назначения. Исходящий Freedom открывает сайт, который попросил человек. Оператор сервера этот факт может записать. Это вопрос приватности журнала. Поле
maskAddressкак раз для того, чтобы адреса в логе прятать, когда лог кому-то показывают. - Две фразы про вид потока живут рядом. Решающая - вторая: TLS и REALITY сами по себе не дают тех же признаков, что обычный HTTPS. Vision описывает поле
flow. Равенства с обычным HTTPS курс не обещает. - Частные адреса по умолчанию закрыты. У Freedom для входящего VLESS встроенный запрет на частные и зарезервированные диапазоны. Корпоративная сеть и адреса самой машины клиенту так не открываются. Это защита инфраструктуры. Явное правило
allowнужно только если доступ внутрь правда ваш, и его ограничивают. - Квантовый задел - отдельный флаг.
mldsa65Seedдобавляет подпись ML-DSA-65. Если его включить, сертификат донора должен быть длиннее 3500 байт, иначе временный сертификат REALITY сам станет отметиной. В базовом файле флага нет. Команда генерации, когда до неё дойдёт дело, -xray mldsa65.
Отдельный постквантовый обмен X25519MLKEM768 клиент REALITY включает сам, если его поддерживает target. Проверка - снова xray tls ping по вашему домену. Вручную в учебном JSON этого нет.
ТОЛЬКО СВОЙ РЕСУРС
В target ставьте только ресурс, которым вы распоряжаетесь или на использование которого есть письменное разрешение владельца: свой сайт, свой хост, корпоративный узел. Того, что «логин не нужен», недостаточно: разрешения всё равно нет. Чужой публичный сайт без такого разрешения не берите.
НЕ БЕРИТЕ ЦЕЛЬ ЗА CDN
Предупреждение на странице REALITY конкретное. Неузнанный трафик уходит на target как есть. Если этот адрес принадлежит чужой сети доставки, сервер начинает возить чужое. Чужой «список хороших доноров» из однострочного установщика курс не подтверждает и не повторяет. Берите свой сайт.
ПРАКТИКА
- Выпишите поля, которые живут только на сервере: из урока 2.2 их четыре обязательных. Рядом напишите клиентские имена тех же секретов, где пара есть.
- Три метки:
aa1234,aaa1234, пустая строка. Какая недопустима всегда, какая допустима только при условии, что сервер её тоже разрешил? - Придумайте описание плохого донора без настоящего домена. В описании должен быть ровно тот класс, который страница REALITY приводит как пример открытой пересылки.
ВЫВОД МОДУЛЯ
Клиент всегда стучится к вам. Узнали ключ - везёте его назначение через Freedom. Не узнали - туннель не открывается, соединение уходит на ваш target. Password едет клиенту, PrivateKey остаётся, Hash32 не используется, shortId чётный, отпечаток для REALITY берите из трёх имён с гарантией. Адрес машины этот слой не прячет и закон не заменяет. В модуле 5 эти поля лягут в учебный JSON. Сначала посмотрим, как их читает клиент.
ПРОВЕРЬТЕ СЕБЯ
- Куда Xray девает соединение, которое не прошло проверку REALITY, и почему из-за этого опасен
targetза CDN? - Какая из трёх строк
xray x25519попадает вpbk? - Почему
aaa1234не годится в shortId, аaa1234годится?