本文適用於已有個人訂閱連結的 Shadowrocket（小火箭）使用者。先在 Home 手動重新整理，確認連結能回傳有效內容，再前往 Settings → Subscribe 開啟「開啟時更新」；若更新失敗，請依序檢查連結、請求路徑與回傳格式。訂閱更新和伺服器連線測試是兩回事；保留現有設定，通常比先刪除再重新匯入更容易找出問題。
一、先區分訂閱更新與連線失敗
訂閱更新是向既有訂閱網址送出請求，並將回傳內容解析為伺服器項目。這不等於測試每個伺服器是否可連線，也不等於更新 Config 中的路由規則。Home 中的項目可以連線，不代表訂閱網址仍有效；訂閱更新成功，也不保證所有項目在目前網路環境下都能使用。
開始操作前，請保留目前仍可使用的項目與設定，並記下錯誤訊息原文。不要因為一次逾時就刪除整個訂閱群組。如果舊項目仍可連線，還可能提供訂閱請求所需的網路路徑。
- Home：查看現有訂閱與伺服器項目、重新整理並檢查項目變化。
- Settings → Subscribe：設定訂閱更新方式，包括開啟時更新與透過代理更新。
- Config：管理設定檔與規則。重新整理伺服器訂閱，不代表此處的設定檔也會同步更新。
- Settings → On Demand：設定依條件建立連線的方式，並非訂閱定時更新的入口。
Shadowrocket 是 Apple 平台的付費用戶端，唯一取得管道為 App Store。買斷用戶端 ≠ 線路方案。本文僅說明如何管理使用者已有的訂閱，不提供、販售或推薦訂閱及相關服務。
二、在 Home 手動更新現有訂閱
先手動更新一次，確認結果，再開啟自動更新。這樣可區分「請求本身失敗」和「自動更新未觸發」，避免一次變更多項設定。
-
確認訂閱項目
前往 Home，找到要更新的訂閱群組，確認群組名稱與已儲存的 URL。如果有多個群組，先確認錯誤來自哪一組；另一組項目增加，不代表目前這組已更新成功。
-
檢查連結
確認 URL 完整無誤，尤其是問號後方的參數。複製時若帶入換行或前後空格，或漏掉 token 後半段，都可能讓同一網域回傳不同結果。
-
下拉重新整理
在 Home 的清單區域下拉，觸發訂閱重新整理，並等待本次請求完成。如果有多個訂閱，請逐一檢查各群組的結果；不要連續下拉，以免重複請求掩蓋第一次的錯誤訊息。
-
確認結果
確認錯誤提示是否消失、群組是否仍有項目，以及名稱、地區或數量是否如預期變化。內容沒有變動也可能代表更新成功，不能只憑數量未變就判定失敗。
如果尚未儲存訂閱，請前往 Home 右上角「+」→ Type → Subscribe，輸入自己已有的 URL 並儲存。重新新增並非既有訂閱更新失敗時的首選處理方式；先確認原網址是否仍有效，避免留下多個指向同一網址的重複群組。
https://example.com/sub?token=xxxx以上僅為明確虛構的網址範例，不能用於匯入。實際訂閱 URL 中的 token 通常具有存取憑證的作用，請勿將完整網址貼到公開記錄、螢幕截圖或網站檔案中。
三、設定開啟時自動更新與更新路徑
前往 Settings → Subscribe，找到 Update on Open 並開啟。此功能會在開啟 App 時觸發訂閱更新，不應解讀為 App 持續在背景執行，或每隔固定分鐘輪詢一次。若 App 一直停留在前景，也不要直接將「沒有再次重新整理」視為故障；需要立即取得內容時，請在 Home 手動重新整理。
| 設定或操作 | 作用 | 適用的檢查情境 |
|---|---|---|
| 在 Home 下拉重新整理 | 手動發起一次訂閱更新 | 確認網址與目前的請求路徑是否可用 |
| Settings → Subscribe → Update on Open | 開啟 App 時觸發更新 | 手動更新正常後，再確認自動觸發是否正常 |
| Settings → Subscribe → Update via Proxy | 讓訂閱更新請求透過代理路徑送出 | 目前的直連網路無法連上訂閱網址時，用於比較測試 |
| Settings → On Demand | 依設定條件建立連線 | 檢查連線行為，不能取代訂閱更新設定 |
結論：先確認路徑可用，再啟用自動更新
手動重新整理尚未成功時，開啟 Update on Open 只會重複送出同一個失敗請求。先讓手動重新整理成功，再確認重新開啟 App 後的更新情形。
若要開啟 Update via Proxy，請先確認現有代理連線確實可用，再手動重新整理。如果訂閱更新必須透過代理，而代理所需的新項目又只能從該訂閱取得，就會形成依賴循環；此時請保留可用的舊項目，或改用能連上該網址的其他網路重新測試。
Global Routing 中的 Config、Proxy、Direct、Scene 是連線處理模式，不是訂閱更新頻率設定。不要只為了解決一次訂閱錯誤，就同時切換模式、修改規則並重建設定；先單獨確認 Update via Proxy 對本次請求的影響，才能判斷問題出在哪個環節。
四、依錯誤訊息檢查連結、網路與回傳內容
以下列出網路請求中可能出現的錯誤原文或 HTTP 狀態碼。App 顯示的訊息可能包含網址、錯誤網域或其他背景資訊，請保留實際顯示的完整錯誤內容；不必要求每次提示都與以下文字完全相同。
錯誤：401 Unauthorized
原因與處理方式：伺服器未接受請求所附的驗證資訊。請確認 URL 參數完整，並向自己已有訂閱的服務提供者確認憑證狀態；若網址已重設，請更新已儲存的 URL，而非反覆重新整理舊網址。
錯誤：403 Forbidden
原因與處理方式：伺服器拒絕目前的請求，可能與存取政策、憑證狀態或請求來源限制有關。請先確認自己有權存取該訂閱，再確認服務提供者提供的訂閱入口與使用要求；不要只憑 403 就認定是 App 解析故障。
錯誤：404 Not Found
原因與處理方式：請求路徑不存在，或伺服器以此狀態隱藏無法存取的資源。請確認網址路徑、參數與複製內容是否完整，並確認是否誤用了帳戶管理頁面網址或已停用的舊入口。
錯誤：The request timed out.
原因與處理方式：請求未能在允許時間內完成，問題可能發生在名稱解析、建立連線或等待回應的階段。先切換 Wi-Fi 與行動網路進行比較，再確認已有可用連線後測試 Update via Proxy。
HTTP 狀態碼只能縮小問題範圍，無法單獨證明訂閱已到期。例如 403 可能來自來源伺服器，也可能是中間的存取控管所致；確認時應一併記錄網路類型、是否使用代理，以及同一網址在其他網路下的結果。若遇到憑證錯誤，請檢查裝置日期與時間及網址是否正確，不要以降低憑證驗證要求取代問題排查。
五、網址可以開啟，為什麼仍無法匯入？
「網頁可以開啟」只表示收到某種回應，不代表回應內容就是訂閱。瀏覽器可能顯示登入頁、存取驗證頁或錯誤說明；即使 HTTP 狀態碼為 200，本文仍可能是 HTML。Shadowrocket 需要的是可識別的訂閱內容，而不是能在瀏覽器閱讀的網頁。
- 回傳登入頁面：請確認複製的是用戶端匯入用的訂閱網址，而非帳戶管理頁面。瀏覽器已有登入狀態，也不代表 App 請求會帶上相同的工作階段資訊。
- 回傳驗證頁面：即使在頁面完成互動驗證後，瀏覽器可以繼續存取，也不代表訂閱請求能自動通過。請向自己已有訂閱的服務提供者確認用戶端使用的訂閱入口。
- 回傳空白內容：請確認帳戶與訂閱狀態、是否有有效項目，並區分真正的空白回應與尚未載入完成的頁面。
- 回傳格式不符：請確認取得的內容適用於 Shadowrocket 訂閱；不要將完整路由設定、一般說明文字或其他用途的資料直接填入 Subscribe。
通訊協定名稱與訂閱封裝格式並非同一回事。內容中出現 Shadowsocks、VMess、VLESS、Trojan、Hysteria2 或 WireGuard，不代表整份回應一定能由目前的匯入入口辨識；仍須確認實際回傳結構與欄位是否符合要求。
固定訂閱 URL，先比較兩種網路；固定網路，再比較是否使用 Update via Proxy。每次記錄結果後才調整下一項。不要同時更換網址、清空群組、修改 DNS 和重寫規則，否則難以判斷是哪項變更生效。
六、自動更新與重新整理結果常見問題
手動更新成功，為什麼開啟 App 後看不到變化？
先前往 Settings → Subscribe，確認 Update on Open 已開啟，再離開並重新開啟 App，觀察是否有更新結果。伺服器清單沒有變化，不代表沒有送出請求；若遠端內容相同，重新整理後的名稱與數量也可能完全不變。
訂閱更新逾時，需要先開啟連線開關嗎？
不一定。若網址可透過直連網路存取，可先直接重新整理；只有需要透過代理時，才先建立可用連線，再前往 Settings → Subscribe 檢查 Update via Proxy。即使連線開關已開啟，也不代表所選項目實際可用。
更新成功後，為什麼網頁還是無法開啟？
先在 Home 確認目前選取的伺服器與連線狀態，再檢查 Global Routing 和 Config。重新整理訂閱只會取得並解析清單；網頁能否存取還取決於所選伺服器、DNS 與規則。後續的連線故障，不應繼續當作訂閱更新失敗處理。
開啟 On Demand 後，訂閱會定時更新嗎？
On Demand 負責處理連線觸發條件，不會按固定週期重新整理訂閱。若要在開啟 App 時更新，請檢查 Settings → Subscribe → Update on Open；若要立即更新，請回到 Home 手動重新整理。
排查仍未解決，需要保留哪些資訊？
記下錯誤訊息原文、發生時間、使用 Wi-Fi 或行動網路、Update via Proxy 開關狀態，以及舊項目是否可連線。提供資訊前，請遮蔽完整 URL、token、帳號與密碼；這些資料已足以協助判斷請求卡在哪個階段，不必公開存取憑證。
問題排除後，保留一條已確認可用的更新路徑即可。若要查看首次匯入與授權步驟，請參閱使用指南；若要區分訂閱與設定檔的管理範圍，請參閱訂閱手冊。重新整理訂閱不會變更 App 的購買狀態；系統需求與裝置相容性請以 App Store 頁面標示為準。