從自己的服務商取得訂閱連結後,若匯入卻沒有節點,或原有清單更新失敗,請先保留現有項目,再檢查連結、回傳內容與更新時間,最後改用另一個可上網的網路交叉確認。以下以 iPhone / iPad 的 Home 介面路徑為例;如果清單中已有節點,只是選取後無法連線,這是節點連線問題,不是訂閱解析失敗。
先確認連結類型,再從 Home 更新
訂閱 URL 是用來取得一份清單的網址。服務商帳戶頁面和訂閱 URL 都可能以 https:// 開頭,但帳戶頁面通常會回傳網頁,不能當成訂閱匯入。以 ss:// 或 trojan:// 開頭的分享連結也不是訂閱 URL:它們代表單一節點,應依對應協定匯入,而不是填入 Subscribe。
https://example.com/sub?token=xxxx
以上僅示範 URL 結構,不能用來匯入。? 後的查詢參數可能包含存取憑證。請使用服務商帳戶中標示適用於 Shadowrocket 的訂閱連結,並複製完整網址;不要漏掉查詢參數、修改編碼字元,也不要連同聊天訊息中的引號或句號一起貼上。路徑與參數名稱由服務商決定,不必依照範例改寫。
確認原始連結
登入自己的服務商帳戶,重新複製訂閱 URL。首次匯入前,請確認複製的是訂閱網址,而非登入頁面、控制台網址或短效下載網址。
選擇訂閱類型
首次匯入時,開啟 Home,點選右上角的「+」,在
Type中選擇Subscribe,將完整網址貼到URL後儲存。若已有訂閱,不必再新增一筆;先確認目前項目使用的網址是否已由服務商更換。重新整理一次
回到 Home 向下拉動以重新整理,等請求完成後查看對應的訂閱群組。若出現錯誤,請記下原文;若沒有錯誤但看不到節點,先確認訂閱群組已展開,並記錄重新整理前後的項目數量。
保留舊項目
舊清單仍可使用時,請先保留,不要為了觸發更新而刪除整個訂閱群組。需要更換連結時,先確認服務商已產生並啟用新網址,再修改原有訂閱。
區分請求失敗、解析失敗與清單空白
訂閱更新分為下載與解析兩個步驟。若請求逾時,客戶端可能根本沒有收到回應;若收到的回應內容是登入頁、錯誤頁或不相容的格式,則代表已取得內容,但無法解析成清單。另一種情況是回應格式可讀,但服務商實際產生了空清單,例如帳戶中沒有可匯出的項目。
結論:即使回傳 200,也要確認回應內容類型
若服務商確認回傳 200 OK,但 Home 中仍沒有項目,下一步應確認回傳內容是 Shadowrocket 可讀取的訂閱資料、網頁,還是項目數為零的清單。此時不要先更換節點連接埠或調整規則。
在瀏覽器中開啟網址,不代表客戶端能取得相同內容:瀏覽器可能保留登入狀態,或顯示重新導向後的網頁。若服務商提供帳戶內的訂閱預覽,請優先確認預覽中是否有項目;需要確認回應時,請服務商核對狀態碼、回應格式與項目數。不要將包含憑證的網址貼到公開檢測頁面。
依照提示原文處理訂閱更新錯誤
先記下介面實際顯示的提示。下列 HTTP 狀態文字也可能由服務商提供,不一定會原樣顯示在 Shadowrocket 中。若只看到一般性的載入提示,請勿直接猜測是連結過期或網路故障。
Failed to load subscription
原因:此提示表示訂閱載入失敗,僅憑提示無法判斷是下載失敗,還是回應內容無法使用。解決方式:先確認完整 URL,再使用同一個網址切換網路重新整理一次;若仍失敗,請服務商依請求時間查核回應。
401 Unauthorized
原因:伺服器未收到有效的身分憑證,可能是訂閱參數不完整,或憑證已失效。解決方式:從自己的帳戶重新複製目前使用的網址,並向服務商確認舊連結是否仍有效。
403 Forbidden
原因:請求遭到拒絕,可能與帳戶權限、連結狀態或伺服器存取政策有關。解決方式:請服務商確認訂閱的存取條件,不要重複送出相同請求。
429 Too Many Requests
原因:請求頻率觸發了速率限制。解決方式:停止連續下拉重新整理;如果回應中有 Retry-After,請依提示等待,否則依服務商說明稍後再試一次。
續約或更換連結後清單變空
付款紀錄、帳戶權益狀態與訂閱內容產生是不同環節。續約完成後,先查看帳戶顯示的生效狀態,再確認服務商是否已產生新清單。沒有通用的同步等待時間;若服務商有提供生效時間,請以其說明為準。服務商確認產生完成前,重複重新整理無法補上尚未發布的項目。
- 續約後清單空白:確認續約是否生效,以及帳戶中是否仍有可匯出的項目。若帳戶頁面顯示正常,請服務商確認目前使用的 URL 實際回傳了多少項目。
- 重設連結後無法更新:舊網址可能已失效。請複製新網址並更新對應訂閱,保留完整路徑與查詢參數;只改網域,或只替換自己認得的某段參數,都可能造成網址錯誤。
- 重新整理後仍顯示舊清單:看得到舊項目,不代表這次請求成功。請先記下重新整理時的提示,並向服務商確認目前匯出的內容;如果服務商仍回傳舊清單,重複刪除再匯入也無法取得新項目。
以 Wi-Fi 和行動數據交叉測試
網路交叉測試的原則是一次只變更一個條件:使用同一個訂閱連結與同一份設定,先在目前網路重新整理並記錄結果,再切換到另一個已確認可上網的網路重新整理一次。訂閱更新連線的是提供清單的伺服器;節點連線使用的是清單中的伺服器。能連上現有節點,不代表也能連上訂閱伺服器。
- 只有 Wi-Fi 失敗:先確認 Wi-Fi 是否需要完成網頁驗證。一般網頁可以開啟,但訂閱仍逾時時,請記錄失敗時間,並請網路管理員或服務商確認該訂閱網域的存取狀況。
- 只有行動數據失敗:先檢查系統是否允許 Shadowrocket 使用行動數據,再測試同一個訂閱。不要同時更換連結,否則無法判斷是哪項變更造成影響。
- 兩種網路顯示相同提示:如果都是
401或403,請優先確認憑證與帳戶存取權限;如果兩種網路都能送出請求但清單仍是空的,請服務商確認匯出內容,不要先修改Global Routing或重設Config。
取得 Shadowrocket 與使用說明
iPhone / iPad 版可從 App Store 取得,價格為 $2.99 一次性付款;系統需求以 App Store 頁面標示為準。Mac(Apple 晶片 / Intel)/ Windows / Android / Linux 版免費,安裝檔請從本站全平台下載頁取得。