Shadowrocket 訂閱更新失敗怎麼辦：手動更新、開啟時自動更新與排查步驟

先釐清：訂閱更新失敗，還是連線失敗

Shadowrocket（小火箭）的訂閱更新，是透過使用者提供的網址取得伺服器資訊，再整理至 Home 清單的過程。這不是更新 App 本身，也不代表已連上某個伺服器。清單仍顯示舊項目，只能表示本機仍有已儲存的資料，無法證明這次更新成功。

先記下問題發生的步驟：重新整理後立即出現提示、等待一段時間後逾時，還是顯示更新完成但沒有新增項目。若更新已完成，只是某個伺服器無法連線，請改用連線測試排查，不要反覆刪除並重新新增訂閱。

這個流程也能解釋兩種常見情況：舊伺服器仍可連線，但訂閱網址已失效；訂閱可以正常更新，但其中某個伺服器暫時無法使用。兩者並不矛盾。前者發生在取得清單時，後者則是取得清單後的使用問題。

手動更新：從 Home 開始，保留原有訂閱

先手動更新一次，方便查看完整結果。不要一開始就重新新增訂閱：重複匯入相同網址，可能讓 Home 出現多個來源群組，也會增加判斷難度。若需要重新輸入網址，請優先確認並編輯現有訂閱。

1. 找到訂閱

   前往 Home，確認要更新的訂閱群組。記下群組名稱與目前項目數量，以免將個別新增的伺服器誤認為訂閱項目。

2. 確認網址

   開啟該訂閱的編輯頁面，確認 URL 是否與服務商提供的網址一致。首次匯入的路徑為 Home → 右上角「+」→ Type → Subscribe；已有訂閱就不必再新增一份。

3. 下拉重新整理

   返回 Home，在清單頂端下拉以觸發更新，並等待本次要求完成。若有多份訂閱，請分別確認各群組的結果，不要將其中一組成功視為全部成功。

4. 確認結果

   記下成功或失敗提示，再檢查目標群組。項目數量沒有變化，可能只是遠端內容未更新；是否已完成要求與解析，應參照更新提示判斷。

開啟時自動更新：在 Settings 中設定

自動更新可減少日常手動操作，但無法修復失效連結。建議先確認手動更新成功，再啟用開啟時更新。前往 Settings → Subscribe，找到 Update On Open 並開啟；介面文字的大小寫或位置可能因 App 調整而異，請以實際畫面為準。

這項設定是在開啟 App 時觸發訂閱更新，不應解讀為固定間隔、持續在背景執行的更新工作。切回 App 後若無法確認是否已更新，直接返回 Home 手動重新整理並檢查結果，比反覆切換開關更容易判斷。

• 先確認開關：Settings → Subscribe → Update On Open。請勿在 Config 中尋找伺服器清單的自動更新設定。
• 接著確認是否生效：啟用後重新開啟 App，等待要求完成，並檢查目標訂閱是否顯示更新結果；只看到 Home 頁面不代表要求成功。
• 留意目前的網路：開啟 App 時若尚未連上網路，或所連 Wi-Fi 仍需驗證，自動更新也可能失敗。網路恢復後再手動重新整理一次。
• 勿混淆功能：Settings → On Demand 用於管理隨需連線，不能取代 Subscribe 中的更新選項。啟動連線與更新訂閱是不同操作。

若自動更新失敗，但手動更新成功，請先比較兩次操作時的網路條件與連線狀態。開啟 App 時可能正好遇上 Wi-Fi 與行動網路切換。單次結果不同不足以證明設定失效，請在相同網路下再次確認。

第一步：檢查訂閱連結失效與權限變更

首先向自己的服務商確認訂閱網址仍有效。不要以網頁登入網址取代訂閱網址，也不要憑記憶刪除查詢參數。看似很長的 URL 可能同時包含帳號識別資訊、存取憑證與輸出格式選項，少一個參數就可能得到不同結果。

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

以上僅為不可用於實際匯入的範例。實際排查時，請在本機逐字核對網址與來源，尤其檢查開頭的通訊協定、網域、路徑、問號後的參數，以及複製時帶入的空格或換行。請勿將真實網址貼到公開頁面或不明轉換工具。

• 網址已重設：若服務商重新產生訂閱連結，舊 token 可能已失效。請將新的完整網址存入現有訂閱，再重新整理。
• 存取權限變更：帳戶狀態、服務期限或服務商的存取限制，都可能影響訂閱回應。購買用戶端不會取代這些權限。
• 回傳 401 或 403：若錯誤詳情顯示這些 HTTP 狀態碼，請優先確認授權與存取限制；不能只憑數字就認定原因相同。
• 回傳 404：確認完整路徑及訂閱入口是否已變更。此時盲目修改伺服器連接埠，通常無法解決訂閱介面的路徑問題。
• 回傳 429：停止連續重新整理，依服務商說明等待後再試。頻繁重試可能持續觸發要求頻率限制。

