適用於已在 Shadowrocket（小火箭）匯入自己訂閱的使用者。先在 Home 手動更新一次，確認連結能回傳有效清單，再視需要啟用 Settings → Subscribe 中的 Update on Open。只有特定訂閱異常時，才單獨更新該項。排查更新失敗時，請分辨請求未完成、伺服器拒絕存取或回傳內容無法解析；不要急著刪除仍可使用的紀錄。
訂閱更新會變更哪些內容
訂閱儲存的是清單來源。每次更新時，Shadowrocket 會向該網址送出請求、讀取回傳內容，並更新對應分組中的伺服器紀錄。如果伺服器端調整了伺服器名稱、位址、連接埠或連線參數，新清單就可能與舊清單不同。更新訂閱並非升級用戶端，也不會自動延長既有服務的有效期限。
Home 中的伺服器訂閱與 Config 中的規則設定是兩種不同內容。重新整理伺服器訂閱不等於更新 Config，也不代表 Global Routing 會自動切換。排查前先確認要處理的是哪一種連結，避免把規則檔網址填入伺服器訂閱欄位。
- 既有紀錄：來自訂閱分組的紀錄應由該訂閱維護；手動新增的獨立紀錄不會因此取得相同的更新來源。
- 目前選取項目：更新後確認原先選取的伺服器是否仍存在，不要只看總數。
- 連線結果：清單成功重新整理與伺服器可連線是兩項不同檢查，後者需要另外驗證。
- 預設設定：自動更新與請求路徑相關開關，請以目前 App 顯示為準，不預設為全開或全關。
手動下拉重新整理：先確認完整更新一次
手動重新整理適合用於首次匯入後確認內容、收到服務商的變更通知後同步清單，以及自動更新結果不明確時重新檢查。操作時讓 Shadowrocket 保持在前景，並等候目前更新完成；連續下拉無法修復失效連結，反而可能觸發伺服器的請求頻率限制。
-
確認分組
前往 Home，找到已匯入的訂閱分組。若尚未新增，點選右上角「+」，在 Type 選擇 Subscribe，輸入自己的完整訂閱網址並儲存。
-
下拉重新整理
在 Home 清單向下拉動以重新整理訂閱。留意更新狀態，等候請求與解析完成，不要立刻離開 App。
-
檢查清單
確認目標分組仍保有有效紀錄，並核對預期變更的名稱與數量。清單沒有變化，可能表示伺服器端內容未變，不能只憑這點判定更新失敗。
-
驗證連線
點選要使用的伺服器，確認 Home 中的選取標記，再使用 Connectivity Test 進行檢查。如果重新整理成功但連線失敗，請檢查該伺服器的參數與連線路徑。
開啟 App 時自動更新：設定 Update on Open
前往 Settings → Subscribe 檢查 Update on Open。啟用後，App 會在相應的開啟時機嘗試更新訂閱。這不是持續在背景輪詢，也不表示 App 關閉後會按固定分鐘間隔送出請求；觸發條件與介面細節請以目前 App 為準。
建議先成功手動重新整理一次，再啟用此選項。如此一來，下次開啟 App 時若發生異常，便能分辨是自動觸發未如預期，還是訂閱本身已無法更新。開啟 App 時仍需有可用網路；自動更新不會繞過伺服器驗證、失效日期或請求限制。
- 設定位置：開啟 Settings → Subscribe，確認 Update on Open 目前的狀態；若要在開啟 App 時同步清單，請啟用此選項。
- 驗證方式：記下目前分組內容，之後重新開啟 App 時留意更新提示與結果；若伺服器端內容沒有變動，清單維持原樣是正常現象。
- 暫時排查：若每次開啟 App 都出現失敗提示，可先關閉此選項，再透過單項更新找出問題；修復後再決定是否重新啟用。
- 功能範圍：Settings → On Demand 用於管理依條件連線，並非訂閱重新整理排程。請勿為了啟用自動更新而變更 On Demand。
如果開啟 App 後網路尚未就緒，例如剛切換 Wi-Fi 或仍在完成網路登入，更新請求可能會在網路恢復前失敗。先完成網路連線，再回到 Home 手動重新整理一次即可確認，不必重新匯入所有訂閱。
逐項更新訂閱：縮小故障範圍
同時有多個訂閱時，某個分組更新成功，不代表其他分組也更新成功。逐項更新能將問題限縮到單一網址，避免把某個伺服器端的異常誤判為整個 App 無法連線。此操作以使用者已有訂閱為前提；本站不提供、販售或推薦節點或訂閱。
- 在 Home 找到要檢查的訂閱分組，先記下名稱與目前紀錄數量，確認不是另一個同名分組。
- 開啟該訂閱分組的操作選單，使用 Update 更新這項訂閱；入口位置請以目前 App 介面為準，並留意不要選到刪除操作。
- 等候更新結果並記錄完整錯誤訊息。若更新成功，檢查該分組內容；若失敗，保留原分組以便繼續排查。
- 在相同網路下，再更新另一項既有訂閱作為對照。若只有一項失敗，優先檢查該連結與伺服器端狀態；若多項都失敗，再檢查共同的網路路徑。
更新失敗：依錯誤訊息與回傳內容排查
失敗可能發生在網域解析、建立連線、伺服器回應或內容解析階段。請先記錄發生時間、目前網路、目標分組與提示原文，再判斷下一步。以下英文內容是網路請求中可能出現的錯誤訊息或 HTTP 狀態；實際顯示方式取決於 App 與伺服器端，並非每次都會出現相同提示。
錯誤訊息：The request timed out.
原因：請求未能在允許時間內完成，可能與網路路徑或伺服器回應有關。解決方式：先確認目前網路可用，切換一次網路後再單獨重試，接著依現有連線條件檢查 Update via Proxy。
錯誤訊息：401 Unauthorized
原因：伺服器端不接受目前請求的身分憑證。解決方式：從自己的服務帳戶重新確認訂閱網址，保留完整查詢參數，並確認舊 token 是否已重設。
錯誤訊息：403 Forbidden
原因：伺服器端拒絕此次存取，可能與帳戶狀態或存取限制有關。解決方式：向自己的服務商確認訂閱權限與存取條件，不要只憑此狀態判定用戶端設定有誤。
錯誤訊息：429 Too Many Requests
原因：請求觸發伺服器端的頻率限制。解決方式：停止反覆重新整理，依伺服器端提示等候後再試；排查期間可暫時關閉 Update on Open，以減少重複請求。
請求成功，但清單是空的
HTTP 請求成功，只代表收到回應，不保證回應中包含有效的伺服器紀錄。網址可能回傳帳戶登入頁、錯誤說明頁或空白內容；複製時漏掉參數，也可能讓伺服器回傳與預期不同的頁面。不要把「能開啟網頁」直接當作訂閱有效的證據。
- 確認網址確實是伺服器訂閱網址，而非帳戶管理頁面或 Config 檔案網址。
- 檢查網址開頭與結尾是否混入空格、換行或引號，尤其確認
?後的參數是否完整。 - 向自己的服務商確認目前回傳格式是否適用於 Shadowrocket，以及內容是否確實包含可用紀錄。
- 若要提供回應內容協助排查，請先移除訂閱網址、token、密碼等敏感資訊，不要公開貼上完整訂閱內容。
Update via Proxy：僅在需要時調整請求路徑
Settings → Subscribe 中的 Update via Proxy 用來控制訂閱更新是否透過代理路徑進行。它與 Update on Open 解決的問題不同：前者關乎如何送出更新請求，後者關乎何時嘗試更新。啟用代理更新無法修復錯誤的 token，也無法將登入頁面轉成伺服器清單。
- 直連更新正常：保留目前可用的設定，不必為了更新訂閱同時變更 Global Routing、DNS 與 Config。
- 目前網路無法存取訂閱網址：先使用現有可用伺服器建立連線，再嘗試啟用 Update via Proxy，並單獨更新目標訂閱。
- 目前沒有可用連線：單獨開啟 Update via Proxy 不會產生可用的代理路徑。請先恢復既有連線條件，或改在可存取訂閱網址的網路中更新。
- 變更後仍然失敗：記錄變更前後的錯誤是否不同。若始終是 401 或 403，應優先檢查權限，而非繼續切換請求路徑。
每次只調整一個變數。例如先保持訂閱網址不變，只切換網路重試；接著再檢查代理更新設定。這樣才能確認哪個步驟影響結果，也方便將設定還原到原先可用的狀態。
常見問題：更新頻率與連線驗證
啟用開啟時自動更新後，還需要手動重新整理嗎？
正常使用時不必連續重新整理。收到服務商的變更通知、開啟 App 時網路尚未就緒，或要確認某個分組的狀態時，可以在 Home 手動重新整理一次並等候結果。
更新成功了，為什麼伺服器數量沒有增加？
更新只是同步伺服器端目前的內容，不保證數量會增加。請核對預期變更的紀錄名稱、位址與連接埠；若伺服器端沒有變動，數量不變是合理結果。
重新整理後無法連線，需要重新新增訂閱嗎？
先在 Home 再次確認選取的伺服器，並執行 Connectivity Test。若測試異常，請檢查該紀錄的連線參數與既有服務狀態；若測試通過但目標連線異常，再檢查 Global Routing 與 Config，不要立刻刪除訂閱。
可以每隔幾秒自動重新整理一次嗎？
Update on Open 不是以秒為間隔的定時工作。依實際需要更新即可；頻繁送出請求可能觸發 429。內容沒有變更時，不必靠反覆重新整理維持已建立的連線。
購買 Shadowrocket 後就會附帶訂閱嗎？
買斷用戶端 ≠ 購買線路方案。Shadowrocket 是 Apple 平台的付費用戶端，唯一取得管道是 App Store；使用者需自行匯入既有服務的訂閱，購買用戶端不會自動新增伺服器清單。