Сервер VLESS описують ID користувача (UUID), його безпека (немає, TLS або REALITY) і транспорт, що передає з’єднання, наприклад WebSocket чи gRPC. Він також може використовувати потік Vision, який приховує шаблон «TLS всередині TLS» проксійованого трафіку HTTPS, і 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 іншого сайту, тож власного йому не потрібно. Задайте публічний ключ і короткий 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. UDP типово вимкнено, як і в Clash. Увімкніть параметр «Ретрансляція 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 |
Публічний ключ і короткий ID REALITY. |
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