適合已持有自己的服務商與訂閱，並需要管理 Home 訂閱列表的使用者。先手動更新一次確認連結可用，再視需求啟用開啟時更新；若更新失敗，依序檢查連結、伺服器回應、回傳格式與目前網路，先別刪除仍可使用的訂閱。
訂閱更新的範圍：重新整理列表，不代表連線成功
Shadowrocket（小火箭）更新訂閱時，會使用已儲存的訂閱網址重新取得內容，並將解析後的項目更新至 Home。服務商調整伺服器位址、連接埠、驗證資訊或項目名稱後，通常需要在 App 中重新取得訂閱，才能同步這些變更。買斷 App ≠ 購買線路方案；本文假設使用者已有自己的訂閱。
更新成功只代表此次取得並解析訂閱的流程已完成，不表示每個項目都能建立連線，也不代表目前使用中的連線已切換至新項目。訂閱列表、Config 中的規則與系統 VPN 連線屬於不同設定層級，排查時請分開檢查。
在 Home 中加入的 Subscribe 是訂閱來源；單獨匯入的伺服器記錄不一定包含訂閱網址，因此無法像訂閱一樣取得後續更新。Config 中遠端設定檔的更新，也不等同於 Home 訂閱列表的更新。操作前請先確認要管理的是哪一類內容。
手動更新：找到訂閱後重新整理
首次匯入、服務商通知設定有變，或自動更新後列表沒有變化時，建議先手動更新。這樣能明確送出一次請求，並立即查看結果。不同介面語言的文字可能不同，以下保留英文介面名稱；訂閱群組的操作入口也可能因介面配置而異。
-
找到訂閱
開啟 Home，找到對應的訂閱群組並確認群組名稱。若尚未匯入，前往 Home 右上角「+」→ Type → Subscribe，將自己已有的訂閱連結填入 URL 後儲存。
-
檢查網址
開啟該訂閱的編輯畫面，確認 URL 完整無誤，尤其是問號後方的參數。複製時請勿帶入空格、換行、中文標點或說明文字；檢查後返回 Home。
-
執行更新
在 Home 列表頂端下拉重新整理。若要單獨更新某個訂閱，可長按對應的訂閱群組並選擇 Update；請以目前群組實際顯示的操作選單為準。
-
確認結果
等待請求完成，留意是否出現錯誤提示，再展開目標群組，檢查項目名稱、數量或已知變更是否已反映。請勿在請求尚未完成時連續重新整理。
-
重新檢查連線
確認目前選取的項目仍在更新後的列表中。若服務商已替換該項目，請重新選取有效項目，再單獨測試連線；若有進行中的工作階段，調整連線前先儲存工作。
列表數量沒有變化，不一定代表更新失敗：伺服器可能只修改了同名項目的驗證資訊，或這次回傳的內容與上次相同。反之，數量增加也不能證明所有項目都可用。請將更新結果與服務商明確告知的變更相互比對，不要只看數字。
開啟時自動更新：設定位置與適用條件
自動更新的常見設定路徑為 Settings → Subscribe → Update on Open。啟用後，App 會依照該選項的觸發條件嘗試更新訂閱。若目前介面另有更新間隔等限制，也請一併確認；不要將每次切回前景都視為一定會重新送出請求。
這項設定適合希望在開啟 App 時取得訂閱變更的使用者，但需要當時能連線至訂閱伺服器。它不保證系統會在背景定時執行，也不代表裝置鎖定後仍會持續取得訂閱。若開關名稱或設定層級與本文不同，請以 Settings 中 Subscribe 群組的實際選項說明為準。
Settings → On Demand 用於依條件觸發 VPN 連線，與自動取得訂閱是不同功能。只啟用 On Demand，不能據此認定訂閱會自動更新；只啟用 Update on Open，也不會因此自動完成系統 VPN 授權或確保連線可用。
結論：先手動確認，再啟用自動更新
先確認同一個網址在目前網路下可以手動更新，再啟用 Update on Open。若手動請求已失敗，調整自動更新開關通常無法解決連結失效、格式錯誤或網路無法連線等問題。
手動與自動更新：依管理情境選擇
兩種方式取得的都是同一訂閱來源，主要差異在於觸發時機與排查時能否觀察結果。自動更新無法讓失效連結恢復有效，也不會改變訂閱伺服器回傳的格式。遇到問題時，先維持自動更新設定不變，手動送出一次可觀察的請求，通常更容易找出原因。
| 方式或設定 | 觸發條件 | 適用情境 | 檢查重點 |
|---|---|---|---|
| Home 手動重新整理 | 使用者主動下拉或執行 Update | 首次確認、設定變更、重現錯誤 | 本次提示與目標群組內容 |
| Update on Open | 開啟 App 並符合選項條件 | 日常取得訂閱變更 | 當時的網路與額外的間隔限制 |
| On Demand | 符合按需求連線條件 | 管理 VPN 連線行為 | 不適用於確認訂閱更新結果 |
- 訂閱很少變動：需要時手動更新即可，不必反覆送出請求。
- 訂閱經常調整：先確認連結，再考慮啟用 Update on Open。
- 服務商限制請求頻率：遵守服務商提供的更新間隔，避免連續觸發。
- 需要保留本機修改：更新前記錄必要差異；訂閱產生的項目可能在下次更新時被覆蓋，不適合用來永久保存手動修改。
更新失敗排查：先看錯誤訊息，再檢查對應環節
先記下錯誤發生時間、使用的網路、目標訂閱與提示內容。以下列出常見的網路層英文錯誤原文；實際介面可能顯示本地化文字或附加說明，請依錯誤含意對應處理。錯誤訊息描述的是失敗環節，不能單憑此判定服務商帳戶或特定伺服器一定有問題。
The request timed out.
原因與處理方式：請求未能在允許的等待時間內完成，可能與網路、DNS 或遠端回應緩慢有關。先確認目前網路可正常連線，再換用另一個可信任的網路環境重試一次，並記錄是否仍出現相同錯誤。
A server with the specified hostname could not be found.
原因與處理方式：無法解析訂閱網域，可能是網域拼寫錯誤、DNS 異常或網域已變更。先比對原始網址中的主機名稱，再向自己的服務商確認目前有效的網址。
Could not connect to the server.
原因與處理方式：無法成功連線至目標伺服器，可能是目標連接埠無法連線或伺服器暫時無法使用。檢查 URL 中的連接埠與位址，接著換用另一個網路測試，並保留結果供服務商排查。
The network connection was lost.
原因與處理方式：請求過程中連線中斷，可能發生於 Wi-Fi 與行動網路切換時。請保持使用單一且穩定的網路，等系統恢復連線後再手動更新一次。
HTTP 狀態碼與回傳內容要分開檢查
- HTTP 401：通常表示請求缺少有效驗證資訊。檢查連結中的驗證參數是否完整，並確認服務商是否已重新產生網址。
- HTTP 403：伺服器拒絕了請求，可能與存取限制或憑證狀態有關。不要直接認定訂閱已到期，請向自己的服務商確認拒絕原因。
- HTTP 404：找不到請求的路徑。檢查是否複製了舊路徑，或誤將管理頁面網址當成訂閱網址。
- HTTP 429：請求過於頻繁。請暫停重新整理，依伺服器回傳的等待時間或服務商說明稍後再試。
- HTTP 5xx：通常表示伺服器端或其上游處理發生異常。保留狀態碼與發生時間，稍後再試；反覆修改本機項目通常無法讓遠端服務恢復。
即使伺服器回傳 HTTP 200，收到的內容仍可能是登入頁、驗證頁面或空白內容，而非 App 能解析的訂閱。若出現格式錯誤，或更新後沒有有效項目，請檢查回傳內容的類型，並確認自己的服務商是否提供適用於 Shadowrocket 的訂閱格式；不要只因為瀏覽器能開啟某個網頁，就認定訂閱正常。
連結過期與格式不符：檢查完整 URL
訂閱 URL 通常包含存取憑證。範例 https://example.com/sub?token=xxxx 僅為明顯的虛構值，並非可用的服務網址。實際網址中的路徑與查詢參數都必須完整保留；刪除問號後方的內容，可能會讓原本有效的訂閱變成未經驗證的請求。
- 確認來源：回到自己的服務商提供訂閱資訊的位置，確認複製的是訂閱網址，而非帳戶首頁、登入頁或使用說明頁。
- 確認有效性：確認訂閱資格、有效期限與連結狀態。有些服務會在重新產生連結後使舊網址失效；即使帳戶狀態恢復，舊網址也不一定能繼續使用。
- 檢查複製是否完整：保留原始編碼與所有參數，不要自行替換
%、&、=等字元，也不要把經過省略顯示的網址當成完整網址。 - 確認輸出格式：使用服務商標示適用於 Shadowrocket 的格式。訂閱容器的編碼與內含項目的協定屬於不同層次，不能只因文字中出現某個協定名稱，就認定整份內容有效。
- 修改後單次測試：更新現有訂閱的 URL，再手動重新整理一次。保留原有群組有助於比對問題，也能避免重複匯入造成新舊項目混淆。
Shadowsocks、VMess、VLESS、Trojan 等名稱描述的是項目的協定類型；訂閱網址則用於一次取得一組設定。單一分享連結與可重新整理的訂閱來源不同，將單一連結填入 Subscribe 的 URL 欄位，不會自動取得遠端列表更新功能。
請妥善保管訂閱憑證向服務商回報問題時，優先提供錯誤訊息、時間，以及已遮蔽憑證的網址。請勿公開完整訂閱連結、驗證參數或包含這些資訊的截圖；若懷疑連結已外洩，請透過自己的服務商重新產生憑證。
更新成功但無法使用：檢查連線與流量分流設定
訂閱更新與連線使用可能透過不同的網路路徑。更新成功後仍無法存取時，先確認目前選取的是更新後仍存在的有效項目，再檢查連線狀態與 Global Routing，而不是持續重新整理同一個訂閱。反覆更新只會增加請求次數，無法修正規則比對結果。
- 檢查項目：確認名稱、伺服器位址與連接埠符合自己的服務商說明。不要只因兩筆記錄名稱相似，就認定驗證參數也相同。
- 檢查連線：確認 App 的連線開關與系統 VPN 狀態；必要時先儲存目前工作，再重新連線，讓新連線使用更新後的設定。
- 檢查路由模式：Global Routing 中的 Proxy、Direct、Config、Scene 會決定不同的流量處理方式。使用 Config 時，請求也會受到目前設定檔規則的影響。
- 檢查規則：DOMAIN-SUFFIX、GEOIP、IP-CIDR 與 FINAL 等規則會影響策略選擇，但不會決定訂閱伺服器回傳哪些項目。請在 Config 中檢查實際生效的設定與規則順序。
- 區分問題：只有單一項目失敗、其他項目可用時，請檢查該項目及對應的伺服器；若所有項目都失敗但訂閱仍能更新，則繼續檢查連線權限、網路與設定。不要將兩者混為同一次更新故障。
結論：依失敗階段保留記錄
取得失敗時記錄網路錯誤或 HTTP 狀態碼；解析失敗時檢查輸出格式；列表已更新但連線失敗時，檢查選取的項目與流量分流設定。一次只調整一個變數，才能判斷哪項修改真正有效。
完成管理後，再手動更新一次，確認目標群組仍可正常重新整理，並檢查 Update on Open 是否符合日常使用需求。若需要回報問題，整理觸發方式、錯誤原文、網路類型與已執行的檢查即可，無須公開訂閱憑證。