Сервер VLESS описывается ID пользователя (UUID), безопасностью (нет, TLS или REALITY) и транспортом, который несет соединение, например WebSocket или gRPC. Он также может использовать поток Vision, который скрывает характерный для проксируемого HTTPS-трафика узор «TLS внутри TLS», и VLESS Encryption — постквантовый слой шифрования Xray. Potatso подключается к серверу, если поддерживает все эти настройки. Используйте таблицы ниже, чтобы проверить настройки своего сервера, показанные провайдером или в его ссылке vless://.
Сервер VLESS можно добавить вручную, с помощью ссылки vless:// или импортом:
- подписки Clash или Mihomo,
- конфигурации Xray или V2Ray.
Potatso пока не импортирует серверы VLESS из конфигурации sing-box. Используйте вместо этого ссылку vless:// сервера.
Каждая поддерживаемая ниже настройка проверена на настоящих серверах Xray и sing-box.
ID пользователя
ID пользователя обычно представляет собой UUID, например 3971e1b2-18a3-4f83-8fa6-bf9b142ee258. Серверы Xray также принимают в качестве ID любой другой текст до 30 символов и превращают его в UUID так же, как это делают все клиенты. Potatso тоже, поэтому используйте ID точно таким, как его дает провайдер.
Транспорты
| Транспорт | type в ссылке |
Поддержка | Проверен с |
|---|---|---|---|
| Без транспорта (чистый TCP) | tcp, raw или отсутствует |
✅ | Xray, sing-box |
| WebSocket | ws |
✅ С ранними данными и без них | Xray, sing-box |
| gRPC | grpc |
✅ | Xray, sing-box |
| HTTP Upgrade | httpupgrade |
✅ | Xray, sing-box |
| XHTTP | xhttp, splithttp |
✅ В режимах stream-one и auto |
Xray |
| HTTP/2 | http или h2 |
✅ | sing-box |
| mKCP | kcp |
❌ | |
| QUIC | quic |
❌ | |
| TCP с обфускацией HTTP-заголовка | tcp с headerType=http |
❌ |
Каждый транспорт работает с TLS и без него, а также с UDP. Potatso не импортирует сервер с неподдерживаемым транспортом.
Xray больше не предлагает HTTP/2 и QUIC: серверы Xray, которые их использовали, теперь используют XHTTP.
XHTTP
У XHTTP (прежде SplitHTTP) несколько режимов. Potatso отправляет все соединение как один HTTP-запрос (stream-one). Сервер Xray принимает его в режиме auto по умолчанию, а также в режимах stream-one и stream-up, поэтому ссылка с mode=auto или без режима работает.
Potatso не поддерживает клиентские режимы packet-up и stream-up и не импортирует ссылку, которая их запрашивает. Параметр extra ссылки XHTTP не поддерживается: Potatso его игнорирует. Potatso изменяет серверы XHTTP с TLS или REALITY; импортированный сервер XHTTP без TLS по-прежнему работает.
Безопасность
| Безопасность | security в ссылке |
Поддержка |
|---|---|---|
| Нет | none или отсутствует |
✅ Ваш трафик не шифруется, если сервер не использует VLESS Encryption. |
| TLS | tls |
✅ |
| REALITY | reality |
✅ Без транспорта, с gRPC или XHTTP |
Настройки TLS
| Настройка | Ключ Clash | Параметр ссылки | Поддержка |
|---|---|---|---|
| Имя сервера (SNI) | servername |
sni |
✅ Если не задано, Potatso использует адрес сервера. |
| ALPN | alpn |
alpn |
✅ Если не задан, Potatso отправляет http/1.1 для WebSocket, h2 для gRPC, HTTP/2 и XHTTP и ничего для остальных. |
| Не проверять сертификат | skip-cert-verify |
allowInsecure, insecure |
✅ |
| Закрепление сертификата (SHA-256) | fingerprint |
pcs |
✅ Один сертификат |
| Проверка сертификата для другого имени | vcn |
❌ Potatso проверяет сертификат по имени сервера. | |
| Отпечаток браузера | client-fingerprint |
fp |
✅ chrome, firefox, safari, ios, android, edge и random. Другие названия подключаются с рукопожатием по умолчанию. |
| Encrypted Client Hello (ECH) | ech-opts |
ech |
✅ С конфигурацией ECH в ссылке или подписке |
| Свой сертификат CA | ❌ | ||
| Клиентский сертификат TLS | certificate, private-key |
❌ |
Отключение проверки сертификата позволяет любому между вами и сервером читать ваш трафик. Если сервер использует самоподписанный сертификат, лучше закрепите его: укажите SHA-256 сертификата как закрепление сертификата. Potatso закрепляет один сертификат; он не импортирует ссылку, в которой в pcs перечислено несколько.
Отпечаток браузера делает TLS-рукопожатие соединения похожим на рукопожатие этого браузера. Он не меняет того, что должен поддерживать сервер.
REALITY
Сервер REALITY заимствует TLS-сертификат другого сайта, поэтому собственный сертификат ему не нужен. Укажите открытый ключ и short ID сервера так, как их дает провайдер, а в качестве имени сервера — сайт, у которого сервер заимствует сертификат. Параметр spx (путь паука) из ссылки для подключения не нужен, и Potatso его игнорирует.
REALITY требует отпечаток браузера: если в вашей ссылке или настройках его нет, Potatso использует chrome. С REALITY android и неизвестные Potatso названия тоже подключаются как chrome.
REALITY работает без транспорта, с gRPC и XHTTP.
Поток Vision
| Поток | flow в ссылке |
Поддержка |
|---|---|---|
| Нет | отсутствует | ✅ |
| Vision | xtls-rprx-vision |
✅ |
| Vision, UDP 443 разрешен | xtls-rprx-vision-udp443 |
✅ |
xtls-rprx-direct, xtls-rprx-splice и другие старые потоки XTLS |
❌ Xray их удалил |
Vision работает только без транспорта и с TLS или REALITY: Potatso не сохраняет и не импортирует сервер Vision с другим транспортом или без TLS. Он также работает с VLESS Encryption поверх TLS.
С Vision UDP передается так, как его передает Xray, — через Mux.Cool, который принимают и серверы Xray, и серверы sing-box. Собственный клиент Xray отказывается передавать UDP на порт 443 (QUIC) с xtls-rprx-vision, чтобы браузеры переключались на TCP; Potatso передает его с обоими потоками.
VLESS Encryption
VLESS Encryption (mlkem768x25519plus) — это постквантовый слой шифрования Xray: обмен ключами ML-KEM-768 и X25519 под соединением VLESS. У настройки сервера decryption есть соответствующее значение encryption для клиентов, которое выглядит так:
mlkem768x25519plus.native.0rtt.<key>| Настройка | Поддержка |
|---|---|
Режимы native, xorpub и random |
✅ |
1rtt и 0rtt (возобновленные соединения) |
✅ |
| Сервер аутентифицируется ключом X25519 или ML-KEM-768 | ✅ |
| Без транспорта и без TLS | ✅ |
| Поверх TLS | ✅ Также с Vision |
| Vision без TLS | ❌ |
Potatso сохраняет значение encryption из ссылки, подписки Clash или конфигурации Xray. Ввести его в настройках сервера пока нельзя.
Мультиплексирование
Potatso может пропускать несколько соединений через одно соединение VLESS, что задается параметром smux в подписке Clash:
| Протокол | smux.protocol в Clash |
Серверы | Поддержка |
|---|---|---|---|
| Mux.Cool (Xray) | muxcool |
Xray, sing-box | ✅ TCP и UDP |
| Мультиплексирование sing-box | smux, yamux, h2mux |
sing-box с включенным мультиплексированием | ✅ TCP и UDP, с заполнением и без него |
С Vision Mux.Cool передает только UDP, а каждое соединение TCP сохраняет собственное соединение, как в Xray. Мультиплексирование sing-box с Vision не работает, и Potatso не импортирует сервер Vision, который его запрашивает.
Параметры mux Xray из конфигурации Xray не импортируются.
UDP
VLESS передает UDP по тому же соединению, что и TCP. Как и в Clash, UDP по умолчанию выключен. Включите «Ретрансляция UDP» в настройках сервера, если ваш сервер ретранслирует UDP: Xray и sing-box это делают. В подписке Clash он включается параметром udp: true.
Каждый поток UDP получает собственное соединение с сервером, а каждое назначение — собственный поток. Potatso не поддерживает XUDP и packetaddr (packetEncoding в ссылке, packet-encoding или xudp в подписке): серверы принимают UDP от Potatso и без них, а Potatso игнорирует эту настройку.
Поддержка возможностей
| Возможность | Поддержка |
|---|---|
| Протокол VLESS версии 0: команды TCP и UDP | ✅ |
| UUID и текстовые ID пользователей | ✅ |
| Несколько пользователей на одном сервере | ✅ У каждого свой ID |
Поток Vision (xtls-rprx-vision, -udp443) |
✅ См. Vision |
VLESS Encryption (mlkem768x25519plus) |
✅ См. VLESS Encryption |
| TLS, REALITY, ECH, закрепление сертификата, отпечатки браузеров | ✅ См. Безопасность |
| Транспорты WebSocket, gRPC, HTTP Upgrade, HTTP/2 | ✅ См. Транспорты |
| XHTTP | Режимы stream-one и auto |
| mKCP, QUIC, обфускация HTTP-заголовка TCP | ❌ |
| Mux.Cool | ✅ |
| XUDP, packetaddr | ❌ UDP использует обычную команду UDP |
| Мультиплексирование sing-box (smux, yamux, h2mux) | ✅ |
Обратный прокси (VLESS reverse) |
❌ Это возможность сервера |
Ссылки vless:// (стандарт ссылок Xray) |
✅ |
Ссылки vless://
Ссылка vless:// содержит весь сервер в одной строке:
vless://id@host:port?type=…&security=…&…#name| Часть | Описание |
|---|---|
id |
ID пользователя. |
host |
Адрес сервера. Адрес IPv6 заключайте в квадратные скобки, например [2001:db8::1]. |
port |
Порт сервера. |
encryption |
none или значение VLESS Encryption. |
flow |
Необязательный. xtls-rprx-vision или xtls-rprx-vision-udp443. |
type |
Транспорт. |
security |
none, tls или reality. |
sni, alpn, fp, pcs, ech, allowInsecure |
Настройки TLS. |
pbk, sid |
Открытый ключ REALITY и short ID. |
host, path |
Заголовок Host и путь для WebSocket, HTTP Upgrade, HTTP/2 и XHTTP. Путь WebSocket может нести ранние данные в виде ?ed=2048. |
serviceName |
Имя сервиса gRPC. |
mode |
Режим XHTTP. |
name |
Необязательный. Название сервера в Potatso. |
Когда Potatso делится сервером VLESS, он записывает ссылку в этой форме.
Примеры
В каждом примере показана ссылка для импорта. ID пользователя — 3971e1b2-18a3-4f83-8fa6-bf9b142ee258.
TLS без транспорта:
vless://3971e1b2-18a3-4f83-8fa6-bf9b142ee258@vless.example.com:443?security=tls&sni=vless.example.com&type=tcp#TLSREALITY с Vision, заимствование www.example.com:
vless://3971e1b2-18a3-4f83-8fa6-bf9b142ee258@vless.example.com:443?security=reality&sni=www.example.com&fp=chrome&pbk=Z84J2IelR9ch3k8VtlVhhs5ycBUlXA7wHBWcBrjqnAw&sid=0123abcd&type=tcp&flow=xtls-rprx-vision#REALITY-VisionWebSocket поверх TLS через CDN, с 2048 байтами ранних данных:
vless://3971e1b2-18a3-4f83-8fa6-bf9b142ee258@vless.example.com:443?security=tls&type=ws&host=cdn.example.com&path=%2Fws%3Fed%3D2048#WebSocketgRPC поверх TLS:
vless://3971e1b2-18a3-4f83-8fa6-bf9b142ee258@vless.example.com:443?security=tls&type=grpc&serviceName=gun#gRPCHTTP Upgrade поверх TLS:
vless://3971e1b2-18a3-4f83-8fa6-bf9b142ee258@vless.example.com:443?security=tls&type=httpupgrade&host=cdn.example.com&path=%2Fup#HTTPUpgradeXHTTP поверх TLS:
vless://3971e1b2-18a3-4f83-8fa6-bf9b142ee258@vless.example.com:443?security=tls&type=xhttp&host=cdn.example.com&path=%2Fxh&mode=auto#XHTTPHTTP/2 поверх TLS:
vless://3971e1b2-18a3-4f83-8fa6-bf9b142ee258@vless.example.com:443?security=tls&type=http&host=cdn.example.com&path=%2Fh2#HTTP2VLESS Encryption без TLS:
vless://3971e1b2-18a3-4f83-8fa6-bf9b142ee258@vless.example.com:8443?security=none&encryption=mlkem768x25519plus.native.0rtt.u7dtLE6KgE4mjeBK3oYdNMw6MJB47Ijr_9AG2avwSmY&type=tcp#Encryption