· 故障排除 · 約 7 分鐘

Shadowrocket 訂閱解析失敗或節點清單空白:檢查連結格式、服務商狀態與更新時機

新增訂閱後若顯示解析失敗或清單空白,可依序檢查連結格式、服務商狀態與更新時機,並確認各步驟在 Shadowrocket 中的檢查位置。

本文重點

如果已有自己的服務商與訂閱連結,但 Shadowrocket 的 Home 沒有顯示伺服器項目,請先確認新增類型與完整連結,再確認服務商回傳的是伺服器清單,最後手動重新整理一次並比較結果。以下以 iPhone / iPad 介面為例;若項目已顯示,只是選取後無法連線,請改做連線問題排查,不要一再重新匯入訂閱。

先區分下載失敗、解析失敗與清單空白

訂閱項目出現在 Home,只代表應用程式中已加入這項訂閱,不表示伺服器清單已成功更新。每次更新都會先向訂閱網址送出請求,再讀取回應、辨識其中的伺服器項目,最後將結果顯示在 Home。下載失敗時,應用程式可能沒有取得可讀取的回應;解析失敗時,需確認取得的內容是否為預期格式;清單空白時,還要確認服務商目前是否確實有提供項目。單憑通用提示,有時無法判斷失敗發生在哪個步驟。

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

Failed to load subscription

可能原因:連結已失效,或請求未能取得可讀取的訂閱內容。處理方式:登入自己的服務商後台,確認目前連結是否有效、是否已產生伺服器清單,再回到 Home 下拉重新整理一次並記錄結果。

401 Unauthorized

可能原因:若服務商確認訂閱請求回傳此 HTTP 狀態,通常表示請求缺少有效的驗證資訊,例如連結中的權杖已失效。處理方式:從自己的帳戶後台重新複製完整連結;若最新連結仍回傳此狀態,請服務商確認驗證要求。這不是 Shadowrocket 固定顯示的提示文字。

檢查連結格式:在 Home 使用 Subscribe 新增

先確認複製的是服務商專門提供的訂閱網址,而不是帳戶後台、登入頁或說明頁的網址,也不是單一伺服器的分享連結。能在瀏覽器中開啟的網址,不一定可用於訂閱。以下僅示範網址結構,不能用來匯入伺服器:

https://example.com/sub?token=xxxx
  1. 複製目前的連結

    從自己的服務商後台複製目前的訂閱網址。不要從聊天訊息複製含有省略號的預覽文字,也不要一併複製網址末尾的句號、引號或換行。

  2. 選擇新增類型

    在 Shadowrocket 開啟 Home,點選右上角的 +,並在 Type 選擇 Subscribe。這裡新增的是用來取得伺服器清單的網址,不是在 Config 匯入規則檔。

  3. 檢查完整網址

    貼上連結,確認開頭的通訊協定、主機名稱、路徑,以及 ? 後方是否保留所有查詢參數。原網址若含有 & 或百分比編碼,請原樣保留;不要自行猜測並刪除參數,也不要手動將編碼改成一般字元。

  4. 儲存後重新整理

    儲存並返回 Home,在伺服器清單區域下拉重新整理。等待操作完成並顯示結果,再檢查對應的訂閱是否出現新項目。若先前已新增相同訂閱,請先檢查原有項目,不要為了測試而重複新增。

訂閱參數可能包含帳戶憑證。檢查時只在自己的裝置與服務商後台比對完整網址,不要將實際連結貼到公開的解析工具、貼文或截圖中。需要說明連結格式時,請以假資料替換權杖及其他可識別帳戶的資訊。

檢查服務商回應:HTTP 成功不代表清單有效

連結無誤但仍解析失敗時,請在服務商後台確認訂閱是否已啟用、目前帳戶是否獲配伺服器,以及訂閱網址是否曾變更。能登入後台,只能證明瀏覽器目前可以存取帳戶頁面;瀏覽器可能保留登入狀態,而 Shadowrocket 請求訂閱網址時,不會自動取得你在瀏覽器中的登入狀態。

200
HTTP OK:請求成功,不代表回應本文是有效清單
401
HTTP Unauthorized:請求缺少有效的驗證憑證
429
HTTP Too Many Requests:請求過於頻繁

結論:確認連結正確後,先詢問服務商回傳內容

如果完整連結在 Home 下拉重新整理後仍失敗,請提供重新整理的時間與時區,請服務商查核當時的 HTTP 狀態、回應是清單還是網頁,以及清單是否包含項目。先確認這三項,再決定是否需要更換連結或調整輸出格式。

檢查更新時機:每次只變更一個條件

剛啟用訂閱、重設權杖或調整帳戶分配時,請先確認變更已套用至訂閱網址,再回到 Home 重新整理。續期或分配更新可能仍使用原網址;若服務商明確重設了連結,就應更新已儲存的網址,而不是繼續重新整理舊網址。沒有統一的等待時間,請以自己的服務商提供的生效狀態為準。

  1. 記錄重新整理前的狀況。在 Home 確認檢查的是哪個訂閱,記下目前顯示的項目數與提示原文。舊項目仍然顯示,不代表剛才的重新整理已成功。
  2. 確認異動後重新整理一次。回到 Home 下拉重新整理,檢查是否出現項目、舊項目是否如預期變更,以及提示是否仍相同。若服務商確認回傳 429,請依服務商提供的等待時間再試,不要連續下拉重新整理。
  3. 只有懷疑網路問題時才進行比對。若目前網路上的重新整理提示逾時,可在同一裝置改用另一種可用網路,針對相同網址再試一次。測試時不要同時修改連結與帳戶設定;若只有某一種網路失敗,請優先確認該網路是否能連上訂閱網址,不要因此判定清單格式有誤。
  4. 項目恢復後就不要再重新匯入。若 Home 已顯示預期項目,但選用其中一項時無法連線,請改用 Connectivity Test 檢查連線。這項測試不是用來確認訂閱回傳格式,不能取代重新整理後的清單檢查。

清單仍空白時,整理要提供給服務商的資料

回報問題時,請分開說明「訂閱是否更新」與「伺服器是否能連線」。註明是第一次新增後一直空白,還是原有清單在某次異動後變空;這兩種情況需要查核的伺服器端紀錄不同。先保留現有項目與錯誤畫面,不必為了測試同一個訂閱回應而重新安裝應用程式或清空 Config。

下載 Shadowrocket