本文適用於已持有自身服務商訂閱連結的使用者。先區分「請求失敗」、「內容無法解析」與「請求成功但沒有可用項目」,再檢查 Subscribe 的 URL、服務商回傳內容與更新時機,最後一次只改一個條件來測試網路。排查期間請保留現有設定,不要先刪除仍可使用的項目。
一、先確認問題發生在哪個環節
Shadowrocket(小火箭)更新訂閱時,會向指定 URL 請求內容,再將支援的節點資料轉換為 Home 中的項目。訂閱連結可以儲存,不代表伺服器已回傳有效內容;伺服器回應成功,也不代表內容一定包含可解析的節點。
記下目前的狀況:是新增時立即顯示失敗,還是更新等待後逾時;是原有項目仍在但更新失敗,還是新建的訂閱群組始終空白。舊項目仍存在,只能表示本機先前儲存過資料,無法證明這次更新成功。節點可以連線,也不代表訂閱網址目前仍有效。
判斷方式:先記錄狀況,再調整設定
先記下錯誤訊息原文與操作時間,再手動更新一次。若直接刪除訂閱、切換設定並重新安裝應用程式,就無法判斷是哪項變更影響結果。
二、檢查 Subscribe 中儲存的連結
訂閱 URL 應由你使用的服務商提供,不能以帳戶登入頁、訂單頁或網頁分享頁取代。以下網址僅為格式範例,不能用來匯入。URL 中的路徑與查詢參數可能共同用於識別帳戶,不能只複製網域。
https://example.com/sub?token=xxxx
-
複製原始連結
前往自己的服務商帳戶頁面,使用訂閱複製功能,並選擇標示適用於 Shadowrocket 的格式。請勿從截圖辨識連結,也不要連同頁面標題一起複製。
-
確認新增位置
在 Home 右上角點選「+」,將 Type 設為 Subscribe,再把完整網址貼到 URL。若已有訂閱,請先檢查原有記錄,不必重複新增相同群組。
-
檢查網址字元
確認開頭的
https://、結尾參數與複製前一致,並移除網址前後的空格、換行或引號。保留參數中的原有字元,不要任意刪改?、&、=或百分比編碼。 -
儲存並更新
儲存後返回 Home,向下滑動以重新整理訂閱清單,等待操作完成,再查看目標群組是否出現項目。記錄這次結果,避免連續發出多次請求。
單一節點 URI 與訂閱 URL 是不同類型的輸入。以 ss://、vmess:// 或 trojan:// 等格式提供的單筆資料,應使用相應的匯入方式處理,不能當成 HTTP 訂閱網址填入 Subscribe 的 URL。反過來說,訂閱頁面網址也不能直接當作某個協定的伺服器位址。
訂閱 URL 可能包含帳戶權杖。請勿將完整網址貼到公開留言、截圖或線上解碼工具。需要協助時,請保留網域與錯誤訊息,並遮蔽路徑中的金鑰及所有身分識別參數。
三、區分 HTTP 狀態碼與回應內容
若錯誤訊息或服務商記錄中包含 HTTP 狀態碼,請先依狀態碼判斷問題。以下列出的是標準 HTTP 回應狀態,並不表示 Shadowrocket 在所有系統上都會逐字顯示這些文字。若沒有狀態碼,請保留實際訊息,不要自行推斷為「連結已過期」。
錯誤:401 Unauthorized
原因:伺服器要求的身分驗證未通過,可能是權杖失效、缺漏或驗證方式不符。
處理方式:返回自己的服務商帳戶頁面,重新複製目前的訂閱 URL;若仍收到相同狀態碼,請向服務商確認該權杖的權限。
錯誤:403 Forbidden
原因:伺服器拒絕目前的請求,可能與存取政策、帳戶權限或安全性封鎖有關,不能只憑此狀態碼判定方案已到期。
處理方式:記下時間、網路類型與完整錯誤訊息,請服務商查詢對應請求;不要連續重新整理以嘗試繞過限制。
錯誤:404 Not Found
原因:請求的路徑不存在,可能是連結遭截斷、舊網址已停用,也可能是伺服器刻意隱藏資源。
處理方式:逐項比對目前帳戶頁面提供的路徑與參數,不要自行猜測介面路徑;若新連結仍無法使用,請交由服務商確認。
200 OK 只代表 HTTP 層級的請求成功。回應內文仍可能是登入頁面、安全驗證頁面、維護通知或空白內容。即使這些內容能在瀏覽器中開啟,也不能據此判定用戶端應產生節點。瀏覽器可能帶有帳戶 Cookie,而訂閱請求並不等同於已登入的網頁工作階段。
- 若回應內文以
<!DOCTYPE html>或<html>開頭,請先確認取得的是網頁,而非訂閱資料。 - 若服務商明確提供多種輸出格式,請使用其標示適用於 Shadowrocket 的格式;不要只改副檔名來嘗試轉換內容。
- 有些訂閱會以 Base64 編碼包裝文字。編碼並非加密,也不保證內部資料格式正確;請勿將原始內容交由第三方網站處理。
- 若回應內容空白,或只有說明文字而沒有節點資料,請先確認帳戶中的可用項目與伺服器輸出,不要先修改 Global Routing。
四、確認服務商狀態與更新時機
訂閱群組空白,可能是伺服器目前沒有為帳戶配置可用項目,也可能是訂閱輸出尚未與帳戶頁面的狀態同步。帳戶餘額、方案狀態、裝置限制與訂閱權限是不同欄位,應以服務商的實際說明為準;Shadowrocket 中的空清單本身無法證明其中任何一項。
- 檢查帳戶:登入自己的服務商頁面,確認服務狀態、有效期限,以及頁面上是否有可用項目。若帳戶頁面本身沒有項目,請先聯絡服務商。
- 檢查連結是否變更:如果剛重設訂閱權杖,舊 URL 可能已失效。請將 Home 中儲存的網址與新 URL 比對,不能只確認網域相同。
- 等待伺服器處理完成:剛變更方案或恢復服務時,請依服務商標示的處理時間等待後再更新。不要假設提交操作後,所有介面都會立即同步。
- 檢查請求限制:遇到
429 Too Many Requests時,請停止連續更新;若回應包含Retry-After,請依指示等待,否則詢問服務商允許的更新間隔。
不要把「每隔幾秒重新整理一次」當成排查方法。頻繁請求可能觸發流量限制,讓原本的格式問題又多了存取問題。若舊項目仍可使用,可以先保留,等確認新訂閱內容有效後再整理重複記錄。
判斷方式:帳戶頁面也空白時,先處理伺服器端狀態
若帳戶頁面沒有可用項目,或服務商確認訂閱介面尚未產生資料,繼續切換協定、規則或 DNS 也無法產生節點。請先讓服務商確認介面能回傳有效資料,再返回 Home 更新。
五、一次只改一項,測試網路與連線狀態
請求逾時、網域解析失敗與 TLS 錯誤發生在不同階段。逾時可能是連線未建立,也可能是回應遲遲未完成;遇到憑證錯誤時,應檢查系統時間、目標網域與伺服器憑證,不能用略過憑證檢查來取代排查。一次只變更一項條件,才能比較前後結果。
-
記錄目前狀態
記下目前使用 Wi-Fi 或行動網路、Home 連線開關的狀態、Global Routing 目前選項,以及實際錯誤訊息。不要同時變更 DNS 與規則。
-
切換網路
保持訂閱 URL 與連線狀態不變,分別切換 Wi-Fi 與行動網路,各更新一次。若只有其中一種網路失敗,優先檢查該網路的登入驗證、DNS 或存取限制。
-
檢查自動連線
若手動關閉連線後又自動連線,請前往 Settings → On Demand 檢查是否啟用了觸發條件。先記錄原設定,再暫時停用自動連線進行測試,完成後還原設定。
-
比較連線前後結果
只有在已有可用節點時,才比較中斷與連線狀態下的更新結果。請勿使用尚未成功匯入的訂閱建立連線,也不要假設訂閱請求必定透過所選節點傳送。
Global Routing 下的 Config、Proxy、Direct、Scene 會影響流量處理方式,但不會將網頁轉換成節點。Config 中的 DOMAIN-SUFFIX、GEOIP、IP-CIDR 與 FINAL 是規則關鍵字,不是修復訂閱解析的開關。遇到清單空白時,請先檢查回應內容,再判斷是否需要檢查規則與流量出口。
「能開啟服務商首頁」只表示目前環境可以存取該網頁,不能證明訂閱介面、重新導向目標及其身分參數都能正常使用。比較測試結果時,應針對同一筆訂閱請求記錄。
六、何時聯絡服務商,以及應提供哪些資訊
若最新連結持續回傳驗證錯誤、帳戶頁面有項目但介面回應空白,或使用服務商指定格式仍無法解析,請聯絡自己的服務商。請其確認介面權限、回應內容、格式相容性與請求記錄,比反覆刪除本機記錄更能釐清問題。
- 時間:提供發生日期、具體時間與時區,方便比對伺服器記錄。
- 操作:說明是在 Home 新增 Subscribe 後首次更新,還是原有訂閱在手動重新整理時發生錯誤。
- 狀況:逐字保留錯誤訊息,並說明原有項目是否仍在、目標群組是否已展開,以及清單是否始終空白。
- 環境:提供系統類型、網路類型、連線狀態與一次只改一項的測試結果,不必提供其他應用程式的帳戶資訊。
- 安全注意事項:公開回報時只提供已遮蔽敏感資訊的網域與錯誤截圖;若需提交權杖,請只透過服務商確認的私人支援管道。
修復後返回 Home 手動更新一次,確認目標群組已顯示項目,再選取現有項目測試連線。清單出現項目與成功連線是兩項不同的驗收結果:前者用來確認訂閱取得與解析成功,後者還取決於節點位址、連接埠、協定參數及目前網路。若項目已出現但無法連線,請改查連線問題,不必繼續重建訂閱。
本文以使用者已擁有自己的服務商與訂閱為前提。本網站不提供、不銷售,也不推薦節點或訂閱。用戶端取得方式與線路服務分開處理;用戶端買斷 ≠ 線路方案。