本文適合已在 Shadowrocket 匯入自己的訂閱的使用者。依序確認訂閱項目、手動更新、開啟 Update on Open，再根據回應排除問題；區分清單取得失敗與連線失敗，並透過一次可再次確認的手動更新檢查結果。
訂閱更新的項目與操作前提
Shadowrocket（小火箭）是 Apple 平台的付費 App，唯一取得管道為 App Store，開發者為 Shadow Launch Technology Limited，App ID 為 932747118。App 採一次買斷制，系統需求與通用購買資訊請以 App Store 頁面標示為準。買斷 App ≠ 購買連線方案；本文假設使用者已有自己的服務商與訂閱。
訂閱更新會重新請求已儲存的訂閱 URL，再讀取回應中的節點資訊。這不是更新 App 本身，也不等於更新 Config 中的規則設定。Home 中的訂閱群組、手動新增的單一節點，以及 Config 中選用的設定檔，應分別檢查；不能因為清單刷新一次，就認定所有內容都已同步。
更新前先確認操作的是哪個群組，並記下目前選取的節點名稱。更新後，原有節點可能更名、移除或修改參數；若清單變動較大，請重新選取節點。請妥善保存自己的訂閱原始網址，但不要將完整 URL 貼到公開討論區；查詢參數中的權杖通常具有存取憑證的作用。
- 已有訂閱群組：在 Home 找到該群組名稱，確認其中儲存的 URL 仍是服務商目前提供的網址。
- 只有單一節點：單獨匯入的節點不會因為更新其他訂閱而自動取得新參數，請確認節點來源與更新方式。
- 只有規則設定：Config 中更新設定檔與 Home 中更新訂閱是不同操作，請先確認實際缺少的是節點還是規則。
手動更新：先確認單一群組，再更新清單
手動更新適合在首次匯入後確認內容、服務商通知調整節點後同步，以及自動更新失敗後再次測試。先針對一個訂閱群組操作，可將問題範圍縮小至該 URL；若同時更新多個群組，請逐一確認結果，不要因為其中一組成功就認定全部成功。
- 開啟 Home，找到需要更新的訂閱群組，先記下群組名稱與目前的節點數量。
- 長按訂閱群組標題，並在操作選單中選擇 Update，等待請求完成。請注意，操作對象是群組，不是個別節點。
- 需要更新訂閱清單時，可在 Home 清單向下滑動以觸發更新；若有多個訂閱，請逐一確認是否收到結果。
- 更新後展開目標群組，檢查預期的節點是否出現、舊名稱是否變更，並再次確認目前選取的節點。
- 若畫面顯示錯誤，先保留錯誤訊息與發生時間，再依照後文檢查網址、網路路徑與回應格式；不要連續重複點選。
節點數量沒有變化，不代表更新未執行：伺服器可能回傳相同內容。反過來，節點數量增加也不代表節點可用。完整確認分兩步：先確認訂閱請求成功且內容可解析，再選取節點測試實際連線。兩步涉及不同問題，排查時請分開記錄。
開啟時自動更新：設定位置與觸發條件
前往 Settings → Subscribe，找到並開啟 Update on Open。此選項會在開啟 App 時觸發訂閱更新，不代表 App 關閉後仍會每隔固定分鐘輪詢。系統背景排程、網路可用性與 App 狀態都會影響實際請求時間。
- 先在 Home 對目標訂閱手動執行一次 Update，確認目前的 URL 能正常回傳可辨識的內容。
- 前往 Settings → Subscribe → Update on Open，開啟此選項。
- 離開 App 後再次開啟，回到 Home 查看訂閱更新結果；若沒有明確的結果可供確認，請手動更新目標群組再次驗證。
- 若開啟 App 時網路尚未就緒，請等 Wi-Fi 或行動網路可用後再試。自動觸發失敗後，不要假設清單已完成同步。
Settings → On Demand 管理的是依條件觸發連線的行為，並非訂閱自動更新開關。兩者可分別設定：開啟 On Demand 不代表已開啟 Update on Open；關閉訂閱自動更新，也不等於停用 On Demand。
| 設定或操作 | 作用對象 | 不能據此推論 |
|---|---|---|
| Home → Update | 目標訂閱中的節點內容 | 更新成功不代表節點連線成功 |
| Settings → Subscribe → Update on Open | 開啟 App 時觸發更新 | 不是固定週期的背景工作 |
| Settings → Subscribe → Update via Proxy | 訂閱請求使用的代理路徑 | 無法修復過期權杖或錯誤格式 |
| Settings → On Demand | 連線的隨選觸發條件 | 不能取代訂閱更新設定 |
建議流程：先讓手動更新成功，再啟用自動觸發
若同一個 URL 手動更新仍失敗，請先處理錯誤原因；反覆切換 Update on Open 不會改變伺服器回傳狀態或訂閱內容。
更新失敗：依序檢查網址、網路與格式
先區分「沒有收到回應」與「收到回應但無法使用」。前者優先檢查網路、DNS 與請求路徑；後者優先檢查存取權限與內容格式。以下列出常見 HTTP 回應或系統錯誤原文；實際提示可能附有更完整的上下文，請保留完整訊息以便判斷。
回應：401 Unauthorized
原因與解法：訂閱端點所需的憑證遺失、失效或不被接受。請登入自己的服務商帳戶，確認目前使用的訂閱網址，完整替換原有 URL 後再更新；不要只複製網域部分。
回應：403 Forbidden
原因與解法：伺服器拒絕此次請求，可能與帳戶狀態或存取政策有關。請先向自己的服務商確認拒絕原因；單純更換網路不一定能解決權限限制。
回應：404 Not Found
原因與解法：請求的路徑不存在，或訂閱入口已變更。請檢查 URL 是否遭截斷、路徑是否完整，並從原帳戶重新取得目前使用的網址。
錯誤：The request timed out.
原因與解法：請求未能在等待時間內完成，僅憑逾時無法判斷是哪一段連線路徑發生問題。請先切換 Wi-Fi 與行動網路重新測試，再依照下一節確認使用 Update via Proxy 的條件。
若沒有明確的 HTTP 錯誤，但更新後清單為空，請檢查伺服器實際回傳的內容。登入頁面、帳戶提示、網頁驗證頁或空白回應，都不是可直接解析的節點訂閱。即使狀態為 200 OK，也只代表 HTTP 請求成功取得回應，不代表內容符合 Shadowrocket 可辨識的訂閱格式。
- 網址完整性：檢查開頭與結尾是否包含空格、換行或多餘標點；不要自行修改查詢參數中的字元。
- 格式選擇：在自己的服務商提供的訂閱選項中，確認內容格式適用於 Shadowrocket；不要將帳戶管理頁面的網址填入訂閱 URL。
- 確認回應內容：需要協助時，提供狀態碼、錯誤訊息與發生時間；請隱藏完整訂閱 URL、權杖與節點憑證。
Update via Proxy：避免更新路徑形成循環依賴
若無法直接連線至訂閱端點，但已有節點仍可正常連線，可前往 Settings → Subscribe → Update via Proxy，啟用後再手動更新。使用前請先確認目前連線可存取網路；只有開啟選項但沒有可用的代理連線，無法建立新的可用路徑。
訂閱連結若使用 https 且未明確指定連接埠，通常會連線至 TCP 443。節點本身使用的連接埠則由其設定決定，兩者不一定相關。更新端點的 HTTPS 請求逾時，不代表必須修改節點連接埠，也不應嘗試關閉憑證驗證來規避錯誤。
- 在 Home 選擇一個現有且可用的節點並啟用連線，先確認一般網頁是否能正常瀏覽。
- 檢查 Home → Global Routing 目前選取的項目。Proxy、Direct、Config、Scene 是不同的路由模式；請勿未記錄原始設定就同時變更多個選項。
- 開啟 Settings → Subscribe → Update via Proxy，只針對更新失敗的訂閱再次執行一次 Update，並記錄結果是否有所不同。
- 若仍然失敗，請切換本地網路進行比較；若回傳 401 或 403，應重新檢查憑證與權限，而不是繼續調整路由。
更新後確認與常見問題
訂閱同步完成後，回到 Home 檢查目前選取的節點，再測試需要存取的目標。使用 Config 路由模式時，請求如何處理也取決於目前啟用的設定檔規則。訂閱更新不會自動將 Global Routing 切換至其他模式，也不保證特定網域一定透過代理連線。
已開啟自動更新，為什麼重新開啟後節點還是原來的？
伺服器可能沒有變更節點內容，也可能此次請求未能完成。請在 Home 對目標群組手動執行 Update，查看是否出現錯誤，再確認預期變更的節點名稱；不要只根據清單數量判斷。
訂閱更新成功，為什麼還是無法連線？
更新成功只代表訂閱已取得並完成解析。請重新選取節點，檢查連線開關與 Global Routing，再分別測試網路存取；若節點參數或帳戶狀態有問題，請向自己的服務商確認。
Update via Proxy 需要一直開啟嗎？
依訂閱端點實際是否可連線來決定。直連穩定時可使用直連路徑；只有代理路徑能連線時，請先確保現有連線可用再更新。切換設定前後各手動驗證一次，保留能穩定完成請求的設定。
更換訂閱網址後，需要刪除原有群組嗎？
先在現有群組的編輯頁面確認並更換網址，儲存後執行 Update。若另行匯入而產生重複群組，請先確認新群組可用，再整理舊群組，以免一併移除仍需保留的獨立節點。
需要進一步排查時，記錄五項資訊即可：目標群組、操作時間、所在網路、Update via Proxy 狀態，以及完整錯誤訊息。每一輪只變更一個條件，再手動更新一次。如此可分辨網址失效、路徑受阻或回應格式錯誤，也能避免將節點連線問題誤判為訂閱更新問題。