---
title: "VLESS"
description: "Транспорти, потоки, шифрування, параметри TLS, посилання та можливості VLESS, які підтримує Potatso."
---

> Documentation Index
> Fetch the complete documentation index at: https://potatso.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# VLESS

Сервер VLESS описують **ID користувача** (UUID), його **безпека** (немає, TLS або REALITY) і **транспорт**, що передає з’єднання, наприклад WebSocket чи gRPC. Він також може використовувати **потік Vision**, який приховує шаблон «TLS всередині TLS» проксійованого трафіку HTTPS, і **VLESS Encryption** — постквантовий шар шифрування від Xray. Potatso під’єднується до сервера, коли підтримує всі ці параметри. Скористайтеся таблицями нижче, щоб перевірити параметри свого сервера, як їх показує ваш постачальник або вказано в його посиланні `vless://`.

Сервер VLESS можна додати вручну, через [посилання `vless://`](#links) або імпортом:

- підписки Clash чи Mihomo,
- конфігурації Xray чи V2Ray.

Potatso поки не імпортує сервери VLESS із конфігурації sing-box. Натомість використайте посилання `vless://` сервера.

Кожен підтримуваний нижче параметр перевірено на справжніх серверах [Xray](https://github.com/XTLS/Xray-core) і [sing-box](https://sing-box.sagernet.org/).

## ID користувача {#user-id}

ID користувача зазвичай є UUID, наприклад `3971e1b2-18a3-4f83-8fa6-bf9b142ee258`. Сервери Xray також приймають як ID будь-який інший текст до 30 символів і перетворюють його на UUID так само, як це роблять усі клієнти. Potatso теж, тож використовуйте ID точно таким, як його дає ваш постачальник.

## Транспорти {#transports}

| Транспорт | `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) | `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}

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}