瀏覽器可以開啟同一網域的首頁，不代表訂閱介面有效。首頁與訂閱路徑可能採用不同的權限檢查；跳轉至登入頁面也不等於取得伺服器清單。判斷時應查看完整訂閱 URL 的回應，而不是只確認網域能否連線。

第二步：檢查目前網路與要求逾時

確認連結有效後，再檢查裝置能否穩定連線至訂閱網址所在的主機。先完成 Wi-Fi 網頁驗證，確認一般頁面可正常載入，再比較 Wi-Fi 與行動網路。每次只變更一個條件，避免同時更改網址、模式與網路而失去比較基準。

上述英文是排查時可能出現的提示；顯示內容會因系統語言與錯誤來源而異。請勿只為了對照某句錯誤訊息而忽略詳細資訊。若出現憑證相關提示，也應確認裝置日期與時間，並請服務商檢查憑證；不要透過略過憑證驗證來繞過問題。

1. 在系統設定中確認目前網路已連線；若 Wi-Fi 需要網頁驗證，請先完成驗證。
2. 記下 Shadowrocket 目前的連線狀態與 Global Routing 選項，先在原有狀態下重新整理一次。
3. 只切換 Wi-Fi 或行動網路，再重新整理同一份訂閱並比較結果。
4. 若懷疑目前連線影響要求，請在可控情況下中斷連線後再測試；若已啟用 On Demand，請留意它是否再次觸發連線。

Global Routing 中的 Proxy、Direct、Config、Scene，是選擇整體流量的處理方式，不是「修復訂閱」按鈕。不要為了更新單一網址而長期強制變更所有流量的處理方式，也不要未經驗證就新增 DIRECT 規則。訂閱要求實際採用的路徑，需依目前連線與設定判斷。

第三步：檢查回傳內容與無法辨識的格式

網路要求完成後，仍可能沒有可匯入的項目。HTTP 回應 200 只表示要求在 HTTP 層級成功，回傳內容仍可能是登入頁、維護頁、錯誤說明，或目前匯入入口無法辨識的資料。此時繼續更換網路未必有幫助。

• 先確認匯入入口：Home →「+」→ Type → Subscribe 用於匯入訂閱。Config 用來管理設定檔，不應將完整設定檔網址與伺服器訂閱網址視為同一種輸入。
• 接著確認輸出用途：告知自己的服務商正在使用 Shadowrocket，並確認對方提供的訂閱輸出適用於目前的匯入方式。不要只憑副檔名判斷。
• 檢查是否沒有結果：回傳內容為空，或內容中沒有可辨識的伺服器項目，都可能導致清單無法如預期更新。請服務商確認回應內容，不要先清空本機清單。
• 檢查項目是否完整：Address、Port 以及協定所需的驗證資訊，都必須與伺服器端設定相符。訂閱可讀取，不代表每個項目的參數都完整可用。

Shadowsocks、VMess、VLESS、Trojan、Hysteria2、WireGuard 是協定名稱；Subscribe 是匯入訂閱的類型。兩種服務即使使用相同協定，也不代表訂閱封裝格式相同。協定、訂閱格式與完整設定結構屬於不同層次。

更新後的收尾：驗證項目，再處理重複內容

更新成功後，先查看目標群組，再選擇其中一個項目測試連線。Connectivity Test 可協助觀察特定測試條件下的可連線性與延遲，但不是頻寬測試；單一數值也無法證明所有網站或服務都正常。

1. 確認更新結果：檢查目標群組名稱與項目變化。若服務商沒有變更內容，數量與名稱維持不變也可能是正常情況。
2. 測試特定連線：選取現有項目，執行 Connectivity Test，再實際開啟需要存取的頁面。分別記錄清單是否更新成功，以及頁面是否能正常存取。
3. 確認重複來源：若同一份訂閱曾匯入多次，先確認哪個群組保留了正確網址，再移除多餘群組；不要只憑伺服器顯示名稱判斷是否重複。
4. 保留維護記錄：記下這次變更的是 URL、網路還是自動更新設定。下次遇到相同情況時，就能直接從相應環節開始檢查。

若仍無法更新，請向自己的服務商提供網路類型、失敗時間、完整錯誤訊息與已嘗試的步驟，並透過其私密支援管道確認訂閱權限。若提供公開截圖，請遮住憑證。這些資訊比只說「無法更新」更能協助判斷問題出在網址、介面回應還是格式。

Shadowrocket 是一次買斷的閉源商業 App，主要適用於 iPhone 與 iPad，唯一取得管道為 App Store。系統需求請以 App Store 頁面標示為準。買斷用戶端 ≠ 線路方案，購買 App 不會自動取得伺服器或訂閱。本站僅說明如何管理使用者已有的訂閱，不提供、不販售或推薦節點與訂閱。