todo/xray/vless.md
loop-uh 9ff5d8ee4e
Some checks failed
Published content check / validate (push) Failing after 10s
Xray: добавлена статья о протоколе VLESS по исходному коду ядра 26.11.9
Новая заметка xray-core/vless-protocol: байты заголовка запроса и ответа, команды TCP, UDP, Mux и Rvs, XUDP, идентификация по UUID, fallbacks, Vision, обратный прокси, VLESS Encryption, проверки конфигурации и тексты ошибок. Факты сверены с кодом двумя кругами независимых проверок. Ссылки добавлены в оглавление xray-core и в «См. также» заметки xray/vless.

В навык vault-note записано стоящее решение владелицы от 19 ноября 2026: коммит, заливка на зеркало Obsidian Publish и пост для Telegram делаются без вопросов.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-19 18:48:28 +03:00

176 lines
28 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

---
date: 2026-07-17
tags:
- xray
- vless
- xtls
- reality
- protocol
- censorship
aliases:
- VLESS
- Протокол VLESS
- VLESS protocol
link: https://xtls.github.io/en/development/protocols/vless.html
description: "Устройство протокола VLESS: формат заголовка, поле flow и XTLS-Vision, fallbacks, XUDP и пост-квантовое шифрование в Xray-core."
---
> [!mirror] Резервное зеркало
> Актуальная версия этой страницы — на основной вики: [wiki2.zapret.moe/xray/vless](https://otukcszfwr.zapret.moe/xray/vless)
# 🔷 Протокол VLESS: устройство и возможности
> [!info] О чём заметка
> Подробный разбор **протокола VLESS** — прокси-протокола ядра [[xray/project-x|Xray-core]], на котором сегодня строится большинство серверов обхода блокировок. Здесь — как устроен протокол на уровне байтов, что умеет поле `flow`, зачем нужны fallbacks, XUDP и новое встроенное пост-квантовое шифрование. История самого проекта и технологий REALITY/XTLS — в обзорной заметке [[xray/project-x|Project X (Xray-core)]]; как современный DPI детектит связку VLESS+REALITY — в [[VLESS/dpi-tls-june-2026|разборе схемы ограничений июня 2026]].
## TL;DR
- **VLESS** — облегчённый (stateless) прокси-протокол, преемник **VMess**. Придуман разработчиком RPRX внутри проекта [[xray/project-x|Project X]].
- **Это прокси, а не VPN.** VLESS переносит отдельные соединения («соедини меня с `youtube.com:443`»), а не IP-пакеты, и виртуальный сетевой интерфейс ему не нужен: хватает локального SOCKS5 на `127.0.0.1`. TUN-адаптер — это отдельный механизм перехвата поверх протокола, тот самый «режим VPN» из интерфейсов: у Xray-core для него с января 2026 есть собственный инбаунд `"protocol": "tun"`, а на мобильных интерфейс создаёт система и передаёт ядру. Разбор различия и его практических следствий — в [[protocols/00-overview|обзоре протоколов]].
- Ключевая идея: **сам протокол ничего не шифрует и не маскирует**. Аутентификация — по одному UUID, а конфиденциальность делегируется внешнему слою (TLS, [[xray/reality|REALITY]]) и flow-контролю ([[xray/xtls-vision|XTLS-Vision]]).
- Убрана времязависимая аутентификация VMess: не нужна синхронизация часов, протокол проще и быстрее.
- Умеет **flow** (`xtls-rprx-vision` против детекта TLS-in-TLS), **fallbacks** (маскировка под настоящий сайт и защита от зондирования), **XUDP** (полноценный UDP с Full Cone NAT), работает поверх TCP/XHTTP/WebSocket/gRPC/mKCP.
- С сентября 2025 (релиз v25.9.5) у VLESS появилось **собственное пост-квантовое шифрование** (ML-KEM-768 + X25519) — оно снимает жёсткое требование внешнего TLS и защищает от расшифровки «сейчас запишем — потом расшифруем».
## Что такое VLESS и чем он отличается от VMess
VLESS расшифровывается неформально как «VMess Less» — «VMess без лишнего». Это прокси-протокол прикладного уровня: он только аутентифицирует клиента и сообщает серверу, куда переслать трафик. Шифрование, маскировку под легитимный трафик и обход DPI дают другие части конфига: `streamSettings` (транспорт и слой безопасности `security`) и поле `encryption` самого VLESS. Словарь терминов — в [[xray-core/vless-stack-map|карте слоёв]].
У предшественника, **VMess**, был собственный жёсткий криптографический контур с проверкой времени: клиент и сервер должны были иметь синхронизированные часы (расхождение более ±120 секунд в AEAD-режиме ломало соединение; в удалённом старом режиме допуск был ±90 секунд), плюс отдельная «аутентификация ответа». Это усложняло протокол и создавало проблемы на устройствах с плывущими часами.
VLESS от этого отказался. Вместо временной метки — простое поле версии в начале запроса, вместо встроенного шифрования — расчёт на внешний TLS/REALITY.
Проще говоря: VMess пытался быть «самодостаточной крепостью» со своим шифрованием и часами, а VLESS — это лёгкий «скелет», который сознательно отдаёт защиту специализированным слоям, которые делают её лучше (настоящий TLS 1.3 неотличим от обычного HTTPS, а собственное шифрование VMess — нет).
## Формат протокола на уровне байтов
Разбор основан на [dev-документации VLESS](https://xtls.github.io/en/development/protocols/vless.html) и коде `proxy/vless/encoding` в [Xray-core](https://github.com/XTLS/Xray-core/tree/main/proxy/vless/encoding).
Заголовок **запроса** идёт последовательно:
| Поле | Размер | Что это |
|---|---|---|
| Version | 1 байт | Версия протокола. Сейчас всегда `0`: в коде `Version = byte(0)` (так и в v25.9.5, и в v26.11.9), а сервер принимает только `0` и отвечает на любое другое значение ошибкой `invalid request version` |
| UUID | 16 байт | Идентификатор пользователя; сервер сверяет его при каждом соединении |
| Addons Length + Addons | 1 байт + N | Protobuf-данные переменной длины; несут, в частности, значение `flow`. Если addons не нужны — длина 0, накладных расходов нет |
| Command | 1 байт | Команда: `0x01` TCP, `0x02` UDP, `0x03` MUX, `0x04` обратный прокси (reverse). Для MUX и reverse порт и адрес в заголовок не пишутся: вместо них ядро подставляет служебные имена `v1.mux.cool` и `v1.rvs.cool` |
| Port | 2 байта | Порт назначения |
| Address Type + Address | 1 байт + N | Тип адреса (IPv4 / домен / IPv6) и сам адрес |
Заголовок **ответа** минимален: версия (совпадает с запросом), затем Addons и данные.
> [!note] Почему это важно для маскировки
> Заголовок VLESS предельно компактен и не содержит ничего криптографически «шумного» — никаких временных меток или хешей, выдающих протокол. Всё, что видит DPI снаружи, — это уже обёрнутый TLS/REALITY-трафик. Сам заголовок VLESS появляется только *внутри* зашифрованного канала, где его не видно.
## Поле flow: XTLS-Vision против детекта TLS-in-TLS
`flow` — поле в addons, которое включает режим XTLS flow-control. Именно оно решает проблему двойного шифрования «TLS внутри TLS» (подробный разбор самой идеи XTLS, механики паддинга/splice и разграничения терминов — в заметке [[xray/xtls-vision|XTLS и Vision]]).
Актуальные значения ([config outbounds/vless](https://xtls.github.io/en/config/outbounds/vless.html)):
- **пусто / нет поля** — обычное проксирование через TLS без XTLS. Простое и совместимое, но паттерн «TLS-in-TLS» детектируем.
- **`xtls-rprx-vision`** — текущий рекомендуемый режим. Добавляет случайный паддинг во внутреннее рукопожатие (inner handshake random padding), размывая характерные длины TLS-записей вложенного соединения. Дополнительно клиент отклоняет UDP на порт 443 (QUIC; исключение — значение `xtls-rprx-vision-udp443`), заставляя браузер откатываться на HTTPS поверх TCP, где Vision может включить прямое копирование (splice).
- **`xtls-rprx-vision-udp443`** — то же самое, но **без** перехвата UDP 443: QUIC пропускается как есть.
> [!warning] Старые значения flow удалены
> Ранние режимы `xtls-rprx-origin`, `xtls-rprx-direct`, `xtls-rprx-splice` **устарели и удалены**. В версии 1.7.5 они выдавали предупреждение, а в 1.8.0 были удалены. Современный Xray-core при загрузке конфига со старым flow падает с ошибкой `VLESS users: "flow" doesn't support "<значение>" in this version`. Точную привязку к версиям стоит сверять по [Releases](https://github.com/XTLS/Xray-core/releases). Механизм `splice` (zero-copy передача через ядро Linux) при этом никуда не делся — он остался внутренней оптимизацией Vision, а не отдельным значением flow.
XTLS-Vision доступен в двух случаях: когда ядро получает соединение как TLS или [[xray/reality|REALITY]] напрямую (это транспорт RAW с TLS или REALITY, по коду также mKCP с TLS, но без splice; внешний TLS должен быть версии 1.3), и тогда для TLS 1.3 он умеет напрямую копировать уже зашифрованные данные без повторного шифрования — либо при включённом [[xray/vless-encryption|VLESS Encryption]], и тогда ограничений на нижележащий транспорт почти нет: подходит любой транспорт, доступный VLESS, кроме `xdrive`, где `flow` запрещён. Сводная матрица «какая комбинация транспорта, `security`, `flow` и `encryption` работает» — в [[xray-core/vless-stack-map|карте слоёв VLESS-стека]].
## Fallbacks: маскировка под настоящий сайт
**Fallback** — механизм VLESS inbound, который перенаправляет «неправильный» трафик на другое назначение (обычно на настоящий веб-сервер вроде nginx). Сопоставление по `name` и `alpn` берётся из TLS или REALITY (без них оба значения пусты); официальная документация описывает механизм для связки TCP+TLS. Источник: [features/fallback](https://xtls.github.io/en/config/features/fallback.html).
Зачем это нужно:
- **Защита от активного зондирования (active probing).** Цензор отправляет на подозрительный сервер обычный HTTP/TLS-запрос, чтобы проверить, прокси это или нет. Без fallback такой запрос ни на что не похож; с fallback он уходит на реальный сайт, и зонд получает нормальную веб-страницу — сервер выглядит как обычный HTTPS-хост.
- **Разделение одного порта.** На 443-м порту одновременно живут и прокси, и настоящий сайт.
Xray «подглядывает» первый пакет и выбирает наиболее точное правило `FallbackObject` по полям: `name` (сопоставление с TLS SNI), `alpn` (фактически согласованный ALPN), `path` (HTTP PATH, должен начинаться с `/`), `dest` (куда переслать), `xver` (отправлять ли PROXY protocol, чтобы бэкенд видел реальный IP клиента). Правило выбирается по точности совпадения, а не по порядку в конфиге.
> [!warning] Fallbacks несовместимы с новым шифрованием
> `fallbacks` нельзя использовать одновременно с `decryption`, отличным от `none`, то есть с включённым [[xray/vless-encryption|VLESS Encryption]] (см. ниже) — придётся выбрать что-то одно. Само по себе `"decryption": "none"` с `fallbacks` сочетается нормально. Причём это не мягкая деградация: конфиг не проходит сборку с ошибкой `VLESS settings: "fallbacks" can not be used together with "decryption"`, и Xray **не запускается вообще** — вместе с ним падают все остальные входы из этого файла.
## Транспорты и слой безопасности
VLESS — это только логика протокола; байты он отдаёт транспорту (`streamSettings.method`, прежнее имя `network`, в ссылке `vless://` параметр `type`):
- **TCP (RAW)** — базовый транспорт; единственный, где XTLS-Vision получает ядерный `splice`. Без [[xray/vless-encryption|VLESS Encryption]] Vision работает поверх RAW с TLS или REALITY (по коду проверка проходит и на mKCP с TLS, но без `splice`).
- **[[xray/xhttp|XHTTP]]** (прежнее название SplitHTTP) — HTTP-транспорт, дружит с CDN; в режиме `stream-one` заменил убранные из ядра транспорты `h2`/`http` и `quic`.
- **WebSocket (ws)** — совместим с CDN и обычными веб-серверами; при запуске ядро предупреждает, что транспорт устарел, и советует XHTTP.
- **gRPC** — параметр `serviceName`; при запуске ядро предупреждает об устаревании и советует XHTTP.
- **mKCP (kcp)** — надёжная передача (ARQ) поверх UDP, без FEC.
- **HTTPUpgrade** — лёгкий транспорт на HTTP-Upgrade; ядро тоже предупреждает об устаревании.
Слой безопасности (`security`): **`none`**, **`tls`** или **`reality`**. На практике VLESS почти всегда используют с `tls` или `reality`. С июля 2026 (впервые в пре-релизе v26.7.11, в стабильных версиях с 26.10.21) значение `none` перестало быть просто нежелательным и стало **ошибкой конфигурации на стороне клиента**: ядро отказывается собирать исходящее соединение с сообщением `vless without TLS or other encryption is prohibited unless the server address is a private IP or domain`. Серверный вход с такой схемой пока стартует. Снять запрет можно двумя способами — приватный адрес сервера (IP или домен) либо включённое [[xray/vless-encryption|VLESS Encryption]].
## XUDP и Mux.Cool: полноценный UDP
По умолчанию проксировать UDP (игры, звонки, P2P) сложно из-за NAT. **XUDP** — расширение мультиплексора Mux.Cool, которое даёт **Full Cone NAT** поверх VLESS. Источники: [Discussion #252](https://github.com/XTLS/Xray-core/discussions/252), [Mux.Cool spec](https://xtls.github.io/en/development/protocols/muxcool.html).
- XUDP появился в **Xray-core v1.3.0**: агрегирует UDP-потоки в туннель и переносит адрес/порт внутри Mux-фрейма. При v1.3.0+ на обоих концах VLESS по умолчанию работает в режиме Full Cone через публичный IP сервера, независимо от локального NAT клиента.
- **Global ID / настоящий Full Cone** (примерно с v1.8.1): даже после разрыва TCP (например при смене сети) сервер сохраняет тот же исходящий порт для UDP-источника — критично для P2P-приложений.
- **UDP 443 (QUIC):** параметр `xudpProxyUDP443` (`skip`/`allow`/`reject`) управляет судьбой QUIC-трафика. Часто его намеренно не пускают в туннель — Vision вынуждает браузер использовать HTTPS поверх TCP, что уменьшает утечки и нагрузку.
Проще говоря: без XUDP UDP-приложения за прокси часто ломались из-за строгого NAT; XUDP делает так, что все они видят «открытый» интернет через публичный IP сервера.
## VLESS Encryption: встроенное пост-квантовое шифрование (2025)
Долгое время у VLESS не было **никакого** собственного шифрования — только внешний TLS/REALITY. Это изменил **VLESS Encryption**, добавленный в [PR #5067](https://github.com/XTLS/Xray-core/pull/5067) (автор RPRX, влит 28 августа 2025) и вышедший в стабильном релизе **Xray-core v25.9.5** от 5 сентября 2025. Полный разбор — формат строки параметра, криптография, режимы внешнего вида, совместимость клиентов и польза против блокировок — в отдельной заметке [[xray/vless-encryption|VLESS Encryption]]. Здесь только суть.
- **Собственное шифрование без внешнего TLS.** VLESS может работать при `security: none`, сохраняя конфиденциальность и forward secrecy. Метод называется `mlkem768x25519plus`, задаётся полем `decryption` на сервере и `encryption` на клиенте, генерируется командой `xray vlessenc`.
- **Пост-квантовая стойкость.** Эфемерный обмен ключами — гибрид **ML-KEM-768** (пост-квантовый механизм инкапсуляции ключа) **и X25519**; аутентификация сервера отдельным ключом, на выбор X25519 или ML-KEM-768. Это защита от атаки «harvest now, decrypt later» («сейчас запишем — потом расшифруем»).
- **Снимает ограничение Vision на транспорт.** С VLESS Encryption `flow=xtls-rprx-vision` работает поверх [[xray/xhttp|XHTTP]], WebSocket, gRPC и других транспортов, доступных VLESS (кроме `xdrive`), а не только на прямом TCP.
- **Главный сценарий — посредник.** Через CDN и транзитные узлы внешний TLS терминируется не на вашем сервере, и открытый заголовок VLESS (UUID, адрес назначения) виден посреднику. Внутреннее шифрование это закрывает.
> [!warning] Оговорки, о которые спотыкаются на практике
> Автор прямо пишет, что VLESS Encryption **не предназначен для прямого обхода цензуры**: собственный внешний вид у него есть (`native`, `xorpub`, `random` плюс настраиваемая набивка), но лежит он внутри туннеля, поэтому наблюдателю снаружи виден внешний слой — для маскировки нужны REALITY, XHTTP и Vision. Кроме того: `decryption` несовместим с `fallbacks` (Xray вообще не стартует), ядро **sing-box** этот механизм не поддерживает (то есть Hiddify, NekoBox for Android, Karing), а старые клиенты после серверной миграции обрываются или зависают без внятной ошибки.
## Формат ссылок vless://
Стандарт share-ссылок ([Discussion #716](https://github.com/XTLS/Xray-core/discussions/716)):
```
vless://<uuid>@<host>:<port>?<параметры>#<название>
```
Значения параметров URL-кодируются. Ключевые параметры:
- `type` — транспорт: `tcp` (в ядре он же `raw`), `kcp`, `ws`, `grpc`, `httpupgrade`, `xhttp`. Значение `http` (HTTP/2) ядро 26.11.9 отвергает: этот транспорт убран.
- `security` — `none` / `tls` / `reality`.
- `encryption` — по умолчанию `none`; может нести `mlkem768x25519plus...`.
- `flow` — например `xtls-rprx-vision`.
- REALITY/TLS: `sni`, `fp` (fingerprint, по умолчанию `chrome`), `pbk` (публичный ключ REALITY, обязателен), `sid` (short ID).
- Транспортные: `path`, `host`, `serviceName`.
## Ограничения и критика
> [!warning] Что стоит держать в голове
> - **Без внешнего TLS/REALITY (или без [[xray/vless-encryption|VLESS Encryption]]) трафик уязвим** — «голый» VLESS ничего не шифрует. С июля 2026 ядро прямо запрещает такую конфигурацию на публичный адрес.
> - **UUID — единственная аутентификация**, статичная и без временной метки. При утечке UUID доступ получает кто угодно; защита от повторов (anti-replay) есть только в 0-RTT-режиме нового VLESS Encryption, но не в базовом протоколе.
> - **Устойчивость к DPI зависит от обвязки, а не от протокола.** Неправильная связка (без Vision, без REALITY) детектируется по TLS-паттернам — см. [[VLESS/dpi-tls-june-2026|разбор DPI-эвристик июня 2026]].
> - **Историческая путаница с flow.** Быстро устаревавшие `origin`/`direct`/`splice` → `vision` создавали проблемы совместимости конфигов между версиями Xray.
## 📚 См. также
- [[xray-core/vless-protocol|Протокол VLESS в ядре: по исходному коду]] — байты заголовка и ответа, команды, fallbacks, XUDP, реверс-прокси, шифрование, проверки конфигурации и тексты ошибок по коду v26.11.9
- [[xray/vless-encryption|VLESS Encryption]] — подробный разбор встроенного пост-квантового шифрования: строка параметра, криптография, миграция, польза против блокировок
- [[xray-core/vless-stack-map|Словарь и карта слоёв]] — матрица «что с чем работает»: транспорт, `security`, `flow`, `encryption` и когда включается splice
- [[xray/project-x|Project X (Xray-core)]] — история проекта, XTLS, REALITY, экосистема
- [[xray/xtls-vision|XTLS и Vision]] — что такое поле `flow` и чем XTLS отличается от VLESS/REALITY
- [[xray/reality|REALITY]] — слой безопасности, маскировка под чужой сайт
- [[xray/xhttp|XHTTP]] — транспорт через CDN
- [[xray-core/components|Компоненты Xray-core]] — где в ядре живёт VLESS и как он встроен в цепочку «входящий → диспетчер → исходящий»
- [[xray-core/changes-26-11-9|Что нового в Xray-core 26.11.9]] — запрет VLESS без шифрования, новые значения по умолчанию
- [[xray/clients-and-routing|Клиенты и маршрутизация]] — как подключиться клиентом и развести трафик
- [[VLESS/dpi-tls-june-2026|DPI TLS heuristics 2026]] — как DPI детектит VLESS+REALITY поведенчески
- [[protocols/vmess|VMess]] — предшественник VLESS: `alterId`, режим AEAD и почему от собственного шифрования отказались
- [[protocols/00-overview|Обзор протоколов]] — карта: какой протокол какую задачу решает и какое ядро его поддерживает
- [[VLESS-SOCKS5-vulnerability]] и [[VLESS-localhost-protection-guide]] — риски неправильной настройки
- 🔗 [Спецификация VLESS (dev docs)](https://xtls.github.io/en/development/protocols/vless.html) — первоисточник формата
- 🔗 [config: inbounds/vless](https://xtls.github.io/en/config/inbounds/vless.html) · [outbounds/vless](https://xtls.github.io/en/config/outbounds/vless.html) — справка по конфигу
- 🔗 [VLESS Encryption](https://xraycore.org/en/misc/vless-encryption/) — пост-квантовое шифрование
---
> [!quote] 🤖 Эти статьи открыты — можно обучать на них ИИ
> При желании вы можете натренировать ИИ на наших статьях. Исходное форматирование и скачивание всего репозитория одним zip-архивом доступны в Forgejo: [исходник этой заметки](https://iianajhlkh.zapret.moe/zapretdiscordyoutube/todo/src/branch/main/xray/vless.md) · [весь репозиторий](https://iianajhlkh.zapret.moe/zapretdiscordyoutube/todo/src/branch/main).