Shadowrocket 訂閱匯入失敗或節點清單為空:檢查連結格式與更新時機

Shadowrocket 訂閱解析失敗或清單為空?依序檢查連結格式、服務商狀態、更新時機與網路,再了解正確的重新匯入方式。

本文重點

本文適合已經有服務商和訂閱連結的使用者。先分辨是下載失敗、內容無法解析,還是解析後沒有可用項目,再檢查連結、帳號狀態、更新時機與連線路徑。排查期間請保留原訂閱和現有連線;確認新連結能取得有效清單後再替換,避免刪除唯一可用的連線。

先分辨:請求失敗、解析失敗,還是清單遭隱藏

Shadowrocket(小火箭)的訂閱更新不只一個步驟。App 會先連線至訂閱網址,由伺服器回傳內容,再由 App 辨識內容並在 Home 顯示項目。任何一步出錯,都可能看起來像是「匯入後沒有節點」,但處理方式各不相同。連線開關是否開啟,也不能單獨證明訂閱網址可正常存取。

讀取連結 向伺服器提出請求 接收內容 解析項目 顯示清單

先回到 Home,清除搜尋條件並展開對應的訂閱群組。若項目其實存在,只是連線測試失敗,應檢查連線參數與線路狀態,不要反覆刪除訂閱。若清單確實為空,請留意更新時的提示,確認是未收到內容,還是收到內容後無法辨識。

第一步:檢查連結是否完整、類型是否正確

訂閱連結請向你的服務商取得。請使用服務商明確標示適用於 Shadowrocket 的訂閱網址,不要使用帳號中心、方案詳細頁,或登入瀏覽器後顯示的頁面網址。以下僅以虛構值說明 URL 組成,並非可用的訂閱連結。

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

其中 https:// 是協定,example.com 是網域,/sub 是路徑,token=xxxx 是查詢參數。實際連結的路徑與參數名稱可能不同,請勿照著範例修改。尤其不要刪除問號後方的內容,也不要把訂閱網址誤填到某部伺服器的 Address 或 Port 欄位。

  1. 請從服務商頁面重新複製完整的訂閱連結,確認開頭與結尾沒有多出空格、換行、引號或中文標點。
  2. 確認連結中的 & 是否被複製成字面文字 &;後者可能會改變參數的意思。請重新複製原始網址,不要未經確認就全面取代字元。
  3. 如果取得的是以 ss://、vmess:// 或 vless:// 開頭的單一分享連結,請將它當成單一伺服器資訊處理,不要當作 HTTPS 訂閱網址。
  4. 在 Home 的 Add Server 中選擇對應的訂閱類型;訂閱類型通常會顯示為 Subscribe。將連結貼到 URL 欄位並儲存,再執行該訂閱的更新。

第二步:確認服務商回傳的是訂閱內容

連結能在瀏覽器中開啟,不代表回傳的內容可供解析。瀏覽器可能顯示登入頁、驗證頁或提示文字;App 需要的是格式相符的訂閱內容。即使回應狀態為 200,如果本文是 HTML 頁面,仍可能無法解析。不要只因為「頁面開得起來」就排除伺服器問題。

200
HTTP 請求成功,不代表回傳內容就是有效訂閱
401 / 403
確認驗證資訊有效,並檢查伺服器存取政策
429
請求受到頻率限制時,請停止連續更新

如果更新提示或診斷紀錄包含以下 HTTP 狀態列,可依照對應方向處理。這些是伺服器可能回傳的標準回應,不代表每個平台都會顯示完全相同的錯誤文字。

HTTP 401 Unauthorized

原因與處理方式:伺服器未接受目前的驗證資訊。先前往你使用的服務商頁面確認訂閱權限,再重新複製目前有效的連結,避免繼續使用已重設的 token。

HTTP 403 Forbidden

原因與處理方式:伺服器拒絕了目前的請求,可能與存取政策或驗證要求有關。記下發生時間和使用的網路,向你的服務商確認限制條件,不要反覆重試來猜測原因。

HTTP 429 Too Many Requests

原因與處理方式:請求觸發了頻率限制。請停止手動連續更新;若回應提供 Retry-After,請依照指示等待,否則依服務商說明決定下次更新時間。

清單為空也可能是帳號權限尚未生效、服務商已清除可提供的項目,或選用了不適用的訂閱格式。請前往你使用的服務商頁面確認帳號狀態與可用項目,再確認應複製哪一種格式。Shadowsocks、VMess、VLESS、Trojan、Hysteria2、WireGuard 所需欄位各不相同;只把 Type 改成另一個名稱,並不會自動轉換協定內容。

結論:先確認回應內容,再調整 App 設定

若同一網址回傳登入頁、錯誤訊息或空清單,應先處理伺服器端狀態;修改 Global Routing 或連線埠,無法將這些內容變成有效訂閱。