| Безпека | `security` у посиланні | Підтримується |
| --- | --- | --- |
| Немає | `none` або нічого | ✅ Ваш трафік не шифрується, якщо сервер не використовує [VLESS Encryption](#encryption). |
| TLS | `tls` | ✅ |
| [REALITY](#reality) | `reality` | ✅ Без транспорту, з gRPC або XHTTP |

### Параметри TLS {#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}

Сервер REALITY позичає сертифікат TLS іншого сайту, тож власного йому не потрібно. Задайте **публічний ключ** і **короткий ID** сервера так, як їх дає ваш постачальник, а назву сервера — як сайт, у якого сервер позичає сертифікат. Параметр `spx` (шлях павука) посилання не потрібен для з’єднання, і Potatso його ігнорує.

REALITY потребує відбитка браузера: якщо у вашому посиланні чи налаштуваннях його немає, Potatso використовує `chrome`. З REALITY `android` і назви, яких Potatso не знає, також під’єднуються як `chrome`.

REALITY працює без транспорту, з gRPC та XHTTP.

## Потік Vision {#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 {#encryption}

VLESS Encryption (`mlkem768x25519plus`) — це постквантовий шар шифрування від Xray: обмін ключами ML-KEM-768 і X25519 під з’єднанням VLESS. Параметр `decryption` сервера має відповідне значення `encryption` для клієнтів, яке виглядає так:

```text
mlkem768x25519plus.native.0rtt.<key>
```

| Параметр | Підтримується |
| --- | --- |
| Режими `native`, `xorpub` і `random` | ✅ |
| `1rtt` і `0rtt` (поновлені з’єднання) | ✅ |
| Сервер, автентифікований ключем X25519 або ML-KEM-768 | ✅ |
| Без транспорту та без TLS | ✅ |
| Поверх TLS | ✅ Також із Vision |
| Vision без TLS | ❌ |

Potatso зберігає значення `encryption` з посилання, підписки Clash чи конфігурації Xray. Ввести його в параметрах сервера поки не можна.

## Мультиплексування {#mux}

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 {#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 ігнорує цей параметр.

## Підтримка можливостей {#features}

| Можливість | Підтримується |
| --- | --- |
| [Протокол VLESS](https://xtls.github.io/en/development/protocols/vless.html) версії 0: команди TCP і UDP | ✅ |
| UUID і текстові ID користувачів | ✅ |
| Кілька користувачів на одному сервері | ✅ Кожен зі своїм ID |
| Потік Vision (`xtls-rprx-vision`, `-udp443`) | ✅ Див. [Vision](#vision) |
| VLESS Encryption (`mlkem768x25519plus`) | ✅ Див. [VLESS Encryption](#encryption) |
| TLS, REALITY, ECH, закріплення сертифіката, відбитки браузера | ✅ Див. [Безпека](#security) |
| Транспорти WebSocket, gRPC, HTTP Upgrade, HTTP/2 | ✅ Див. [Транспорти](#transports) |
| XHTTP | Режими `stream-one` і `auto` |
| mKCP, QUIC, обфускація заголовка HTTP у TCP | ❌ |
| Mux.Cool | ✅ |
| XUDP, packetaddr | ❌ UDP використовує звичайну команду UDP |
| Мультиплексування sing-box (smux, yamux, h2mux) | ✅ |
| Зворотний проксі (VLESS `reverse`) | ❌ Це можливість сервера |
| Посилання `vless://` ([стандарт посилань Xray](https://github.com/XTLS/Xray-core/discussions/716)) | ✅ |

## Посилання `vless://` {#links}

Посилання `vless://` містить цілий сервер в одному рядку:

```text
vless://id@host:port?type=…&security=…&…#name
```

| Частина | Опис |
| --- | --- |
| `id` | ID користувача. |
| `host` | Адреса сервера. IPv6-адресу беріть у квадратні дужки, наприклад `[2001:db8::1]`. |
| `port` | Порт сервера. |
| `encryption` | `none` або значення [VLESS Encryption](#encryption). |
| `flow` | Необов’язково. `xtls-rprx-vision` або `xtls-rprx-vision-udp443`. |
| `type` | [Транспорт](#transports). |
| `security` | `none`, `tls` або `reality`. |
| `sni`, `alpn`, `fp`, `pcs`, `ech`, `allowInsecure` | [Параметри TLS](#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, він записує посилання в цій формі.

### Приклади {#link-examples}

Кожен приклад показує посилання для імпорту. ID користувача — `3971e1b2-18a3-4f83-8fa6-bf9b142ee258`.

TLS без транспорту:

```text
vless://3971e1b2-18a3-4f83-8fa6-bf9b142ee258@vless.example.com:443?security=tls&sni=vless.example.com&type=tcp#TLS
```

REALITY з Vision, що позичає `www.example.com`:

```text
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-Vision
```

WebSocket через TLS і CDN, із 2048 байтами ранніх даних:

```text
vless://3971e1b2-18a3-4f83-8fa6-bf9b142ee258@vless.example.com:443?security=tls&type=ws&host=cdn.example.com&path=%2Fws%3Fed%3D2048#WebSocket
```

gRPC через TLS:

```text
vless://3971e1b2-18a3-4f83-8fa6-bf9b142ee258@vless.example.com:443?security=tls&type=grpc&serviceName=gun#gRPC
```

HTTP Upgrade через TLS:

```text
vless://3971e1b2-18a3-4f83-8fa6-bf9b142ee258@vless.example.com:443?security=tls&type=httpupgrade&host=cdn.example.com&path=%2Fup#HTTPUpgrade
```

XHTTP через TLS:

```text
vless://3971e1b2-18a3-4f83-8fa6-bf9b142ee258@vless.example.com:443?security=tls&type=xhttp&host=cdn.example.com&path=%2Fxh&mode=auto#XHTTP
```

HTTP/2 через TLS:

```text
vless://3971e1b2-18a3-4f83-8fa6-bf9b142ee258@vless.example.com:443?security=tls&type=http&host=cdn.example.com&path=%2Fh2#HTTP2
```

VLESS Encryption без TLS:

```text
vless://3971e1b2-18a3-4f83-8fa6-bf9b142ee258@vless.example.com:8443?security=none&encryption=mlkem768x25519plus.native.0rtt.u7dtLE6KgE4mjeBK3oYdNMw6MJB47Ijr_9AG2avwSmY&type=tcp#Encryption
```

Source: https://potatso.com/docs/uk/protocols/vless/index.mdx