本文重點

從自己的服務商取得訂閱連結後,若匯入卻沒有節點,或原有清單更新失敗,請先保留現有項目,再檢查連結、回傳內容與更新時間,最後改用另一個可上網的網路交叉確認。以下以 iPhone / iPad 的 Home 介面路徑為例;如果清單中已有節點,只是選取後無法連線,這是節點連線問題,不是訂閱解析失敗。

先確認連結類型,再從 Home 更新

訂閱 URL 是用來取得一份清單的網址。服務商帳戶頁面和訂閱 URL 都可能以 https:// 開頭,但帳戶頁面通常會回傳網頁,不能當成訂閱匯入。以 ss:// 或 trojan:// 開頭的分享連結也不是訂閱 URL:它們代表單一節點,應依對應協定匯入,而不是填入 Subscribe。

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

以上僅示範 URL 結構,不能用來匯入。? 後的查詢參數可能包含存取憑證。請使用服務商帳戶中標示適用於 Shadowrocket 的訂閱連結,並複製完整網址;不要漏掉查詢參數、修改編碼字元,也不要連同聊天訊息中的引號或句號一起貼上。路徑與參數名稱由服務商決定,不必依照範例改寫。

  1. 確認原始連結

    登入自己的服務商帳戶,重新複製訂閱 URL。首次匯入前,請確認複製的是訂閱網址,而非登入頁面、控制台網址或短效下載網址。

  2. 選擇訂閱類型

    首次匯入時,開啟 Home,點選右上角的「+」,在 Type 中選擇 Subscribe,將完整網址貼到 URL 後儲存。若已有訂閱,不必再新增一筆;先確認目前項目使用的網址是否已由服務商更換。

  3. 重新整理一次

    回到 Home 向下拉動以重新整理,等請求完成後查看對應的訂閱群組。若出現錯誤,請記下原文;若沒有錯誤但看不到節點,先確認訂閱群組已展開,並記錄重新整理前後的項目數量。

  4. 保留舊項目

    舊清單仍可使用時,請先保留,不要為了觸發更新而刪除整個訂閱群組。需要更換連結時,先確認服務商已產生並啟用新網址,再修改原有訂閱。

區分請求失敗、解析失敗與清單空白

訂閱連結網路請求伺服器回應內容解析清單顯示

訂閱更新分為下載與解析兩個步驟。若請求逾時,客戶端可能根本沒有收到回應;若收到的回應內容是登入頁、錯誤頁或不相容的格式,則代表已取得內容,但無法解析成清單。另一種情況是回應格式可讀,但服務商實際產生了空清單,例如帳戶中沒有可匯出的項目。

200
HTTP 請求成功,不代表回應內容可解析
403
伺服器收到請求,但拒絕存取
429
請求過於頻繁,請依提示等待

結論:即使回傳 200,也要確認回應內容類型

若服務商確認回傳 200 OK,但 Home 中仍沒有項目,下一步應確認回傳內容是 Shadowrocket 可讀取的訂閱資料、網頁,還是項目數為零的清單。此時不要先更換節點連接埠或調整規則。

在瀏覽器中開啟網址,不代表客戶端能取得相同內容:瀏覽器可能保留登入狀態,或顯示重新導向後的網頁。若服務商提供帳戶內的訂閱預覽,請優先確認預覽中是否有項目;需要確認回應時,請服務商核對狀態碼、回應格式與項目數。不要將包含憑證的網址貼到公開檢測頁面。

依照提示原文處理訂閱更新錯誤

先記下介面實際顯示的提示。下列 HTTP 狀態文字也可能由服務商提供,不一定會原樣顯示在 Shadowrocket 中。若只看到一般性的載入提示,請勿直接猜測是連結過期或網路故障。

Failed to load subscription

原因:此提示表示訂閱載入失敗,僅憑提示無法判斷是下載失敗,還是回應內容無法使用。解決方式:先確認完整 URL,再使用同一個網址切換網路重新整理一次;若仍失敗,請服務商依請求時間查核回應。

401 Unauthorized

原因:伺服器未收到有效的身分憑證,可能是訂閱參數不完整,或憑證已失效。解決方式:從自己的帳戶重新複製目前使用的網址,並向服務商確認舊連結是否仍有效。

403 Forbidden

原因:請求遭到拒絕,可能與帳戶權限、連結狀態或伺服器存取政策有關。解決方式:請服務商確認訂閱的存取條件,不要重複送出相同請求。

429 Too Many Requests

原因:請求頻率觸發了速率限制。解決方式:停止連續下拉重新整理;如果回應中有 Retry-After,請依提示等待,否則依服務商說明稍後再試一次。

續約或更換連結後清單變空

付款紀錄、帳戶權益狀態與訂閱內容產生是不同環節。續約完成後,先查看帳戶顯示的生效狀態,再確認服務商是否已產生新清單。沒有通用的同步等待時間;若服務商有提供生效時間,請以其說明為準。服務商確認產生完成前,重複重新整理無法補上尚未發布的項目。

以 Wi-Fi 和行動數據交叉測試

網路交叉測試的原則是一次只變更一個條件:使用同一個訂閱連結與同一份設定,先在目前網路重新整理並記錄結果,再切換到另一個已確認可上網的網路重新整理一次。訂閱更新連線的是提供清單的伺服器;節點連線使用的是清單中的伺服器。能連上現有節點,不代表也能連上訂閱伺服器。

  1. 只有 Wi-Fi 失敗:先確認 Wi-Fi 是否需要完成網頁驗證。一般網頁可以開啟,但訂閱仍逾時時,請記錄失敗時間,並請網路管理員或服務商確認該訂閱網域的存取狀況。
  2. 只有行動數據失敗:先檢查系統是否允許 Shadowrocket 使用行動數據,再測試同一個訂閱。不要同時更換連結,否則無法判斷是哪項變更造成影響。
  3. 兩種網路顯示相同提示:如果都是 401 或 403,請優先確認憑證與帳戶存取權限;如果兩種網路都能送出請求但清單仍是空的,請服務商確認匯出內容,不要先修改 Global Routing 或重設 Config。

取得 Shadowrocket 與使用說明

iPhone / iPad 版可從 App Store 取得,價格為 $2.99 一次性付款;系統需求以 App Store 頁面標示為準。Mac(Apple 晶片 / Intel)/ Windows / Android / Linux 版免費,安裝檔請從本站全平台下載頁取得。