第三步:依狀態選擇更新時機

重設訂閱連結、變更帳號權限或服務商調整清單後,舊網址與舊內容可能已不再適用。更新前請先確認服務商頁面已顯示預期狀態,再複製新連結。購買、續訂或重設後需要等待,不代表 App 一定得重新安裝。

  1. 首次匯入:儲存項目後,手動執行一次訂閱更新,確認是否產生伺服器清單,不要只看訂閱名稱有沒有出現。
  2. 重設連結後:編輯原訂閱的 URL,或新增一個容易辨識的測試訂閱,並使用新的完整連結。更新不會讓舊 token 自動恢復。
  3. 權限剛變更:先確認服務商頁面上的變更是否已生效;若清單仍為空,請依服務商說明等候,不要自行假設固定的生效時間。
  4. 沒有自動更新:回到 Home 手動更新一次並記錄結果。背景作業會受系統排程與當下網路狀況影響,自動更新不保證一定會在固定時間完成。

每次測試只改變一個條件,並記下「使用哪個連結、哪種網路、連線是否開啟、出現什麼提示」。這樣才能分辨結果變化是由更換連結還是切換網路造成。連續點選更新不但難以找出問題,也可能觸發頻率限制。

第四步:分開測試訂閱請求與代理連線

訂閱伺服器與實際代理伺服器可能使用不同的網域、連接埠和存取路徑。已有項目可以連線,不代表訂閱網域一定能存取;反過來說,訂閱更新成功,也不保證回傳的每個項目都能使用。測試時請先確認「能否下載清單」,再測試連線。

Home → Global Routing 中的 Proxy、Direct、Config、Scene 是轉送模式,不是訂閱內容格式。Config 會使用目前的設定規則,Scene 則依照已設定的場景行為運作。Settings → On Demand 可管理符合條件時的連線,但無法自動修正錯誤 URL、過期 token 或空白回應。排查期間請記下原有設定,測試結束後再恢復所需狀態。

重新匯入:先驗證新項目,再清理舊項目

重新匯入適合用來排除舊 URL、選錯類型或項目儲存錯誤等問題,但並非所有訂閱故障的通用解法。刪除訂閱時,底下的伺服器也可能一併移除;若它們仍用於目前連線,請先保留,避免排查期間失去連線途徑。

  1. 記下原訂閱名稱與必要設定,並妥善保存自己的有效連結。請勿將含有驗證資訊的備份放在公開位置。
  2. 向你使用的服務商重新取得適用的連結,在 Home → Add Server 中選擇 Subscribe,並將完整網址填入 URL。
  3. 使用與舊項目不同的備註,例如「訂閱檢查」,儲存後更新該訂閱。
  4. 展開新的群組,確認至少看得到預期的伺服器項目。接著核對項目的協定類型和服務商提供的連接埠,不要把 HTTPS 訂閱常用的 443 連接埠直接套用到所有代理伺服器。
  5. 選擇一個項目進行連線測試,確認實際存取結果符合預期;最後再刪除重複或失效的訂閱,並保留需要的 Config 與策略參照。

如果新舊訂閱使用相同網址,而且在同一個網路下都回傳空清單,重複新增通常不會改變結果。請整理回應提示、測試時間、網路類型,以及是否曾重設連結,再聯絡你的服務商確認。提交截圖前,請遮住 token、UUID、密碼等驗證資訊。

訂閱清單為空與更新失敗的常見問題

瀏覽器能開啟訂閱連結,為什麼匯入還是失敗?

先確認開啟後顯示的是訂閱內容,還是登入、驗證或錯誤頁面。瀏覽器的登入狀態不一定能由 App 的請求共用。請回到你使用的服務商頁面,複製適用於 Shadowrocket 的訂閱網址,不要複製帳號中心網址。

更新成功但沒有節點,需要先刪除並重新安裝嗎?

先清除 Home 的搜尋條件並展開訂閱群組,再確認服務商帳號下確實有可提供的項目。確認連結和回應內容後,再新增測試訂閱。重新安裝不會改變伺服器回傳的空內容,還可能導致本機設定遺失。

節點還在,但訂閱一直更新失敗,舊節點還能用嗎?

現有項目能否使用,取決於伺服器與驗證資訊是否仍有效;更新失敗不代表它們會立即失效。請先保留舊項目並測試連線,同時單獨檢查訂閱網址,不要急著清空清單。

把 Global Routing 改成 Proxy 就一定能更新嗎?

不一定。還要看目前是否有可用連線,以及訂閱更新請求採用哪種路徑。先使用相同 URL,比較連線開啟與關閉時的結果;若問題出在失效 token、錯誤內容或伺服器回傳空清單,變更轉送模式也無法解決。

下載 Shadowrocket