$ sudo teach IT

Клиенты и ссылка 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, и адрес зарезервирован под примеры. Боевую строку так не публикуют.

ПРАКТИКА

  1. Разберите учебную ссылку на бумаге по таблице урока 3.2. Отдельно подпишите, какую строку нельзя класть в privateKey.
  2. Назовите два разных симптома: «виден сайт донора» и «нет соединения вовсе». У каждого должна быть своя проверка, не одна на двоих.
  3. Откройте README клиента, который собираетесь поставить. Найдите, откуда его скачивать. Если репозиторий архивный, запишите это одним предложением и выберите другой.

ВЫВОД МОДУЛЯ

Ссылка собирает UUID, адрес машины, порт, RAW под именем tcp, выключенное своё шифрование, REALITY, Password, shortId, имя донора, отпечаток и Vision. QR повторяет текст, а не дополняет его. Чужой сайт на экране чаще означает, что проверка не прошла и сработал target. Дальше нужна машина, на которой этот target вообще можно указать. Это модуль 4.

ПРОВЕРЬТЕ СЕБЯ

  1. В учебной ссылке хост 203.0.113.10, а sni равен www.example.com. Какой из них адрес сервера?
  2. Что получит клиент, если параметр security из ссылки просто убрать?
  3. Почему архивный Nekoray не стоит ставить на новую машину, даже если в файле README всё ещё написано VLESS?