ss://、vmess://、vless://、trojan:// 格式解析：單一節點分享連結與訂閱連結差異

一、單一節點分享連結與訂閱連結的主要差異

單一節點分享連結會將單筆連線所需的參數寫入 URI。ss://、vmess://、vless://、trojan:// 前綴會告訴匯入器應採用哪種格式解析；匯入後取得的是伺服器記錄，而非持續取得新內容的網址。

訂閱連結通常是 HTTPS 網址。Shadowrocket 會向該網址發出請求、讀取回應內容，再解析其中的伺服器記錄。訂閱更新是重新請求並處理遠端內容，不會讓已匯入的單一節點連結自行變更。訂閱連結需向服務商取得；僅憑網址以 https:// 開頭，無法確認它提供的是節點訂閱、設定檔還是一般網頁。

二、ss://：認證欄位、伺服器位址與備註

Shadowsocks 常見的 SIP002 格式包含經 Base64URL 編碼的認證資訊、伺服器位址、連接埠，以及可選的備註。以下範例中，認證部分解碼後為 aes-256-gcm:password，位址為 example.com，連接埠為 8388。這些示範參數不能用於連線。

ss://[email protected]:8388#Example-SS

另一種較早期的格式會將「方法、密碼、位址、連接埠」整體編碼，外觀看不到 @ 也有可能。遇到無法匯入的連結時，應先確認採用哪種格式，而不是直接拼接分隔符號。部分連結也包含外掛程式參數；即使位址與密碼正確，遺漏這些參數仍可能無法連線。

三、vmess://：Base64 中的 JSON 參數

常見的 VMess 分享格式是在 vmess:// 後方接上一段 Base64 文字。解碼後通常是 JSON，而不是一般的「使用者名稱@伺服器」。以下展示的是編碼前的示範 JSON，並非可直接貼上匯入的完整連結。

{
  "v": "2",
  "ps": "Example-VMess",
  "add": "example.com",
  "port": "443",
  "id": "11111111-2222-4333-8444-555555555555",
  "aid": "0",
  "scy": "auto",
  "net": "ws",
  "type": "none",
  "host": "example.com",
  "path": "/connect",
  "tls": "tls",
  "sni": "example.com"
}

• add 與 port 指定連線目標；id 是用於認證的 UUID，不能以備註取代。
• 當 net 為 ws 時，必須一併檢查 WebSocket 的 host 與 path。路徑的大小寫及開頭的斜線都應保留。
• tls 與 sni 會影響 TLS 連線。WebSocket Host 與 TLS SNI 的用途不同，即使範例值相同，也不能視為同一個欄位。
• v 是此分享格式中的欄位，並非 Shadowrocket 的 App 版本；aid 等欄位應依實際服務參數解讀，不應照著範例改寫。

如果連結來自經過排版的訊息，換行、智慧引號或遭截斷的 Base64 都可能導致解析失敗。請先重新複製完整原文，再核對匯入結果。不要把 VMess JSON 當成設定檔內容貼到 Config，也不要將 JSON 裡的 port 誤認為訂閱 URL 的連接埠。

四、vless:// 與 trojan://：可讀欄位也要逐項核對

VLESS 和 Trojan 常見的分享連結採用較直觀的 URI 結構：認證資訊位於 @ 前方，後方則是位址、連接埠與查詢參數。範例中的 & 在頁面上代表連結參數之間的分隔符號；實際複製時請保留完整原始連結。

vless://[email protected]:443?encryption=none&security=tls&type=ws&host=example.com&path=%2Fconnect&sni=example.com#Example-VLESS

trojan://[email protected]:443?security=tls&type=tcp&sni=example.com#Example-Trojan

path=%2Fconnect 中的 %2F 是斜線的百分比編碼。密碼若含有 @、# 等 URI 保留字元，也須正確編碼，否則解析器可能會將部分密碼誤判為位址或備註。不了解欄位界線時，不要手動解碼整條連結後再匯入。

VLESS 範例中的 encryption=none 描述的是協定對應參數，不代表此範例沒有 TLS。不同分享格式對參數名稱的約定也可能不同，不能只替換前綴就將 VLESS 連結轉成 Trojan 連結。

五、Shadowrocket 匯入入口：節點訂閱與 Config 不同

Home 用來管理伺服器記錄與連線選擇，Config 用來管理規則設定，Settings 用來管理 App 設定。節點訂閱用於批次維護伺服器記錄；遠端設定也可能包含 [General]、[Rule] 等區段。兩種內容都可能透過 HTTPS 取得，但不能只因網址看起來相似，就從同一個入口匯入。

剪貼簿與相機權限由系統管理。複製完整連結後返回 Home，依畫面出現的匯入提示操作；掃描 QR Code 則使用 Home 中的掃描入口讀取原始文字。若沒有出現辨識提示，請先檢查前綴、空格與換行；不要將訂閱 URL 填入單一伺服器的 Address 欄位。

六、訂閱更新原理、敏感參數與排查順序

以下是明確的示範網址。token=xxxx 代表認證參數所在位置，並非真實憑證。伺服器收到請求後，可能會回傳經編碼的節點清單或其他可供用戶端辨識的訂閱內容；HTTPS URL 本身無法說明回傳格式。

https://example.com/sub?token=xxxx

1. 先確認資源類型。向服務商確認該網址是節點訂閱還是遠端設定。若回傳登入頁面、錯誤訊息或空白內容，就不能視為有效的節點清單。
2. 再確認請求是否成功。若逾時，先檢查目前網路是否能連線至訂閱網域；HTTP 401 或 403 通常需要核對授權與連結狀態。不要只因瀏覽器能顯示網頁，就認定訂閱有效。
3. 接著檢查解析結果。請求成功卻沒有記錄，可能是回傳內容不受目前入口支援，也可能確實沒有可用記錄。請核對格式說明，不要反覆新增重複的訂閱。
4. 最後檢查連線與規則。更新成功不代表每筆記錄都能連線。先在 Home 檢查選取的記錄，再查看 Global Routing；Config 會套用設定中的規則，Proxy 會將可代理的流量交由代理策略處理，Direct 則使用直連，Scene 會依選取的情境設定處理。節點分享連結本身不會自動建立完整的分流規則。

七、連結匯入與訂閱更新常見問題