本文適合已持有自己服務商訂閱的 Shadowrocket（小火箭）使用者。先在 Home 手動更新單一訂閱，確認連結能取得有效設定，再設定開啟時自動更新；若更新失敗，請依序檢查網路連線、連結權限與回傳內容。更新伺服器清單不等於更新 Config，也不會延長服務期限。
一、分清訂閱更新與連線測試
訂閱連結是取得伺服器設定的入口。更新時，Shadowrocket 會向該網址提出請求、解析其中的伺服器參數，並更新 Home 中對應的訂閱群組。請求能否完成，取決於訂閱網址、目前網路及服務商回傳的內容；清單中的個別伺服器能否連線，則是另一項檢查。
不要用延遲測試取代訂閱更新。延遲測試讀取的是現有伺服器資訊，不會自動取得服務商新增或替換的伺服器。反過來說，即使更新成功，仍可能有個別伺服器無法使用、帳戶額度用完或服務期限已結束。
先確認要更新的項目。若要更新服務商提供的伺服器清單，請操作 Home 中的訂閱；若要更新規則檔案，則檢查 Config 中對應設定的來源。兩者可能分別維護，更新其中一項不代表另一項也已更新。
二、在 Home 手動更新現有訂閱
先保留目前清單，不要一開始就刪除訂閱。刪除後重新匯入，會增加重新選擇伺服器、確認群組及還原設定等工作，也可能失去排查時需要比對的舊資料。初次操作時只更新一項訂閱，方便確認結果來自哪個連結。
-
找到訂閱
開啟 Home，找到自己的訂閱群組。確認群組名稱與其中已有的伺服器，避免把個別新增的伺服器項目誤認為訂閱入口。
-
開啟操作選單
在 Home 的訂閱群組標題上開啟操作選單，選擇 Update。可先長按群組標題；若目前介面以向左滑動顯示操作按鈕，請在訂閱群組列向左滑動後選擇更新，不要在個別伺服器列執行 Delete。
-
等待更新完成
讓 App 保持在前景，等待請求完成。不要連續觸發多次更新。若出現錯誤，記下完整提示與發生時間，再進行下一項檢查。
-
確認清單
檢查群組是否仍存在、項目能否展開，以及服務商明確通知有變更的伺服器是否出現。若內容沒有變化，先確認遠端是否真的提供了新內容。
-
重新測試連線
確認目前選取的伺服器仍然有效，再連線並瀏覽同一個測試頁面。分別記錄「更新是否成功」與「伺服器是否可用」，避免混淆兩項結果。
三、設定開啟時自動更新
先手動更新一次，再設定自動更新。如此可先確認訂閱連結有效，避免每次開啟 App 都重複觸發相同錯誤。開啟時自動更新屬於訂閱管理功能，不是連線開關，也不是規則模式。
-
前往設定
開啟 Settings → Subscribe，找到 Update On Open。請以目前安裝版本實際顯示的訂閱設定為準，不要在 Config 中修改規則來取代這個開關。
-
啟用選項
啟用 Update On Open。若頁面也提供更新間隔等條件，請一併確認說明；是否實際送出請求，需依這些條件判斷。
-
返回確認
網路可用時重新開啟 App，返回 Home 查看更新狀態。若要立即確認某項訂閱，仍可手動執行一次 Update，不必等待自動更新觸發。
不要將 Update On Open 誤解為固定週期的背景工作。離開 App、鎖定螢幕或只看到系統 VPN 狀態，都不能證明訂閱持續在背景更新。從背景切回前景時，也不要只憑這個動作就認定已完成一次請求。
- Update On Open：控制開啟 App 時的訂閱更新行為，仍會受到網路及相關更新條件影響。
- Settings → On Demand：用於設定隨選連線，不會取代訂閱中的伺服器清單。
- Global Routing：包含 Proxy、Direct、Config、Scene 等選項，用來控制流量處理方式，並非訂閱更新頻率設定。
四、依錯誤提示分辨連結與網路問題
更新失敗時，先保存錯誤訊息，再判斷問題發生在哪個環節。以下列出可能遇到的請求錯誤或 HTTP 狀態範例；實際提示可能因系統語言、網路環境及服務商回應而異。不要為了消除提示，一再刪除並重新匯入同一個連結。
錯誤：The request timed out.
原因與處理方式：請求未能在允許時間內完成，可能是網路中斷、網址無法連線或遠端回應過慢。先確認一般網頁能否開啟，再改用另一個可信任的網路重試同一項訂閱，比較結果。
錯誤：Could not connect to the server.
原因與處理方式：無法連線至目標伺服器，可能與遠端服務、網路限制或連線路徑有關。確認訂閱網域名稱是否完整，再向自己的服務商確認訂閱入口目前是否可用。
錯誤：HTTP 401 Unauthorized
原因與處理方式：遠端拒絕了目前請求所用的身分憑證。請登入自己的服務商帳戶，確認訂閱權限與目前使用的連結，並確認連結是否已重設；不要自行猜測或拼接 token。
錯誤：HTTP 403 Forbidden
原因與處理方式：伺服器收到請求，但拒絕存取；可能與權限、存取來源或防護政策有關。記下發生時間與使用的網路，請服務商確認限制條件；單憑 403 無法判斷服務一定已到期。
連結重設後，舊連結可能已失效。請從自己的服務商帳戶重新複製目前的訂閱網址，替換對應訂閱的 URL，再手動更新。複製時確認網址前後沒有空格或換行，且查詢參數完整，不要只保留網域名稱。
五、請求成功但清單異常時的檢查順序
網路請求成功，不代表回傳內容一定是有效訂閱。遠端可能回傳登入頁面、驗證頁面或帳戶狀態提示。即使 HTTP 狀態為 200，本文內容也可能是 HTML，而不是 Shadowrocket 能解析的伺服器設定。這時繼續切換伺服器通常無法解決解析問題。
| 觀察到的狀況 | 優先確認 | 下一步 |
|---|---|---|
| 更新完成，但項目沒有變化 | 遠端內容是否確實有變更 | 比對服務商通知中的具體項目，不要以數量變化判斷結果。 |
| 出現解析失敗或沒有可用項目的提示 | 網址是否為訂閱入口，以及是否回傳網頁 | 從自己的帳戶重新複製適用於 Shadowrocket 的訂閱網址。 |
| 清單正常，但連線仍失敗 | 目前伺服器、服務期限與帳戶額度 | 將連線問題與訂閱請求分開處理，向服務商確認該伺服器的狀態。 |
| 一個網路無法更新，另一個網路可以 | 網路驗證、網域名稱解析與存取限制 | 保留相同訂閱與設定，比較不同網路的差異，不要同時變更多個條件。 |
協定名稱也不能保證更新成功。Shadowsocks、VMess、VLESS、Trojan、Hysteria2、WireGuard 描述的是不同的連線設定；訂閱請求負責取得這些設定，不會自動修正錯誤的連接埠、密碼、UUID 或 TLS 參數。若服務商提供的內容本身有誤，應先確認來源。
- 使用公共 Wi-Fi 時，先完成網路要求的登入或使用確認，再更新訂閱。
- 若懷疑是 DNS 問題，先確認訂閱網域能否解析；不要直接將網域改成 IP，HTTPS 憑證與伺服器路由可能依賴原網域。
- 遇到憑證驗證錯誤時，確認裝置日期、時間與網路環境；不要將關閉憑證驗證當作一般解決方式。
- 不要透過新增
DOMAIN-SUFFIX或修改FINAL來處理已失效的連結；規則無法恢復遠端權限。
六、更新後應保留哪些檢查紀錄
每次排查只變更一個條件。先用同一個連結測試不同網路，再確認連結權限，最後檢查回傳內容。若同時更換訂閱、調整 DNS、切換 Global Routing 並刪除舊設定，即使問題排除，也很難確認是哪項操作發揮作用。
- 記錄項目：保留訂閱群組名稱，不記錄完整 token，也不要將伺服器密碼當作故障說明傳送。
- 記錄環境：註明使用 Wi-Fi 或行動網路，以及一般網頁是否能正常存取。
- 記錄結果：區分更新錯誤、清單變化與連線錯誤，並保留完整錯誤訊息及發生時間。
- 記錄變更：註明只修改了哪一項設定；若問題沒有改善，請還原原值，再測試下一項。
Shadowrocket 是 Apple 平台上的閉源商業 App，主要適用於 iPhone 與 iPad，唯一取得管道是 App Store。請確認開發者為 Shadow Launch Technology Limited，且 App ID 為 932747118；系統需求以 App Store 頁面標示為準。一次性購買 App 不等於購買連線服務，也不能取代既有服務商的訂閱授權。
若要檢查連線問題，請繼續閱讀站內問題排查；若要分辨 Subscribe、Config 與 Global Routing，請參閱名詞解釋。先確認手動更新能順利完成，再啟用開啟時自動更新，之後維護時會更容易找出問題。