如果手上已有服務提供者給的連結,先查看開頭,再選擇匯入方式:ss://、vmess://、vless://、trojan:// 以單條記錄匯入;服務提供者明確標示為訂閱的 HTTPS 網址,則使用 Subscribe 新增。匯入後,分別確認清單、連線與分流。
如何區分分享連結與訂閱連結
單條分享連結包含一組連線參數,匯入後會新增一筆本機記錄。訂閱連結則指向服務提供者維護的清單;更新時,客戶端會重新向該網址發出請求並解析回應。即使訂閱目前只傳回一個節點,它仍然是訂閱;反之,從清單中單獨複製出來的分享連結,也不會隨原清單自動更新。
匯入訂閱:保留清單來源
建議如果服務提供者已提供訂閱並會維護清單,請儲存原始訂閱 URL。之後從訂閱群組更新即可,不必逐筆重新複製分享連結。
適用情況:已有訂閱,需要同步服務提供者更新的清單。
單條匯入:儲存一組連線參數
只會新增連結所描述的那筆記錄。服務提供者調整位址、連接埠或憑證後,需確認新參數並取代舊記錄。
適用情況:手上只有一條分享連結,或只想確認單筆記錄。
結論:不要將任意 HTTPS 網址填入 Subscribe
先確認服務提供者是否將該網址標示為適用於 Shadowrocket 的訂閱。登入頁、說明文件和訂閱網址都可能以 https:// 開頭,清單網址甚至可能沒有 /sub;單憑開頭、路徑或 token 參數,無法判斷回應內容。
解析 ss://、vmess://、vless://、trojan:// 欄位
以下的網域、密碼與識別碼僅供排版示範,無法用於連線。範例中的連接埠是示意值,並非這些協定的固定連接埠。實際匯入時,請保留服務提供者給的完整連結,包括 ? 後的參數及 # 後的備註。
Shadowsocks:ss://
ss://[email protected]:8388#demo-ss
這是將認證資訊放在 @ 前方的一種常見格式。此處以 Base64URL 編碼的內容為 aes-128-gcm:dummy,分別代表加密方式與示範密碼;@ 後方則是伺服器與連接埠。Base64URL 是編碼方式,並非密碼保護。舊格式的編碼範圍可能更大,因此不能只因看不到明文伺服器位址,就判定連結已損毀。
VMess:vmess://
常見格式會在 vmess:// 後方放置一段以 Base64 編碼的 JSON。下方展示的是解碼後的欄位範例,並非可直接貼上的分享連結。add 和 port 分別是連線位址與連接埠,id 是使用者識別碼,ps 是備註。此範例的 net 為 ws,因此也要確認 WebSocket 的 host 和 path,以及 TLS 使用的 sni。
{
"ps": "demo-vmess",
"add": "vmess.example.com",
"port": "443",
"id": "11111111-1111-4111-8111-111111111111",
"net": "ws",
"host": "vmess.example.com",
"path": "/demo",
"tls": "tls",
"sni": "vmess.example.com"
}
VLESS 與 Trojan:vless://、trojan://
vless://[email protected]:443?encryption=none&security=tls&type=tcp&sni=vless.example.com#demo-vless
trojan://[email protected]:443?sni=trojan.example.com#demo-trojan
- 這個
vless://範例在@前方放置 UUID,type=tcp用來指定傳輸方式,security=tls則指定 TLS。此處的encryption=none是 VLESS 參數,不代表同時指定的 TLS 已停用。 trojan://在@前方放置密碼,不應將它視為 UUID。範例中的sni是 TLS 交握時使用的伺服器名稱。連線位址與sni是不同欄位,實際值應依服務提供者給的參數保留。- 兩條範例中
#後方的內容都是顯示用備註。修改備註不會改變伺服器位址;但任意增刪密碼中的字元、百分比編碼或查詢參數,可能導致連結解析錯誤或連線失敗。
Shadowrocket 匯入步驟:複製單條連結或新增 Subscribe
以下以 iPhone / iPad 介面為例。複製時,從協定前綴或 https:// 開始,一直到連結末尾;不要包含引號、聊天軟體附加的說明或行尾標點。文中的範例僅供確認結構,請使用自己的完整連結。
從 Home 匯入:依手上的連結選擇操作
單條分享連結
- 複製完整的協定連結,返回 Shadowrocket 的
Home。若系統詢問是否允許貼上,確認來源無誤後再允許;若 App 辨識出連結,依提示新增。 - 若沒有出現匯入提示,先檢查剪貼簿中的前綴與結尾。若服務提供者另有提供同一筆記錄的 QR Code,可使用
Home的掃描入口匯入;也可以點選右上角的+,依實際的Type手動填入服務提供者給的欄位。 - 新增後,在
Home確認是否多出一筆記錄,並開啟記錄核對協定、位址與連接埠。提示框消失不代表記錄已儲存。
訂閱連結
- 前往
Home → + → Type → Subscribe,在URL欄位貼上服務提供者給的完整網址。範例:https://example.com/sub?token=xxxx。 - 儲存後返回
Home,確認相應的訂閱群組是否出現,以及群組內是否已載入節點。只看到群組名稱,還不能確認清單已成功解析。 - 若要同步服務提供者的更新,請在
Home使用該訂閱群組的更新功能,再檢查群組內的記錄;不必為了更新而重複新增相同的 URL。
單條連結的驗收對象是一筆記錄;訂閱則要確認對應的群組及群組內清單。兩者都還需要另行測試連線。
匯入成功後,如何區分連線問題與分流問題
- 先確認記錄。 開啟目標節點,確認協定類型、伺服器與連接埠都符合原始連結。同名記錄不一定是同一個節點;若有舊記錄,不要只憑備註判斷選取的是哪一筆。
- 再確認連線。 在
Home選取已確認的記錄,開啟連線開關。若無法建立連線,請檢查憑證是否仍有效,以及 TLS、sni、傳輸方式與路徑是否符合服務提供者給的設定。App 接受連結,只代表能解析該記錄,不代表遠端服務可用。 - 最後確認分流。 前往
Home → Global Routing查看目前模式。Direct不會使用已選取的代理節點,因此不能用來確認節點是否接管目標請求;Config會依目前設定比對規則,即使請求成功,也可能命中DIRECT。若只想判斷問題是否與規則有關,可暫時選擇Proxy,重試相同請求後再還原原設定。
匯入失敗與訂閱更新常見問題
複製了 vmess://,返回 Home 後為什麼沒有新增記錄?
先確認複製的是從 vmess:// 開始的完整字串,而不是解碼後的 JSON,或聊天視窗中被截斷的預覽。再確認是否曾出現系統貼上提示。若仍無法辨識,請向原服務提供者確認連結格式,並使用對方提供的 QR Code 或原始參數;不要自行修改編碼來嘗試。
訂閱群組已出現,為什麼裡面是空的?
先對該群組執行一次更新,再確認儲存的 URL 是否完整,尤其是 ? 後方的驗證參數。如果服務提供者回傳登入頁或錯誤頁,即使網址能在瀏覽器中開啟,也無法作為清單匯入。此時應向原服務提供者確認訂閱是否有效、格式是否正確。
訂閱已更新,為什麼先前單獨匯入的同名節點沒有變更?
更新只會套用到對應的訂閱群組,不會依備註名稱覆蓋手動匯入的獨立記錄。在 Home 展開對應群組,選用群組內的新記錄並確認;若打算刪除舊項目,請先確認它確實是獨立記錄,而非群組內的項目。
排查問題時,可以傳送原始連結或 QR Code 嗎?
請勿公開原始內容。單條連結可能包含密碼或 UUID,訂閱 URL 可能含有存取憑證,QR Code 也可能編碼相同資訊。回報問題時,提供協定前綴、匯入步驟、錯誤訊息,以及已遮蔽敏感欄位的截圖即可。
Shadowrocket 下載與匯入教學
iPhone / iPad 版可從 App Store 下載,價格為 $2.99 一次性付費;系統需求以 App Store 頁面標示為準。Mac(Apple 晶片與 Intel)、Windows、Android 和 Linux 版免費。下載頁依裝置列出取得方式,快速入門內容則說明新增記錄後的連線步驟。