Shadowrocket 分享連結格式說明：ss://、vmess://、vless://、trojan:// 與訂閱連結的差異

1. 分享連結與訂閱連結：單一連線和遠端清單

ss://、vmess://、vless://、trojan:// 是分享連結的 scheme，用來提示用戶端應以哪種格式解析後續內容。這類連結通常描述單一連線，包含伺服器位址、連接埠、驗證資料，以及必要的傳輸選項。匯入後，Shadowrocket 會將這些欄位儲存於本機；連結本身通常不會持續取得遠端變更。

訂閱連結通常是 https:// 位址。用戶端連線至該位址後，會讀取伺服器傳回的連線清單，再依支援的格式解析。訂閱網址的路徑名稱沒有統一標準，不能只看是否包含 /sub 就判斷用途；一般網頁、登入頁面和訂閱回應都可能使用 HTTPS。請以既有服務商提供的說明及實際回應內容為準。

例如 https://example.com/sub?token=xxxx 只是訂閱網址格式的示意，並非服務入口，也不能直接用來訂閱。訂閱內容可能包含多種協定的連線，不一定只是同一協定的多個位址；「訂閱」描述的是取得與更新方式，並非網路傳輸協定。

2. ss://：核對 Shadowsocks 加密方法與密碼

常見的 Shadowsocks 分享格式會將加密方法與密碼放在使用者資訊部分，再以 @ 接上伺服器位址與連接埠。符合 SIP002 格式的連結可使用 Base64URL 編碼使用者資訊；也可能遇到較早期、將更多欄位一併編碼的格式。因此，不要假設所有 ss:// 連結都能直接依照單一個 @ 拆解。

ss://[email protected]:8388#SS%20Demo

使用者資訊解碼後的教學內容：
aes-128-gcm:password

• aes-128-gcm 是範例加密方法，必須與伺服器端設定一致。不要只因名稱相近就改用其他方法。
• password 是教學用密碼。實際密碼請原樣保留，包括大小寫與特殊字元。
• server.example.com 是教學用網域，8388 是範例連接埠。Shadowsocks 並未規定所有連線都使用此連接埠。
• #SS%20Demo 是連結片段，通常用於備註；%20 代表空格。變更備註通常不會影響驗證資料。
• 如果原始連結包含 plugin 參數，也要確認相應外掛程式及其選項是否受到支援。忽略這些內容，可能會出現「匯入成功但無法連線」的情況。

匯入後，在 Home 開啟對應項目的編輯頁面，核對協定類型、位址、連接埠、加密方法與密碼。若用戶端成功建立項目，只能代表解析成功；伺服器是否接受該密碼、連接埠是否可連通，仍須另外測試。

3. vmess://：先了解編碼後的 JSON 欄位

常見的 vmess:// 分享連結會在 scheme 後附上一段經 Base64 編碼的 JSON。編碼內容通常包含位址、連接埠、使用者 ID、傳輸方式與 TLS 等欄位。以下展示的是解碼後的教學物件，並非可直接貼上匯入的完整分享連結。

{
  "v": "2",
  "ps": "VMess Demo",
  "add": "server.example.com",
  "port": "443",
  "id": "123e4567-e89b-42d3-a456-426614174000",
  "aid": "0",
  "scy": "auto",
  "net": "ws",
  "type": "none",
  "host": "edge.example.com",
  "path": "/demo",
  "tls": "tls",
  "sni": "edge.example.com"
}

上述欄位屬於常見分享格式之一，並非所有產生工具都會提供完全相同的 JSON。匯入後應檢查解析結果，不要只確認備註是否出現。如果實際資料要求 WebSocket 與 TLS，但匯入後缺少 path 或 TLS 狀態不符，請先確認原始連結是否遭截斷，再向既有服務商確認格式與參數。

4. vless:// 與 trojan://：查詢參數也是連線條件

