Формат ссылки vless:// — объяснение параметров на примере v2rayN
Полный разбор ссылки vless://: обязательные части, параметры запроса, пример импорта в v2rayN и типичные ошибки.
Содержание
VLESS — современный прокси-протокол, созданный как альтернатива VMess. Он не добавляет собственного шифрования, поэтому работает быстро и легко маскируется под обычный TLS-трафик. Для обмена конфигурациями разработчики придумали универсальную текстовую ссылку vless://. В этой статье разберём её формат на примере популярного клиента v2rayN.
Что такое VLESS и зачем нужна ссылка?
VLESS — это протокол передачи данных, который использует UUID для аутентификации. Его главное преимущество — минимальный overhead и возможность использовать различные транспорты (TCP, WebSocket, gRPC) и уровни шифрования (TLS, REALITY, xtls-rprx-vision).
Ссылка vless:// — это способ упаковать все настройки подключения в одну строку. Она похожа на URL, но имеет свою схему. Клиенты, такие как v2rayN, умеют распознавать такую ссылку, автоматически парсить её и добавлять сервер в список. Это удобно для шаринга: достаточно передать ссылку — и пользователь импортирует конфигурацию за секунды.
Структура ссылки vless://
Общая форма ссылки выглядит так:
vless://UUID@HOST:PORT?param1=value1¶m2=value2#REMARK
Разберём обязательные элементы:
- UUID — идентификатор пользователя. Генерируется на сервере и привязан к конкретному аккаунту. В ссылке это первая часть до символа
@. - HOST — адрес сервера: домен (например, example.com) или IP-адрес.
- PORT — порт, на котором сервер принимает соединения (обычно 443 для TLS или 80 для WebSocket).
После # идёт необязательный «заголовок» — короткая метка, которая отображается в списке серверов v2rayN. Её можно использовать для названия конфигурации.
Параметры запроса: type, security, headerType и другие
Всё, что идёт после знака вопроса, называется query-параметрами. Они управляют транспортом, шифрованием и другими опциями. Рассмотрим самые важные.
type — тип транспорта. Возможные значения:
tcp— обычный TCP стандартный вариант.ws— WebSocket, часто используется для маскировки под веб-трафик.grpc— gRPC, удобен для обхода блокировок в некоторых сетях.h2— HTTP/2 (менее распространён).
security — уровень шифрования:
none— без дополнительного шифрования.tls— стандартный TLS.reality— современная технология, маскирующаяся под реальный сайт.xtls— устаревший, но ещё встречается.
flow — управление потоком (Flow Control). Для REALITY обычно указывается xtls-rprx-vision или xtls-rprx-vision-udp443. Для обычного TCP может быть xtls-rprx-direct.
Параметры, зависящие от типа транспорта:
- Для
wsважно указатьpath(путь WebSocket, например/vless) иhost(домен для Host-заголовка). Эти параметры передаются как&path=%2Fvlessи&host=example.com. - Для
grpcнуженserviceName— имя службы, например&serviceName=grpc.
Также встречаются параметры sni (SNI для TLS), alpn (список поддерживаемых протоколов), fp (отпечаток браузера для REALITY), pbk и sid (публичный ключ и короткий ID для REALITY). В v2rayN они автоматически подставляются при импорте, но при ручном редактировании ссылки их нужно сохранять точно.
Пример ссылки и импорт в v2rayN
Возьмём вымышленный сервер с WebSocket и TLS. Полная ссылка будет выглядеть так:
vless://6a4f4f2a-3b7d-4e1c-9f3e-1a2b3c4d5e6f@example.com:443?type=ws&security=tls&path=%2Fvless&host=example.com&flow=xtls-rprx-vision#Мой сервер
Разделим её на части:
6a4f4f2a-…— UUID.example.com— адрес сервера.443— порт.type=ws— WebSocket транспорт.security=tls— включён TLS.path=%2Fvless— URL-кодированный путь/vless.host=example.com— домен для Host-заголовка.#Мой сервер— метка, отображаемая в списке.
Чтобы импортировать ссылку в v2rayN:
- Скопируйте ссылку в буфер обмена.
- Откройте v2rayN и нажмите на иконку «Сервер» (или выберите пункт меню «Импорт из буфера обмена»).
- Приложение автоматически распознает ссылку и добавит новый сервер.
- Проверьте параметры в окне редактирования (можно открыть двойным кликом по серверу).
Если вы используете v2rayN версии новее, чем 6.x, интерфейс может немного отличаться, но принцип остаётся тем же. Всегда актуальные версии и инструкции ищите на официальном сайте проекта.
Частые ошибки и проверка
При ручном редактировании или генерации ссылок легко ошибиться. Вот типичные проблемы:
- Пропущен символ
@или#— ссылка не распознается. - Неверный UUID — сервер отклоняет подключение.
- Параметры
pathиhostне закодированы (например, пробелы в URL). - Несоответствие настроек транспорта (например, указан
ws, а на сервереtcp).
Перед использованием проверьте ссылку в любом онлайн-декодере URL или в редакторе v2rayN — там все параметры отображаются отдельными полями. Убедитесь, что значения совпадают с теми, что заданы на сервере.
Владея форматом vless://, вы сможете без труда импортировать конфигурации, изменять их под свои нужды и делиться с другими. А v2rayN делает работу с такими ссылками максимально простой.
Мини-чеклист
- Проверить, что в ссылке присутствует UUID до символа @
- Убедиться, что адрес хоста и порт указаны правильно
- Сравнить параметры type, security, flow с настройками сервера
- Проверить URL-кодирование специальных символов в path, host, serviceName
- После импорта в v2rayN открыть редактор сервера и сверить все поля
- Протестировать подключение, используя кнопку «Проверить задержку» в v2rayN
Частые ошибки
- Забывают экранировать символ '/' в path — вместо %2F пишут '/', что ломает ссылку
- Путают параметр host (для Host-заголовка) с адресом сервера в основной части ссылки
- Указывают security=tls, но не задают sni, из-за чего TLS-проверка не проходит
- Используют flow=xtls-rprx-vision с неподходящим транспортом, например с gRPC
- Копируют ссылку с лишним пробелом или переносом строки, из-за чего v2rayN её не видит
Источники и документация
FAQ
Что делать, если v2rayN не импортирует ссылку vless://?
Во-первых, проверьте, что ссылка скопирована полностью и без лишних символов. Во-вторых, убедитесь, что формат соответствует схеме: vless://UUID@host:port?query#remark. Иногда проблема возникает из-за старой версии v2rayN — обновите приложение до актуальной версии с официального сайта.
Какие параметры обязательны в ссылке vless://?
Обязательны только UUID, host и port. Все остальные параметры (type, security, flow и т.д.) опциональны, но сервер может требовать их для корректного подключения. Рекомендуется всегда указывать type и security, так как они влияют на транспорт.
Можно ли использовать ссылку vless:// для настройки других клиентов, кроме v2rayN?
Да, формат универсален. Его поддерживают v2rayNG (Android), V2Box (iOS), Qv2ray, Nekoray и другие клиенты. Однако интерпретация некоторых параметров может немного отличаться, поэтому всегда сверяйтесь с документацией конкретного клиента.
Хотите перейти сразу к рабочему доступу?
Если сценарий уже ясен и не хочется проходить все шаги вручную, оформите доступ и проверьте подключение на своем устройстве.
Получить доступ