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

匯入訂閱後若出現錯誤或清單空白,請依序檢查連結格式、服務商端狀態、更新時機與網路環境,並了解何時該聯絡服務商。

本文重點

本文適用於已持有自身服務商訂閱連結的使用者。先區分「請求失敗」、「內容無法解析」與「請求成功但沒有可用項目」,再檢查 Subscribe 的 URL、服務商回傳內容與更新時機,最後一次只改一個條件來測試網路。排查期間請保留現有設定,不要先刪除仍可使用的項目。

一、先確認問題發生在哪個環節

Shadowrocket(小火箭)更新訂閱時,會向指定 URL 請求內容,再將支援的節點資料轉換為 Home 中的項目。訂閱連結可以儲存,不代表伺服器已回傳有效內容;伺服器回應成功,也不代表內容一定包含可解析的節點。

讀取連結向伺服器發出請求接收內容解析資料顯示項目

記下目前的狀況:是新增時立即顯示失敗,還是更新等待後逾時;是原有項目仍在但更新失敗,還是新建的訂閱群組始終空白。舊項目仍存在,只能表示本機先前儲存過資料,無法證明這次更新成功。節點可以連線,也不代表訂閱網址目前仍有效。

3 個環節
分別檢查請求、解析與清單顯示
4 個步驟
連結、服務狀態、更新時機、網路
1 個條件
每次只變更一個測試條件

判斷方式:先記錄狀況,再調整設定

先記下錯誤訊息原文與操作時間,再手動更新一次。若直接刪除訂閱、切換設定並重新安裝應用程式,就無法判斷是哪項變更影響結果。

二、檢查 Subscribe 中儲存的連結

訂閱 URL 應由你使用的服務商提供,不能以帳戶登入頁、訂單頁或網頁分享頁取代。以下網址僅為格式範例,不能用來匯入。URL 中的路徑與查詢參數可能共同用於識別帳戶,不能只複製網域。

https://example.com/sub?token=xxxx
  1. 複製原始連結

    前往自己的服務商帳戶頁面,使用訂閱複製功能,並選擇標示適用於 Shadowrocket 的格式。請勿從截圖辨識連結,也不要連同頁面標題一起複製。

  2. 確認新增位置

    在 Home 右上角點選「+」,將 Type 設為 Subscribe,再把完整網址貼到 URL。若已有訂閱,請先檢查原有記錄,不必重複新增相同群組。

  3. 檢查網址字元

    確認開頭的 https://、結尾參數與複製前一致,並移除網址前後的空格、換行或引號。保留參數中的原有字元,不要任意刪改 ?、&、= 或百分比編碼。

  4. 儲存並更新

    儲存後返回 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,而訂閱請求並不等同於已登入的網頁工作階段。

四、確認服務商狀態與更新時機

訂閱群組空白,可能是伺服器目前沒有為帳戶配置可用項目,也可能是訂閱輸出尚未與帳戶頁面的狀態同步。帳戶餘額、方案狀態、裝置限制與訂閱權限是不同欄位,應以服務商的實際說明為準;Shadowrocket 中的空清單本身無法證明其中任何一項。

  1. 檢查帳戶:登入自己的服務商頁面,確認服務狀態、有效期限,以及頁面上是否有可用項目。若帳戶頁面本身沒有項目,請先聯絡服務商。
  2. 檢查連結是否變更:如果剛重設訂閱權杖,舊 URL 可能已失效。請將 Home 中儲存的網址與新 URL 比對,不能只確認網域相同。
  3. 等待伺服器處理完成:剛變更方案或恢復服務時,請依服務商標示的處理時間等待後再更新。不要假設提交操作後,所有介面都會立即同步。
  4. 檢查請求限制:遇到 429 Too Many Requests 時,請停止連續更新;若回應包含 Retry-After,請依指示等待,否則詢問服務商允許的更新間隔。

不要把「每隔幾秒重新整理一次」當成排查方法。頻繁請求可能觸發流量限制,讓原本的格式問題又多了存取問題。若舊項目仍可使用,可以先保留,等確認新訂閱內容有效後再整理重複記錄。

判斷方式:帳戶頁面也空白時,先處理伺服器端狀態

若帳戶頁面沒有可用項目,或服務商確認訂閱介面尚未產生資料,繼續切換協定、規則或 DNS 也無法產生節點。請先讓服務商確認介面能回傳有效資料,再返回 Home 更新。

五、一次只改一項,測試網路與連線狀態

請求逾時、網域解析失敗與 TLS 錯誤發生在不同階段。逾時可能是連線未建立,也可能是回應遲遲未完成;遇到憑證錯誤時,應檢查系統時間、目標網域與伺服器憑證,不能用略過憑證檢查來取代排查。一次只變更一項條件,才能比較前後結果。

  1. 記錄目前狀態

    記下目前使用 Wi-Fi 或行動網路、Home 連線開關的狀態、Global Routing 目前選項,以及實際錯誤訊息。不要同時變更 DNS 與規則。

  2. 切換網路

    保持訂閱 URL 與連線狀態不變,分別切換 Wi-Fi 與行動網路,各更新一次。若只有其中一種網路失敗,優先檢查該網路的登入驗證、DNS 或存取限制。

  3. 檢查自動連線

    若手動關閉連線後又自動連線,請前往 Settings → On Demand 檢查是否啟用了觸發條件。先記錄原設定,再暫時停用自動連線進行測試,完成後還原設定。

  4. 比較連線前後結果

    只有在已有可用節點時,才比較中斷與連線狀態下的更新結果。請勿使用尚未成功匯入的訂閱建立連線,也不要假設訂閱請求必定透過所選節點傳送。

Global Routing 下的 Config、Proxy、Direct、Scene 會影響流量處理方式,但不會將網頁轉換成節點。Config 中的 DOMAIN-SUFFIX、GEOIP、IP-CIDR 與 FINAL 是規則關鍵字,不是修復訂閱解析的開關。遇到清單空白時,請先檢查回應內容,再判斷是否需要檢查規則與流量出口。

「能開啟服務商首頁」只表示目前環境可以存取該網頁,不能證明訂閱介面、重新導向目標及其身分參數都能正常使用。比較測試結果時,應針對同一筆訂閱請求記錄。

六、何時聯絡服務商,以及應提供哪些資訊

若最新連結持續回傳驗證錯誤、帳戶頁面有項目但介面回應空白,或使用服務商指定格式仍無法解析,請聯絡自己的服務商。請其確認介面權限、回應內容、格式相容性與請求記錄,比反覆刪除本機記錄更能釐清問題。

修復後返回 Home 手動更新一次,確認目標群組已顯示項目,再選取現有項目測試連線。清單出現項目與成功連線是兩項不同的驗收結果:前者用來確認訂閱取得與解析成功,後者還取決於節點位址、連接埠、協定參數及目前網路。若項目已出現但無法連線,請改查連線問題,不必繼續重建訂閱。

本文以使用者已擁有自己的服務商與訂閱為前提。本網站不提供、不銷售,也不推薦節點或訂閱。用戶端取得方式與線路服務分開處理;用戶端買斷 ≠ 線路方案。

Shadowrocket 官方下載