常見的 VLESS 與 Trojan 分享格式接近可直接閱讀的 URI：驗證資料位於 @ 前，位址與連接埠在後，問號之後則是安全層與傳輸選項。兩者的驗證欄位並不相同：VLESS 通常使用 UUID，Trojan 則使用密碼，不能只更改前綴就將一種協定轉換成另一種。

vless://[email protected]:443?encryption=none&security=tls&type=ws&host=edge.example.com&path=%2Fdemo&sni=edge.example.com#VLESS%20Demo

trojan://[email protected]:443?security=tls&type=tcp&sni=edge.example.com#Trojan%20Demo

1. 先核對驗證資料。VLESS 範例中的 UUID 與 Trojan 範例中的 demo-password 都是假資料；實際匯入時必須使用原始資料。
2. 接著核對 server.example.com:443。此處的 443 是特定範例，不要以「通常使用 TLS」為由，改用不同於服務商提供的連接埠。
3. 檢查 security=tls 與 sni。兩者會影響 TLS 交握與憑證核對，不只是顯示名稱。
4. 檢查 type=ws 或 type=tcp。VLESS 範例中的 host 和 path 是 WebSocket 條件；%2Fdemo 解碼後為 /demo。
5. 保留原始連結中的其他必要參數。如果原始資料包含 flow 或其他與安全層相關的欄位，請確認用戶端是否正確識別，不要依照這個簡化範例刪除。

VLESS 範例中的 encryption=none 指的是 VLESS 本身的加密選項，不代表範例沒有 TLS 保護；協定驗證、傳輸方式與 TLS 各屬不同層次。Trojan 通常依賴 TLS，憑證名稱與信任狀態同樣重要。遇到憑證錯誤時，請檢查位址、SNI 與伺服器憑證，不要直接關閉憑證驗證。

5. 在 Home 匯入：選擇單一連線或訂閱

開始前先確認手上的資料屬於哪一種。Home 用來管理及選擇連線項目，Config 用於設定檔與規則，Settings 則是應用程式設定。連線清單訂閱不是規則設定檔；將訂閱網址填入 Config 的設定檔入口，不能取代連線訂閱的匯入。

1. 從原始資料複製完整連結。請勿包含中文引號、句末標點、聊天軟體的說明文字或程式碼圍欄。
2. 儲存後返回 Home，確認顯示的是獨立項目，還是訂閱及其子項目。只看到訂閱名稱，並不足以證明清單已成功取得。
3. 開啟單一連線的編輯頁面，核對類型、位址、連接埠與驗證欄位。若使用 WebSocket 或 TLS，也要確認相應選項。
4. 選擇要測試的連線。首次開啟連線開關時，請依系統提示授權新增 VPN 設定，接著測試目標的連線情況。

QR Code 只是連結的另一種呈現方式，並非額外的協定。若 QR Code 包含訂閱 URL，匯入後仍應視為訂閱；若包含單一 ss://，也不會因掃描匯入而取得遠端更新功能。iPhone 與 iPad 請依實際介面操作，系統需求以 App Store 頁面標示為準。

6. 更新與排除問題：先分辨取得失敗或連線失敗

更新訂閱是再次請求遠端清單，不等於更新 Shadowrocket 應用程式，也不等於重新整理 Config 中的規則。遠端項目可能新增、刪除或替換；請勿假設訂閱項目上的所有本機修改都會在下次更新後保留。需要進行對照測試時，請先記錄修改前的欄位與結果。

排除問題時，請分辨三個階段：URL 請求是否成功、回應能否解析，以及解析後的連線是否可用。例如 HTTP 401 或 403 通常表示存取授權可能有問題，但仍須參考服務商提供的回應說明；即使收到 HTTP 200，也可能只是取得登入 HTML 頁面。若清單已出現但網頁仍無法開啟，請繼續核對連線、Global Routing 與 Config 中的規則，不要反覆重新匯入同一連結。