Shadowrocket(小火箭)訂閱更新失敗時,請先保留現有記錄,手動重新整理一次並記下提示,再依序檢查連結、網路路徑及回傳格式。本文以使用者已有自己的服務商與訂閱為前提,說明 Home 的重新整理操作、Settings → Subscribe 的自動更新設定,以及如何區分「訂閱未更新」與「節點無法連線」。以下以 iPhone / iPad 介面為操作基準,其他平台的選項位置可能不同。
先區分訂閱更新與連線測試
訂閱更新會向訂閱網址發出請求,取得內容後解析為伺服器記錄;連線測試則使用某筆記錄中的位址、連接埠與通訊協定參數建立連線。這是兩條不同的檢查流程。現有節點能連線,不代表訂閱網址仍有效;訂閱重新整理成功,也不代表清單中的每個節點都能連線。
Home 顯示伺服器記錄與連線狀態,Config 主要用來管理規則設定檔。請勿將 Config 中遠端設定檔的更新,誤認為 Home 中伺服器訂閱的更新。排查前先確認發生問題的項目,避免為了修復訂閱而替換整份規則檔。
在 Home 手動更新訂閱
第一次排查建議手動更新,方便直接查看提示。請勿先刪除訂閱:現有記錄可能仍可用來連線,刪除後若無法重新取得,反而會失去可用的測試條件。請先記下訂閱群組名稱、目前記錄數量及錯誤提示,再依照以下步驟操作。
-
確認群組
開啟 Home,找到需要更新的訂閱群組。如果有多個訂閱,先確認這次要檢查哪一組,避免將另一個群組的變動誤認為更新成功。
-
檢查連結
進入該訂閱的編輯畫面,確認 URL 是否完整。首次新增時,操作路徑為 Home → 右上角「+」→ Type → Subscribe;已有記錄時請優先編輯,避免重複建立。
-
下拉重新整理
返回 Home,在清單頂端向下滑動後放開,觸發訂閱更新。等待本次請求完成,再查看成功或失敗提示;連續下拉可能增加遭到限流的機率。
-
確認結果
查看目標群組是否仍有記錄,以及名稱與數量是否符合預期。若顯示成功但數量不變,可能只是遠端內容沒有變動,不應只憑數量判斷失敗。
如果更新後清單變成空白,請先停止重複更新。記下當時的提示,並向自己的服務商確認訂閱是否確實回傳空清單,以及可用記錄範圍是否有變更。重新新增相同連結無法修復遠端內容問題。
設定開啟時自動更新
前往 Settings → Subscribe,找到 Update on Open 並啟用。此設定會在開啟應用程式時嘗試更新訂閱,適用於已確認手動更新正常的情況。啟用後先離開應用程式,再重新開啟並查看更新結果;僅在 Home 與 Config 頁面間切換,不應作為驗證自動更新的唯一依據。
- 先手動,再自動:手動重新整理仍然出錯時,請先排查請求失敗的原因;自動更新無法補上失效連結,也無法修正錯誤的回傳內容。
- 自動更新不等於定時更新:Update on Open 不代表應用程式關閉後會持續在背景定時發出請求。系統背景排程、網路狀態及應用程式執行狀態都會影響實際執行。
- 代理路徑需另外設定:Settings → Subscribe → Update via Proxy 用來控制更新請求是否嘗試透過代理傳送,與 Update on Open 的觸發時機是不同的設定。
- 按需連線需另外檢查:Settings → On Demand 管理依條件連線的行為,不負責修復訂閱 URL,也不是訂閱更新計時器。
如果只有重新開啟應用程式時更新失敗,但停留幾秒後手動重新整理成功,請優先檢查剛切換 Wi-Fi 或行動網路時,網路是否尚未連線完成。可暫時關閉 Update on Open,待網路穩定後再手動測試,以區分啟動時機問題與連結本身的問題。
依錯誤提示檢查連結與存取權限
錯誤文字可能因系統語言、網路層及伺服器回應而異。以下說明常見錯誤文字或狀態碼的含義,不代表每次失敗都會顯示完全相同的提示。記下原始文字,比只記「無法更新」更有助於找出問題。
錯誤:The request timed out.
原因:請求未能在等待時間內完成,可能與連線路徑異常、遠端回應緩慢或代理路徑無法使用有關。
處理方式:先切換 Wi-Fi 與行動網路重新測試,再分別檢查直連與 Update via Proxy 路徑;每次只變更一項設定。
錯誤:A server with the specified hostname could not be found.
原因:無法解析訂閱網域,可能是網域拼寫錯誤、DNS 異常,或原網域已停用。
處理方式:確認完整網域並切換網路重試;若仍持續失敗,請向自己的服務商確認目前使用的訂閱網域。
狀態碼:HTTP 403
原因:伺服器拒絕存取,可能與連結權杖、帳戶權限或請求來源限制有關。
處理方式:在自己的服務帳戶中確認訂閱狀態與最新連結,請勿將反覆重新安裝應用程式當作處理方式。
狀態碼:HTTP 429
原因:伺服器限制短時間內的請求頻率,多部裝置同時自動更新也可能觸發限制。
處理方式:停止連續更新,依伺服器提供的等待時間再試,並減少其他裝置重複發出請求。
訂閱連結通常包含帳戶憑證。檢查時請確認問號後的參數是否完整、是否混入空格或換行,以及連結是否遭通訊軟體截斷。以下內容僅用於辨識結構,並非可用的訂閱網址;分享排查資訊時也應隱藏實際 token。
https://example.com/sub?token=xxxx
網路無法連線時,檢查更新請求路徑
一般網頁能開啟,不代表訂閱網域也能存取。不同網域可能使用不同的解析結果、存取限制或網路路徑。先保留原有設定,改用另一種網路連線方式更新同一份訂閱;如果只有某個網路會失敗,請優先檢查該網路,不要立刻修改所有節點參數。
- 記下 Settings → Subscribe → Update via Proxy 目前的狀態,先保留現有設定重新整理一次並記錄結果。
- 如果直連失敗,但現有節點仍可連線,請先在 Home 選取一筆已確認可用的記錄並連線,再啟用 Update via Proxy 重新測試。
- 如果透過代理更新失敗,請關閉 Update via Proxy,改用直連方式測試。不要預設「透過代理」一定比直連更容易成功。
- 確認 Global Routing 目前設定為 Proxy、Direct、Config 或 Scene,並記錄本次測試時的模式。不要只因連線開關已開啟,就認定所有請求都會經過代理。
- 若遇到憑證或安全連線錯誤,請確認裝置日期、時間及時區正確;不要忽略憑證錯誤來繞過驗證。
使用 Config 時,規則可能影響請求的最終路徑。請勿為了測試訂閱而隨意加入涵蓋範圍過大的 DIRECT 或 PROXY 規則。先透過少量且可復原的設定變更確認問題,再決定是否調整設定檔。
請求成功但解析失敗:確認內容格式
HTTP 請求成功只代表取得了回應,不保證回應內容是有效訂閱。遠端可能回傳登入頁面、權限說明、驗證頁面或空白文字;這些內容有時同樣使用 HTTP 200。此時持續點選更新,無法將網頁轉換成伺服器清單。
| 觀察到的情況 | 優先確認項目 | 處理順序 |
|---|---|---|
| 請求結束後顯示解析失敗 | 確認連結是用戶端訂閱,而非帳戶管理網頁 | 從自己的服務帳戶重新複製對應的訂閱連結,再編輯原有記錄。 |
| 先前正常,格式調整後失敗 | 確認伺服器是否更換輸出格式或加入不支援的欄位 | 向服務商說明使用 Shadowrocket,並提供已隱去敏感資訊的錯誤文字,以確認相容格式。 |
| 更新成功但記錄減少 | 確認遠端是否刪除記錄、調整帳戶權限或回傳空清單 | 先確認帳戶狀態與遠端內容,不要直接認定是本機解析錯誤。 |
| 清單正常但節點無法連線 | 節點位址、連接埠、通訊協定參數與有效狀態 | 改為排查連線問題,不要反覆更新同一份清單。 |
不要將錯誤頁面的全部內容複製到 Add Server。Shadowsocks、VMess、VLESS、Trojan 等記錄各有對應欄位;解析訂閱與手動填寫是不同操作。若需要手動處理,應取得自己的服務商提供的明確參數,而不是根據網頁文字猜測通訊協定或連接埠。
常見問題與排查紀錄
為什麼更新失敗,舊節點卻仍可使用?
訂閱網址與節點網址是不同的請求目標。保留舊記錄,在 Home 測試現有連線,再分別檢查訂閱 URL 的權限與網路路徑;不要先刪除整個群組。
已開啟自動更新,為什麼清單還是舊的?
先在 Home 手動下拉重新整理並查看提示,再確認 Settings → Subscribe → Update on Open。若請求成功但清單沒有變化,請確認伺服器是否確實發布了不同內容;名稱與數量不變本身無法證明自動更新失效。
換手機後,複製原連結就一定能更新嗎?
不一定。連結可能已重設,也可能受到帳戶權限或請求頻率限制。請在自己的服務帳戶中確認連結仍有效,再透過 Home →「+」→ Type → Subscribe 新增;不要在公開討論區貼出含 token 的完整網址。
更新失敗後需要重新安裝 Shadowrocket 嗎?
先不要重新安裝。請保留設定與訂閱記錄,完成切換網路、確認連結及切換更新路徑這三項測試。只有確認是本機應用程式狀態異常時,才考慮進一步處理;重新安裝不會改變伺服器拒絕存取的結果。
向自己的服務商回報時,建議提供失敗時間與時區、網路連線方式、錯誤原文、是否啟用 Update via Proxy,以及切換網路後的結果。涉及帳戶與連結的資訊,應透過其私密支援管道提交。本網站不提供、不販售、不推薦節點、訂閱或連線服務,僅說明用戶端設定與排查方法。