如果已有自己的服務商與訂閱連結,但 Shadowrocket 的 Home 沒有顯示伺服器項目,請先確認新增類型與完整連結,再確認服務商回傳的是伺服器清單,最後手動重新整理一次並比較結果。以下以 iPhone / iPad 介面為例;若項目已顯示,只是選取後無法連線,請改做連線問題排查,不要一再重新匯入訂閱。
先區分下載失敗、解析失敗與清單空白
訂閱項目出現在 Home,只代表應用程式中已加入這項訂閱,不表示伺服器清單已成功更新。每次更新都會先向訂閱網址送出請求,再讀取回應、辨識其中的伺服器項目,最後將結果顯示在 Home。下載失敗時,應用程式可能沒有取得可讀取的回應;解析失敗時,需確認取得的內容是否為預期格式;清單空白時,還要確認服務商目前是否確實有提供項目。單憑通用提示,有時無法判斷失敗發生在哪個步驟。
Failed to load subscription
可能原因:連結已失效,或請求未能取得可讀取的訂閱內容。處理方式:登入自己的服務商後台,確認目前連結是否有效、是否已產生伺服器清單,再回到 Home 下拉重新整理一次並記錄結果。
401 Unauthorized
可能原因:若服務商確認訂閱請求回傳此 HTTP 狀態,通常表示請求缺少有效的驗證資訊,例如連結中的權杖已失效。處理方式:從自己的帳戶後台重新複製完整連結;若最新連結仍回傳此狀態,請服務商確認驗證要求。這不是 Shadowrocket 固定顯示的提示文字。
檢查連結格式:在 Home 使用 Subscribe 新增
先確認複製的是服務商專門提供的訂閱網址,而不是帳戶後台、登入頁或說明頁的網址,也不是單一伺服器的分享連結。能在瀏覽器中開啟的網址,不一定可用於訂閱。以下僅示範網址結構,不能用來匯入伺服器:
https://example.com/sub?token=xxxx
複製目前的連結
從自己的服務商後台複製目前的訂閱網址。不要從聊天訊息複製含有省略號的預覽文字,也不要一併複製網址末尾的句號、引號或換行。
選擇新增類型
在 Shadowrocket 開啟 Home,點選右上角的
+,並在Type選擇Subscribe。這裡新增的是用來取得伺服器清單的網址,不是在 Config 匯入規則檔。檢查完整網址
貼上連結,確認開頭的通訊協定、主機名稱、路徑,以及
?後方是否保留所有查詢參數。原網址若含有&或百分比編碼,請原樣保留;不要自行猜測並刪除參數,也不要手動將編碼改成一般字元。儲存後重新整理
儲存並返回 Home,在伺服器清單區域下拉重新整理。等待操作完成並顯示結果,再檢查對應的訂閱是否出現新項目。若先前已新增相同訂閱,請先檢查原有項目,不要為了測試而重複新增。
訂閱參數可能包含帳戶憑證。檢查時只在自己的裝置與服務商後台比對完整網址,不要將實際連結貼到公開的解析工具、貼文或截圖中。需要說明連結格式時,請以假資料替換權杖及其他可識別帳戶的資訊。
檢查服務商回應:HTTP 成功不代表清單有效
連結無誤但仍解析失敗時,請在服務商後台確認訂閱是否已啟用、目前帳戶是否獲配伺服器,以及訂閱網址是否曾變更。能登入後台,只能證明瀏覽器目前可以存取帳戶頁面;瀏覽器可能保留登入狀態,而 Shadowrocket 請求訂閱網址時,不會自動取得你在瀏覽器中的登入狀態。
- 回傳登入頁或錯誤頁:即使最終狀態為
200 OK,回應本文仍可能是網頁,而不是訂閱資料。請服務商確認連結是否重新導向至登入頁,以及應從帳戶後台複製哪個網址。 - 回傳空內容或空清單:請服務商確認目前帳戶是否有已分配的項目,以及最近的分配異動是否已同步至訂閱介面。Shadowrocket 無法從空白回應中產生伺服器項目。
- 回傳內容非空,但仍解析失敗:請服務商確認輸出格式是否可供 Shadowrocket 匯入,以及項目欄位是否完整。文字不為空,不代表格式相容;也不需要在 Home 手動猜填伺服器位址、連接埠或憑證。
結論:確認連結正確後,先詢問服務商回傳內容
如果完整連結在 Home 下拉重新整理後仍失敗,請提供重新整理的時間與時區,請服務商查核當時的 HTTP 狀態、回應是清單還是網頁,以及清單是否包含項目。先確認這三項,再決定是否需要更換連結或調整輸出格式。
檢查更新時機:每次只變更一個條件
剛啟用訂閱、重設權杖或調整帳戶分配時,請先確認變更已套用至訂閱網址,再回到 Home 重新整理。續期或分配更新可能仍使用原網址;若服務商明確重設了連結,就應更新已儲存的網址,而不是繼續重新整理舊網址。沒有統一的等待時間,請以自己的服務商提供的生效狀態為準。
- 記錄重新整理前的狀況。在 Home 確認檢查的是哪個訂閱,記下目前顯示的項目數與提示原文。舊項目仍然顯示,不代表剛才的重新整理已成功。
- 確認異動後重新整理一次。回到 Home 下拉重新整理,檢查是否出現項目、舊項目是否如預期變更,以及提示是否仍相同。若服務商確認回傳
429,請依服務商提供的等待時間再試,不要連續下拉重新整理。 - 只有懷疑網路問題時才進行比對。若目前網路上的重新整理提示逾時,可在同一裝置改用另一種可用網路,針對相同網址再試一次。測試時不要同時修改連結與帳戶設定;若只有某一種網路失敗,請優先確認該網路是否能連上訂閱網址,不要因此判定清單格式有誤。
- 項目恢復後就不要再重新匯入。若 Home 已顯示預期項目,但選用其中一項時無法連線,請改用
Connectivity Test檢查連線。這項測試不是用來確認訂閱回傳格式,不能取代重新整理後的清單檢查。
清單仍空白時,整理要提供給服務商的資料
回報問題時,請分開說明「訂閱是否更新」與「伺服器是否能連線」。註明是第一次新增後一直空白,還是原有清單在某次異動後變空;這兩種情況需要查核的伺服器端紀錄不同。先保留現有項目與錯誤畫面,不必為了測試同一個訂閱回應而重新安裝應用程式或清空 Config。
- 用戶端資訊:裝置平台、操作路徑
Home → + → Type → Subscribe、儲存後是否在 Home 下拉重新整理,以及重新整理前後可見的項目數與提示原文。 - 帳戶資訊:重新整理的時間與時區、近期是否續期或更換連結,以及帳戶後台是否顯示已分配伺服器。提供給服務商的截圖,請遮蔽完整網址、帳戶名稱與權杖。
- 請服務商確認:該次請求是否有送達、回傳的狀態與本文類型,以及清單是否包含項目。若服務商確認已修正回應,請回到 Home 手動重新整理一次,確認是否出現預期項目。