本文適用於已持有服務商訂閱的 Shadowrocket（小火箭）使用者。先在 Home 手動重新整理並確認清單，再前往 Settings → Subscribe 設定開啟時更新；若請求失敗，依序檢查網路、更新路徑與連結是否有效。更新訂閱只會取得服務商提供的清單，不代表續約，也不會切換 Global Routing 或更新 Config 中的規則。
訂閱更新範圍：伺服器清單，不是規則或方案
Shadowrocket 儲存訂閱網址後，會向該網址發出請求，並將可辨識的伺服器項目整理到 Home。服務商調整網址、連接埠、驗證資訊或伺服器名稱後，舊項目不會只因連線開關已開啟就自動更新，必須重新取得訂閱內容。是否出現新項目，取決於服務商實際回傳的內容。
先確認目前項目是來自訂閱，而非逐筆手動新增。若只有個別填寫的伺服器參數，沒有訂閱網址，下拉重新整理不會憑空取得新清單。首次新增訂閱可在 Home 點選右上角「+」→ Type → Subscribe，填入自己的訂閱網址並儲存；已匯入的訂閱不必每次重新新增。
- 訂閱清單：由訂閱網址回傳，更新後可能新增、移除或修改項目；清單數量不一定會改變。
- Config：用於設定檔與規則。更新伺服器訂閱，不代表 Config 中另行管理的設定檔也已更新。
- Global Routing：決定連線使用 Config、Proxy、Direct 等處理方式；這不是訂閱更新頻率的設定。
- 服務有效期限：由自己的服務商管理。重複重新整理不會延長方案期限，也不會增加可用量。
在 Home 手動更新：先重新整理，再確認結果
手動更新適合在首次匯入後驗證、服務商通知調整後同步，以及自動更新失敗時排查。操作前請確認裝置可正常連線。若 Home 有多個訂閱群組，先記下目標群組名稱，以免把其他群組的清單變化誤認為此次更新結果。
-
確認目標群組
前往 Home，找到要更新的訂閱群組。確認該群組使用的是自己現有服務商提供的訂閱網址，而非個別伺服器的連線資訊。
-
下拉重新整理
在 Home 的清單區域向下滑動，觸發訂閱更新。若有多個訂閱群組，請留意各組的更新結果，不要只依其中一組成功就判定全部更新成功。
-
等待更新結果
等待重新整理完成，並記下是否出現逾時、解析失敗或其他錯誤訊息。請勿在請求尚未完成時連續下拉，也不要在請求進行中修改訂閱網址。
-
核對清單項目
展開目標群組，確認服務商預告的新名稱或項目是否出現。若原先選取的伺服器已遭移除，請改選清單中仍可用的項目。
-
測試連線
使用實際需要存取的網頁或服務測試連線。分別記錄「訂閱是否更新成功」和「選取的伺服器是否可用」，不要將兩項結果混為一談。
例如，更新前後都是 12 個項目，並不能證明沒有更新：其中一個項目的伺服器網址可能已變更，只是名稱和總數維持不變。反過來說，出現新名稱也不代表所有伺服器都能連線。應綜合更新結果、預期變化和連線測試判斷，而非只看清單長度。
開啟時自動更新：Settings → Subscribe
若想減少手動重新整理的次數，前往 Settings → Subscribe，找到並啟用 Update on Open（開啟 App 時更新）。設定完成後，下次開啟 Shadowrocket 時查看 Home 的更新結果；首次設定完成後，仍建議手動更新一次，確認訂閱網址與目前的網路路徑都能正常使用。
「開啟時」指在 App 開啟時觸發更新，不代表每隔固定分鐘在背景輪詢，也不表示 App 會一直在背景取得最新清單。系統排程、網路狀態，以及 App 當時是否正在處理請求，都可能影響實際完成時間。請勿將此選項當作服務到期提醒或連線保活設定。
兩種更新方式：依使用情境選擇
手動更新
- 路徑：在 Home 清單下拉重新整理。
- 適用情境：首次驗證、收到調整通知、排查錯誤。
- 優點：可在同一次操作中查看請求結果與清單變化。
- 注意：每次只變更一項相關設定，再重新整理確認。
開啟時更新
- 路徑：Settings → Subscribe → Update on Open。
- 適用情境：已確認訂閱有效，希望在開啟 App 時同步清單。
- 必要條件：開啟 App 時，訂閱網址必須有可用的存取路徑。
- 注意：開啟 App 不代表請求一定會成功。
先用手動更新確認訂閱有效，再啟用開啟時更新；兩種方式可以搭配使用，不必反覆刪除並重新匯入訂閱。
若自動更新沒有取得新清單，先在相同網路下手動重新整理。手動更新也失敗時，應進一步排查網路或網址；若手動更新成功，但開啟時未完成更新，則確認是否已啟用該選項，以及開啟 App 時是否具備與手動重新整理相同的網路條件。
Update via Proxy 與 On Demand 的差異
部分訂閱網址在目前網路下無法直接存取，但可透過既有的可用連線存取。此時可查看 Settings → Subscribe 中的 Update via Proxy。此選項會影響訂閱請求是否透過代理傳送，但無法修復已過期的 token，也無法讓已失效的伺服器恢復可用。
訂閱請求路徑
- 設定位置
- Settings → Subscribe
- 選項
- Update via Proxy
- 用途
- 讓訂閱更新請求透過代理路徑傳送。
- 必要條件
- 已有可用伺服器，且相應的連線路徑已建立。
切換此選項後，返回 Home 手動重新整理並比較結果；發生逾時不代表一定要啟用此選項。
自動連線條件
- 設定位置
- Settings → On Demand
- 用途
- 依設定的網路條件觸發或停止 VPN 連線。
- 與更新的關係
- 影響連線是否具備，不會取代訂閱更新。
- 檢查方式
- 先確認目前的連線狀態，再到 Home 驗證更新結果。
On Demand 與 Update on Open 是不同設定：前者處理連線條件，後者處理開啟 App 時的訂閱同步。
排查時請維持條件一致，方便比較：先在目前網路下重新整理一次並記錄錯誤；若已有伺服器可正常連線，再建立連線、檢查 Update via Proxy 並重試。不要同時切換網路、Global Routing 和多個訂閱選項，否則即使更新成功，也難以判斷是哪項設定造成變化。
更新失敗時：依錯誤狀況逐項檢查
先保留原訂閱，不要把「刪除後重新新增」當作第一步。重新新增同一個失效網址，通常還是會得到相同結果，也可能失去方便比對的群組和選取狀態。記下錯誤訊息、發生時使用的網路、是否啟用 Update via Proxy，以及問題是否只出現在某個訂閱群組，通常更有助於找出原因。
下拉重新整理一直逾時，應先調整哪項設定？
先確認裝置已完成目前 Wi-Fi 的網路認證，再回到 Home 重試。若一般上網正常，但訂閱請求逾時，可換用另一個自己能使用的網路進行比較；若已有可用的代理連線，再檢查 Settings → Subscribe → Update via Proxy。每次只變更一項條件，並記錄結果。
出現解析失敗，為什麼換網路也無效？
解析失敗可能是網址回傳登入頁、錯誤訊息或不支援的內容，而非有效的訂閱資料。回到原服務商的訂閱管理頁面，重新複製完整網址，並確認複製的不是方案介紹頁或個別伺服器參數。若仍然失敗，請將錯誤文字提供給原服務商，並確認回傳格式。
昨天還能更新，今天卻顯示沒有權限，該怎麼辦？
檢查原服務商帳戶的有效期限，以及訂閱 token 是否已重設。若請求結果包含 HTTP 401 或 403，請優先確認授權與服務狀態；403 也可能是伺服器端的存取限制，不能只憑狀態碼判斷方案已到期。取得新網址後，更新目標訂閱再重新整理。
更新成功了，為什麼清單還是一樣？
先確認目標訂閱群組，再確認服務商是否確實發布了變更。同名項目可能已更新連線參數；若回傳內容原本就沒有變化，清單維持不變是正常情況。不要為了讓數量改變而連續重複發出請求。
更新後清單是空的，需要立刻刪除訂閱嗎？
先確認群組是否已展開，以及是否啟用了搜尋篩選；接著查看重新整理時有沒有解析錯誤。確認網址完整且服務有效後，清單仍是空的，就請原服務商確認該帳戶實際回傳的內容。保留網址與錯誤紀錄，在原因釐清前不要反覆刪除所有設定。
訂閱網址常見格式例如 https://example.com/sub?token=xxxx，這只是無效的範例。實際網址的路徑、參數名稱與字元，請以自己的服務商提供內容為準；複製時不要帶入換行、空格或聊天文字，也不要自行刪除問號後的參數。網址中的 & 等分隔符也可能有作用，請完整複製。
更新後確認：分別判斷清單同步與連線是否可用
訂閱請求成功，只代表用戶端已取得並處理回傳內容。伺服器是否可連線、驗證資訊是否有效，以及 Global Routing 是否符合預期，屬於後續的連線檢查。若清單已更新但仍無法存取，繼續重複更新通常無法解決規則或連線問題。
- 檢查選取項目：返回 Home，確認選取的伺服器仍在更新後的群組中；若原項目已遭移除，請重新選擇。
- 檢查模式：若需要依規則分流，請確認 Global Routing 設為 Config，並檢查實際生效的設定。Proxy 與 Direct 的處理方式不同，不應混用為同一組測試條件。
- 檢查規則：Config 中的 DOMAIN-SUFFIX、IP-CIDR、GEOIP 等規則，以及 FINAL 預設規則，都屬於規則設定，不會因重新整理伺服器訂閱而自動修正。
- 檢查憑證：若只有某個伺服器失敗，請分別測試它與同組其他項目，避免將單一連線故障誤判為整個訂閱無法更新。
- 檢查自動更新：確認手動重新整理正常後，保留 Update on Open 設定，等下次開啟 App 時再查看結果；不必頻繁退出並重新開啟來反覆發送請求。
日常使用可維持固定流程：收到服務商調整通知後，在 Home 手動重新整理；核對預期項目；重新確認目前的選取項目；最後進行一次實際存取測試。平時則由開啟時更新協助同步。遇到失敗時，先分辨是請求失敗、內容解析失敗還是連線失敗，再處理相應環節。