---
title: "VLESS"
description: "Potatso 支援的 VLESS 傳輸、流控、加密、TLS 選項、連結與功能。"
---

> 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 流控**（用來隱藏代理 HTTPS 流量的「TLS 套 TLS」特徵），以及 **VLESS Encryption**（Xray 的後量子加密層）。當 Potatso 支援這些所有設定時，就能連上該伺服器。請使用下方表格，對照服務商提供或 `vless://` 連結中顯示的伺服器設定。

你可以手動加入 VLESS 伺服器、使用 [`vless://` 連結](#links)，或透過匯入：

- Clash 或 Mihomo 訂閱，
- Xray 或 V2Ray 設定。

Potatso 目前還無法從 sing-box 設定匯入 VLESS 伺服器。請改用該伺服器的 `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 伺服器也接受其他最多 30 個字元的文字作為 ID，並以所有用戶端相同的方式將它轉換成 UUID。Potatso 也是如此，所以請完全照服務商提供的 ID 使用。

## 傳輸 {#transports}

| 傳輸 | 連結 `type` | 支援 | 測試對象 |
| --- | --- | --- | --- |
| 無傳輸（原始 TCP） | `tcp`、`raw`，或不指定 | ✅ | Xray、sing-box |
| WebSocket | `ws` | ✅ 可搭配或不搭配 early data | 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` | ❌ | |
| 使用 HTTP 標頭混淆的 TCP | `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` 用戶端模式，也不會匯入要求這些模式的連結。不支援 XHTTP 連結的 `extra` 參數：Potatso 會忽略它。Potatso 編輯的是搭配 TLS 或 REALITY 的 XHTTP 伺服器；已匯入、未使用 TLS 的 XHTTP 伺服器仍可運作。

## 安全性 {#security}

| 安全性 | 連結 `security` | 支援 |
| --- | --- | --- |
| 無 | `none`，或不指定 | ✅ 除非伺服器使用 [VLESS Encryption](#encryption)，否則你的流量不會加密。 |
| TLS | `tls` | ✅ |
| [REALITY](#reality) | `reality` | ✅ 搭配無傳輸、gRPC 或 XHTTP |

### TLS 設定 {#tls}

| 設定 | Clash 鍵 | 連結參數 | 支援 |
| --- | --- | --- | --- |
| 伺服器名稱（SNI） | `servername` | `sni` | ✅ 未設定時，Potatso 會使用伺服器的位址。 |
| ALPN | `alpn` | `alpn` | ✅ 未設定時，Potatso 對 WebSocket 傳送 `http/1.1`，對 gRPC、HTTP/2 和 XHTTP 傳送 `h2`，其他則不傳送。 |
| 略過憑證驗證 | `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 憑證，因此不需要自己的憑證。請依服務商給你的內容設定伺服器的**公鑰**和 **short ID**，並把伺服器名稱設為該伺服器所借用的網站。連線不需要連結中的 `spx`（spider path），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 不會儲存或匯入搭配其他傳輸或未使用 TLS 的 Vision 伺服器。它也可以在 TLS 之上搭配 VLESS Encryption 使用。

使用 Vision 時，UDP 是以 Xray 的方式透過 Mux.Cool 承載，Xray 和 sing-box 伺服器都接受這種方式。Xray 自己的用戶端在使用 `xtls-rprx-vision` 時會拒絕傳往 443 連接埠（QUIC）的 UDP，讓瀏覽器退回使用 TCP；Potatso 則在兩種流控下都會承載它。

## VLESS Encryption {#encryption}

VLESS Encryption（`mlkem768x25519plus`）是 Xray 的後量子加密層：在 VLESS 連線之下進行 ML-KEM-768 與 X25519 金鑰交換。伺服器的 `decryption` 設定有一個對應給用戶端的 `encryption` 值，看起來像這樣：

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

| 設定 | 支援 |
| --- | --- |
| `native`、`xorpub` 和 `random` 模式 | ✅ |
| `1rtt` 和 `0rtt`（恢復的連線） | ✅ |
| 以 X25519 或 ML-KEM-768 金鑰驗證的伺服器 | ✅ |
| 搭配無傳輸且無 TLS | ✅ |
| 在 TLS 之上 | ✅ 也可搭配 Vision |
| 未使用 TLS 的 Vision | ❌ |

Potatso 會保留連結、Clash 訂閱或 Xray 設定中的 `encryption` 值。你還無法在伺服器的設定中直接輸入。

## 多工 {#mux}

Potatso 可以讓多個連線共用同一條 VLESS 連線，在 Clash 訂閱中以 `smux` 設定：

| 協定 | Clash `smux.protocol` | 伺服器 | 支援 |
| --- | --- | --- | --- |
| 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 伺服器。

Xray 設定中 Xray 的 `mux` 設定不會匯入。

## UDP {#udp}

VLESS 在與 TCP 相同的連線上承載 UDP。UDP 預設為關閉，與 Clash 相同。如果你的伺服器轉送 UDP，請在伺服器的設定中開啟 UDP 轉送：Xray 和 sing-box 都支援。Clash 訂閱以 `udp: true` 開啟它。

每個 UDP 流向都有自己的伺服器連線，每個目的地也有自己的流向。Potatso 不支援 XUDP 或 packetaddr（連結中的 `packetEncoding`，訂閱中的 `packet-encoding` 或 `xudp`）：伺服器不需要它們就能接受 Potatso 的 UDP，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、TCP HTTP 標頭混淆 | ❌ |
| 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` | REALITY 公鑰與 short ID。 |
| `host`、`path` | WebSocket、HTTP Upgrade、HTTP/2 和 XHTTP 的 `Host` 標頭與路徑。WebSocket 路徑可用 `?ed=2048` 攜帶 early data。 |
| `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
```

搭配 Vision 的 REALITY，借用 `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
```

透過 CDN 的 TLS WebSocket，帶有 2048 位元組的 early data：

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

TLS gRPC：

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

TLS HTTP Upgrade：

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

TLS XHTTP：

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

TLS HTTP/2：

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

不使用 TLS 的 VLESS Encryption：

```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/zh-hant/protocols/vless/index.mdx