Клиенты и ссылка vless://
Сервер без клиента - дверь в пустую комнату. Клиент без понимания ссылки - картинка, которую страшно трогать. Сегодня разберём ссылку по полям на вымышленных значениях. Кнопки в программах меняются быстрее ядра, поэтому курс называет программы и не выдумывает пункты меню.
ВВОДНАЯ
Держите открытым обсуждение стандарта ссылки в репозитории Xray-core и README того клиента, который собираетесь ставить. Сервер мы ещё не поднимаем. Учебный адрес 203.0.113.10 зарезервирован документами под примеры. Подключение к нему ничего не откроет, и так и задумано.
ВЫ УЗНАЕТЕ
- какие клиенты подтверждены README или страницей Xray, а какие курс назвать до конца не может;
- что означает каждое поле учебной ссылки
vless://; - как узнать типичную ошибку по тому, что клиент показывает чужой сайт, молчит или ругается на ключ.
3.1 Какой клиент на какой полке
Оболочка показывает ссылку и зовёт ядро. Ядро везёт VLESS. Путать их уже не стоит, урок 1.2. Ниже только то, что прочитано. Где README молчит, курс молчит вместе с ним.
v2rayN - графический клиент для Windows, Linux и macOS. README прямо пишет поддержку Xray и sing-box. Мобильную пару тот же текст отправляет в v2rayNG. Как импортировать ссылку, написано в wiki репозитория. Имя пункта меню отсюда не копируйте: в день установки откройте wiki.
v2rayNG - клиент для Android, ядра Xray и v2fly. В README есть замечание про разрешение системного туннеля для подсистемы Android в Windows, WSA. Значит, программа умеет просить у системы забрать маршрут, а не только туннель одного браузера. Где это в текущем экране, смотрите в самой программе. Слова из README в курс не копируются: смотрите само разрешение.
NekoBox For PC живёт в репозитории, который многие помнят как Nekoray. Сам репозиторий архивный. В его описании на GitHub написано, что сопровождение прекращено и замену ищут сами. Файл README при этом всё ещё описывает программу: Windows и Linux, внутри sing-box, в списке протоколов есть VLESS. В благодарностях Xray-core указан для версий с 3.10 по 3.26. Описание репозитория и текст README - разные полки. На новую машину архив не ставьте. Имя NekoBox без уточнения легко спутать с другими сборками. Берите ту, чей README вы открыли сегодня, и только если репозиторий ещё сопровождается.
Hiddify встречается дважды, и это разные двери. На странице Xray-core в ряду панелей ссылка ведёт в Hiddify-Manager. Репозиторий hiddify-app описывает клиент и сам называет системы: Android, iOS, Windows, macOS и Linux. Среди протоколов там есть Reality. README клиента отдельно говорит, что панель - это Hiddify Manager, другой репозиторий. Не отдавайте телефону адрес панели. Перед установкой прочитайте README именно того репозитория, чей файл скачиваете.
Streisand назван на странице Xray-core в ряду iOS, macOS arm64 и tvOS. Отдельный README в этой сверке построчно не читался. Факт полки - из списка проекта X. Факт конкретной кнопки - из приложения в день установки.
FoXray и V2Box в прочитанном списке графических клиентов на странице Xray-core не стояли. Курс не подтверждает их системные требования и не описывает экраны. Если ставите их, источником будет их собственная страница, не этот модуль. Общее у всех оболочек одно: они либо понимают ссылку vless://, либо не понимают. Это написано у них, не у нас.
Скачивать программу стоит со страницы её репозитория или из магазина, на который этот репозиторий ссылается. Команду установки клиента, если она плавает, в PDF не фиксируем. В день установки скопируйте её из README.
АРХИВ - НЕ ПОЛКА
Репозиторий Nekoray архивный, в описании на GitHub его просят заменить. Файл README при этом ещё описывает старую программу. Рабочий конфиг оттуда может открыться. Обновлений под новые поля ядра оттуда уже не будет. Незнакомое поле старая оболочка может выкинуть или показать как чужое. Для учёбы спокойнее клиент, который проект X всё ещё перечисляет.
3.2 Поля ссылки
Ссылка - обычный URL. Слева протокол vless, потом идентификатор, потом адрес сервера, порт, вопросы и имя. Учебный пример собран из заглушек. Подставлять его в клиент как боевой не нужно: сервера по этому адресу у курса нет.
На листе ссылка разложена по полям, чтобы строка не уезжала за край. В клиент её вставляют одной строкой, без пробелов и переносов.
vless://11111111-1111-4111-8111-111111111111@203.0.113.10:443
?type=tcp
&encryption=none
&security=reality
&pbk=REPLACE_WITH_PASSWORD
&sid=a1b2c3d4e5f67890
&sni=www.example.com
&fp=chrome
&flow=xtls-rprx-vision
#uchebnyj
| Поле | Откуда | Что это в нашей схеме |
|---|---|---|
11111111-1111-4111-8111-111111111111 |
пользователь, id |
UUID. Настоящий даёт xray uuid. Эта строка - заглушка формы |
203.0.113.10 |
адрес машины | Куда стучится клиент. Сеть 203.0.113.0/24 зарезервирована под документацию |
443 |
port входящего |
Порт вашей машины. В примере он совпал с привычным HTTPS. Протокол этого не требует. Диапазон в стандарте - от 1 до 65535 |
type=tcp |
транспорт | В стандарте ссылки tcp соответствует RAW. В config.json курса то же место записано как "method": "raw" |
encryption=none |
VLESS | Своё шифрование выключено явно. Если параметр опустить, стандарт всё равно подразумевает none. Пустая строка запрещена |
security=reality |
защита транспорта | Если параметр опустить, стандарт подразумевает none. Для нашей схемы опускать нельзя |
pbk |
password клиента |
Строка Password от xray x25519. Не PrivateKey и не Hash32 |
sid |
shortId |
Одна метка из серверного списка. Может быть пустой, если сервер пустую разрешил. Наша заглушка - 16 чётных знаков |
sni |
serverName |
Имя донора, одно из serverNames. Если параметр опустить, стандарт подставит адрес хоста из ссылки. В примере хост и имя разные нарочно |
fp=chrome |
fingerprint |
Для REALITY параметр обязателен. chrome входит в тройку, для которой страница REALITY обещает MLKEM |
flow=xtls-rprx-vision |
flow пользователя |
Режим Vision из урока 2.3. Пустым его оставляют только когда хотят обычный TLS без Vision |
uchebnyj |
фрагмент после # |
Подпись в списке клиентов. Пробел и нелатинские буквы кодируют через encodeURIComponent |
Два адреса в одной строке - частая путаница. Слева от ? стоит машина, куда идёт TCP. В sni стоит вывеска. Они не обязаны совпадать. В учебном примере они специально разные: 203.0.113.10 и www.example.com. Если подставить донора в адрес хоста, клиент пойдёт не на ваш сервер.
spx и pqv стандарт тоже описывает. spx - это spiderX, путь краулера, его кодируют. pqv - проверка подписи ML-DSA-65. В базовой ссылке обоих нет, потому что в базовом сервере нет ни краулера, ни этой подписи. Пустой sid стандарт разрешает. Пустой pbk при REALITY - нет.
Порядок параметров в вопросе URL не несёт отдельного смысла. Имеет смысл имя. security - не encryption. Их когда-то развели именно потому, что оба слова хотели назвать защитой. Внутреннее шифрование VLESS называется encryption. Внешний слой называется security.
3.3 Импорт ссылки и QR
Ссылка - текст. QR-код - тот же текст, нарисованный квадратом. Сканер не приносит второй секрет. Он приносит строку, которую вы могли бы вставить из буфера. Если в квадрате одна заглушка из урока 3.2, клиент получит заглушку. Картинка ничего не исправляет.
Куда нажать, README разобранных клиентов в этой сверке по пунктам не расписывает. У v2rayN на это есть wiki. У остальных смотрите экран и документацию выпуска. Ищите действие вроде вставки из буфера или сканирования. Не ищите отдельный «режим Reality»: поля уже лежат в ссылке.
После вставки сверьте с таблицей урока 3.2: адрес машины, порт, security, pbk, sid, sni, fp, flow и UUID. Подпись после # на соединение не влияет. В модуле 6 у каждого человека будет свой email в журнале и своя подпись в ссылке. Это разные строки. email в URL этой ссылки нет.
Если клиент предлагает туннель одной программы или туннель всего маршрута, выберите то, что вам нужно по уроку 1.1. Ссылка этот выбор не хранит. Его хранит оболочка.
3.4 Когда ссылка почти та
Почти правильная ссылка хуже явно битой. Клиент молчит, открывает чужой сайт или пишет про ключ, а глаз видит знакомые слова reality и chrome.
| Что видите | Куда смотреть | Чем проверить |
|---|---|---|
| Открывается сайт донора, туннель молчит | Проверка REALITY не прошла, зонд ушёл на target |
sni есть в serverNames, pbk - это Password, sid есть в списке, flow тот, что на пользователе |
| Клиент сразу ругается на разбор | Сломана строка URL | Порт в диапазоне, нет пустого encryption= и пустого security=, fp при REALITY не выкинут |
| Долго нет соединения | До машины не дошли | Адрес слева от ? - сервер, порт открыт. Файрвол разберём в уроке 4.4 |
| Соединение есть, нужный сайт не открывается | Уже туннель, спорит выход | Частные адреса Freedom для VLESS режет по умолчанию. Публичный сайт при этом может открываться |
| Всё совпало, а сервер вас не знает | Другой id |
UUID в ссылке и id в users - одна строка |
Нечётный sid страница REALITY не принимает. Клиент может показать это как общую ошибку. Посчитайте символы. Если sni забыли, стандарт подставит адрес машины. Донор ждёт своё имя, не ваш IP. Пишите sni явно.
ССЫЛКУ НЕ ОТПРАВЛЯЮТ В ОБЩИЙ ЧАТ
UUID, pbk и sid вместе являются пропуском. Картинка QR - тот же пропуск. Учебная строка выше безопасна только потому, что ключ в ней не ключ, а слово REPLACE_WITH_PASSWORD, и адрес зарезервирован под примеры. Боевую строку так не публикуют.
ПРАКТИКА
- Разберите учебную ссылку на бумаге по таблице урока 3.2. Отдельно подпишите, какую строку нельзя класть в
privateKey. - Назовите два разных симптома: «виден сайт донора» и «нет соединения вовсе». У каждого должна быть своя проверка, не одна на двоих.
- Откройте README клиента, который собираетесь поставить. Найдите, откуда его скачивать. Если репозиторий архивный, запишите это одним предложением и выберите другой.
ВЫВОД МОДУЛЯ
Ссылка собирает UUID, адрес машины, порт, RAW под именем tcp, выключенное своё шифрование, REALITY, Password, shortId, имя донора, отпечаток и Vision. QR повторяет текст, а не дополняет его. Чужой сайт на экране чаще означает, что проверка не прошла и сработал target. Дальше нужна машина, на которой этот target вообще можно указать. Это модуль 4.
ПРОВЕРЬТЕ СЕБЯ
- В учебной ссылке хост
203.0.113.10, аsniравенwww.example.com. Какой из них адрес сервера? - Что получит клиент, если параметр
securityиз ссылки просто убрать? - Почему архивный Nekoray не стоит ставить на новую машину, даже если в файле README всё ещё написано VLESS?