適用於已在 Shadowrocket（小火箭）匯入自己的訂閱連結的 iPhone、iPad 使用者。本文說明 Home 中的手動重新整理、Settings → Subscribe 中的開啟 App 時更新設定，以及如何分辨更新失敗是連結失效、請求無法連線，還是內容無法解析；判斷依據是重新整理結果，而非連線開關的狀態。
先確認：失敗的是取得訂閱，還是使用現有設定
訂閱更新是一個獨立流程：Shadowrocket 會向已儲存的訂閱網址提出請求、接收回傳內容，解析後更新 Home 中的項目。Home 仍看得到原有項目，只能表示裝置保留了上次成功匯入的資料，不能證明這次請求成功。反過來說，更新失敗也不代表所有現有連線會立即失效；這兩件事需要分開檢查。
排查前先記下失敗的是哪一組訂閱，以及重新整理時顯示的提示原文。若有多組訂閱，請逐組操作，不要根據其中一組的結果判定所有連結。接著比較重新整理前後的項目數量與更新時間：提示消失但內容沒有變化，可能只是服務商回傳了相同資料；若出現錯誤而舊項目仍在，表示這次更新沒有取得可用的新內容。
判斷順序：先確認重新整理結果
先確認是哪一組訂閱、出現什麼提示，以及舊項目是否仍在，再檢查連線狀態。不要反覆切換 Home 的連線開關，將它當作訂閱更新測試。
手動更新：逐組重新整理並核對已儲存的網址
手動更新適合用來初步排查問題，因為每操作一組，就能立即查看結果。以下步驟以使用者已持有自己的訂閱連結為前提；示意網址 https://example.com/sub?token=xxxx 僅用來說明連結格式，並非可用的訂閱。更新時請使用自己已儲存的實際網址，並確認內容完整。
找到訂閱
開啟 Shadowrocket 的 Home，找到先前匯入的 Subscribe 項目。若 Home 中有多個群組，先確認這次要更新哪一組，避免把另一組更新成功誤當成問題已解決。
手動重新整理
在 Home 對訂閱向下滑動以重新整理，並等待請求完成；提示尚未出現前，不要連續重複操作。記下畫面顯示的錯誤訊息，並比較重新整理前後的項目。
核對連結
進入該訂閱的編輯頁面，確認 Type 是否為 Subscribe，並核對已儲存的 URL。特別檢查網域、路徑及
token等查詢參數是否缺漏、過期或含有多餘空格；確認後儲存，再返回 Home 重新整理一次。記錄結果
如果只有這一組失敗，優先檢查它的連結與回傳內容；如果所有訂閱都逾時，優先檢查目前的網路。保留錯誤訊息原文，以便向自己的服務商確認連結狀態。
尚未匯入訂閱時，點選 Home 右上角的「+」→ Type 選擇 Subscribe，輸入使用者已有的連結並儲存，再進行第一次重新整理。複製連結時，請包含問號後的完整參數：例如示意網址中的 ?token=xxxx 是 URL 的一部分，遺漏後可能會遭拒絕存取，或收到不符合預期的內容。請勿公開真實連結及其中的憑證。
開啟 App 時自動更新：設定與適用條件
開啟 App 時更新的作用，是在進入 Shadowrocket 時嘗試取得訂閱的新內容；這不是持續在背景重新整理，也無法修復無效網址。請先手動更新一次並確認成功，再前往 Settings → Subscribe 查看開啟 App 時更新的選項。若目前介面有 Update on Open，可依需求啟用；實際可用選項請以 App 內頁面為準。
先確認連結可用
返回 Home，手動重新整理目標訂閱，確認沒有錯誤提示，並檢查訂閱內容是否正常顯示。若手動更新失敗，請先依下文列出的三類原因排查，不要只靠開啟自動更新反覆重試。
查看設定
前往 Settings → Subscribe，查看 Update on Open 等與開啟 App 時更新相關的選項。調整後返回 Home；若管理多組訂閱，也要留意各組的重新整理結果。
再次確認
下次開啟 App 後，等待網路請求完成，再比較訂閱內容或查看更新提示。開啟 App 不代表遠端一定會回傳新項目；服務商提供的內容沒有變動時，清單可能維持原樣。
如果只有透過現有代理連線才能存取自己的訂閱網址，可前往 Settings → Subscribe 檢查 Update via Proxy，並搭配目前連線是否可用進行測試。此選項會改變更新請求使用的網路路徑，不會取代失效連結，也無法將無法解析的回應轉成訂閱。測試時一次只調整一個條件：先使用目前路徑，再切換此選項並手動重新整理，比較兩次結果。
設定原則：先確認手動更新成功，再啟用自動更新
確認手動重新整理能取得並解析內容後，再啟用開啟 App 時更新；若手動更新失敗，請保留錯誤提示，逐一排查連結、網路和格式。
更新失敗的三類原因與處理方式
錯誤訊息會因請求階段與伺服器回應而異。下方卡片中的英文訊息或狀態碼，是可能出現的提示範例，請以裝置實際顯示的內容為準。同樣的 “Failed to load subscription” 也可能由多種原因造成，因此不能只憑這句提示就判定連結已過期。
錯誤：HTTP 403
原因與解法：伺服器拒絕目前的請求，可能與連結憑證或存取限制有關。請核對訂閱 URL 中的完整參數，並向自己的服務商確認存取條件；不要自行猜測或更改憑證。
錯誤：HTTP 404
原因與解法：請求網址找不到對應資源。請確認網域與路徑是否和自己儲存的網址一致；若原網址已調整，請向自己的服務商確認新的有效網址後再更新。
錯誤：The request timed out.
原因與解法：請求未能在等待時間內完成。先確認目前的 Wi-Fi 或 Cellular 可正常連線，再比較直連與 Settings → Subscribe → Update via Proxy 下手動重新整理的結果。
錯誤：Failed to load subscription
原因與解法：App 未能取得或使用這次的訂閱內容。先檢查連結與網路；若請求已完成但仍沒有可用項目，請向自己的服務商確認回應內容是否為可解析的訂閱格式。
連結失效：先檢查網址，再確認授權
只有一組訂閱更新失敗，尤其是已儲存的連結近期變更過時，請先核對 URL。網域拼字、路徑結尾及查詢參數都可能影響伺服器回傳結果。HTTP 403 可優先檢查存取條件；HTTP 404 則先確認路徑，但伺服器也可能用其他狀態碼表示相同問題。測試連結前，不要刪除仍可用的舊項目；請先保留現況並向自己的服務商確認。
網路無法連線：分辨裝置網路與訂閱請求路徑
Wi-Fi 或 Cellular 顯示已連線，不代表訂閱網址一定可存取。先確認裝置能正常連線，再於相同網路環境下重新整理 Home。如果所有訂閱都逾時，請檢查目前的網路；若只有特定網址逾時，再確認該網址的存取條件。調整 Update via Proxy 前，請先確認所選連線本身可用，否則更新請求仍可能失敗。
格式無法解析：檢查回應內容，而非檔名
即使請求成功送達伺服器，收到的仍可能是登入頁面、錯誤說明或空白內容，而非 Shadowrocket 能解析的訂閱資料。可能會出現重新整理後沒有新增項目，或載入失敗的情況。此時反覆切換 Global Routing 的 Proxy、Direct 或 Config，無法修正伺服器回傳的內容；請確認 Type 為 Subscribe，並請自己的服務商檢查該連結實際回傳的格式。
常見問題：重新整理後仍看不到預期變化
向下滑動重新整理沒有錯誤，項目卻沒有變化？
先確認重新整理的是目標訂閱，而非清單中的其他群組。接著比較服務商目前提供的內容：遠端項目沒有變化時，即使重新整理成功，清單也不會憑空增加項目。不要只憑數量不變就判定更新失敗。
已開啟 App 時更新，為什麼還要手動測試？
手動重新整理能將一次操作與一次結果直接對照。返回 Home，對目標訂閱向下滑動以重新整理，並記下錯誤訊息原文；若仍失敗，依序檢查連結、網路路徑和回傳內容，不要只是等待下次開啟 App。
開啟 Update via Proxy 後仍然逾時？
先確認 Home 目前選擇的連線可用，再檢查 Settings → Subscribe 中該選項的狀態。若兩種請求路徑都逾時，請記下時間與錯誤提示，並向自己的服務商確認訂閱網址的存取條件。
能開啟連結，卻仍顯示載入失敗？
能收到網頁內容，不代表收到可解析的訂閱。請確認 Type 是否為 Subscribe、URL 是否完整，並請自己的服務商核對該網址回傳的內容；登入頁面或錯誤頁面都不能匯入為訂閱項目。
更新失敗會刪除原有項目嗎？
先在 Home 確認現有項目是否仍顯示，不要假設這次失敗已改寫所有設定。記錄重新整理前後的實際變化；確認新連結可用前，請避免刪除舊訂閱來排查。
排查完成後，可再手動重新整理一次，確認目標訂閱能正常取得內容，再觀察下次開啟 App 時的更新結果。訂閱由使用者自己的服務商提供；Shadowrocket 是用來匯入及使用這些設定的 Apple 平台付費 App，購買 App 不等於購買連線方案。iPhone、iPad 的系統需求請以 App Store 頁面標示為準。