URL 結構與編碼

VLESS 鏈接由協議、UUID、服務器地址、端口、查詢參數與備註組成。端口範圍是 1–65535；IPv6 地址應置於方括號內，國際化域名使用 Punycode。

查詢參數名區分大小寫，同一參數不要重複。參數值與備註需要 URL 編碼，例如 /example 編爲 %2Fexample，空格編爲 %20。以下是結構示意，不是可用節點。

VLESS URL複製
vless://<uuid>@<host>:<port>?type=<transport>&security=<security>#<label>

協議與傳輸字段

encryption 與 security 不是同一個設置：前者是協議加密，後者是傳輸安全。新擴展要求客戶端和核心同時支持，無法僅憑鏈接存在某字段就判斷可用。

字段含義與取值
encryptionVLESS 常見爲 none；較新提案也包含 mlkem768x25519… 形式，須完整保留服務端參數
flow如 xtls-rprx-vision，與服務端一致
typetcp、kcp、ws、http、grpc、httpupgrade、xhttp
securitynone、tls、reality
host / pathWS、HTTPUpgrade、XHTTP 等的 Host 與路徑
serviceName / authoritygRPC 服務名 / Authority
modegRPC 的 gun、multi、guna，或對應 XHTTP 模式
mtu / ttimKCP 傳輸參數
extra / fmXHTTP 擴展 / Finalmask 的 URL 編碼 JSON

TLS 與 REALITY 字段

使用 TLS 時覈對服務名與證書；使用 REALITY 時保留提供方給出的認證參數。fp 是 TLS ClientHello 指紋，不是證書 SHA-256 指紋。

字段含義
sniTLS / REALITY 的 serverName，省略時通常沿用服務器域名
fpTLS 客戶端指紋；REALITY 需要該項
alpn逗號分隔的協議列表，值需 URL 編碼
echECH 配置列表
pcs / vcn證書 SHA-256 固定值 / 驗證名稱
pbkREALITY password 參數，舊界面可能稱公鑰
sidREALITY shortId
pqvREALITY ML-DSA-65 驗證公鑰
spxREALITY spiderX，值需 URL 編碼

導入與覈對示例

以下示例使用保留域名和佔位 UUID。複製自己的完整鏈接到客戶端導入後，分別檢查地址、端口、傳輸、SNI 和 flow。不要把 VLESS 的 encryption=none 理解爲關閉 TLS；是否使用 TLS 由 security 決定。

VLESS · illustrative URL複製
vless://00000000-0000-4000-8000-000000000000@proxy.example.com:443?encryption=none&type=ws&security=tls&sni=proxy.example.com&host=proxy.example.com&path=%2Fexample#Example%20TLS

舊鏈接與新核心的差異

VMessAEAD / VLESS 分享提案持續演進，早期示例裏的舊 flow 或 xtls 字段不能直接套用到當前版本。導入後連接失敗時，先確認客戶端實際保留了哪些字段，再檢查覈心日誌。

證書驗證失敗應修正信任或服務名配置；7.25.6 使用的新 Xray 格式不再以 allowInsecure 作爲解決方式。

當前更新與兼容性證書設置