本文適用於已有自己的服務商與訂閱連結，並需要在 Shadowrocket（小火箭）中重新整理伺服器列表的使用者。先在 Home 手動更新並確認結果，再啟用開啟 App 時更新；若更新失敗，依序檢查連結、網路請求、回應內容與解析結果，避免混淆訂閱更新問題和連線問題。
先分清訂閱更新、App 更新與設定檔更新
訂閱更新會重新請求已儲存的訂閱網址，並將回傳內容解析為 Home 中的伺服器項目。服務商調整伺服器位址、連接埠或驗證資訊後，需要取得新的訂閱內容；僅中斷 VPN 連線再重新連線，不等於重新取得訂閱。
App 更新由 App Store 提供，更新的是 Shadowrocket 本身。Config 中的設定檔則包含規則、DNS 等設定，其遠端更新與 Home 的伺服器訂閱重新整理並非同一項操作。排查前應先確認要更新的是哪一項。
在 Home 手動更新訂閱
首次新增時，請使用服務商明確提供的訂閱網址，不要使用帳戶登入頁、訂單頁或網頁分享網址。已有訂閱時，先保留原有項目，不要為了重新整理而反覆刪除再新增，以免遺失可供比對的舊狀態。
-
確認訂閱
開啟 Home，找到要更新的訂閱群組，確認它屬於自己的服務商。若尚未新增訂閱，點選 Home 右上角的「+」進入新增頁面，在 Type 選擇 Subscribe，將自己的訂閱網址填入 URL 後儲存。
-
記錄目前狀態
記下目標群組目前的項目數量，以及一個已知伺服器的名稱或連接埠。請勿將完整 URL、密碼或驗證參數放入截圖；公開比對時不需要提供這些資訊。
-
下拉重新整理
返回 Home，在列表中下拉以觸發訂閱更新，並等待本次請求完成。若有多個訂閱，請分別確認各群組的結果，不要因其中一個群組更新成功，就認為全部都已成功。
-
確認更新結果
查看是否出現錯誤提示、目標群組是否仍有項目，以及服務商說明的變更是否已反映。項目數量不變不一定代表失敗，回傳內容也可能只更新了位址、連接埠或驗證資訊。
-
另外測試連線
選取準備使用的伺服器，再測試連線與存取。更新成功只表示訂閱已取得並完成解析，不代表每一台回傳的伺服器都能連線。
以下僅以假資料示範訂閱 URL 的結構，不可匯入，也不能取代你自己的網址。實際連結中的查詢參數通常用於驗證，複製時應保持完整，避免混入空格、換行或中文標點。
https://example.com/sub?token=xxxx設定開啟 App 時自動更新
手動更新成功後，前往 Settings → Subscribe，找到 Update On Open 並開啟。不同介面語言或 App 版本的文字與大小寫可能有所差異，請以目前訂閱設定頁中代表「開啟 App 時更新」的選項為準。
- 啟用前：先在 Home 手動重新整理一次，確認 URL 有效，且目前的網路能夠取得訂閱內容。
- 啟用後：重新開啟 Shadowrocket，留意訂閱請求結果，再檢查 Home 中的目標群組。不要只因 App 已開啟，就認定訂閱已更新完成。
- 驗證範圍：開啟時更新是與 App 啟動相關的觸發方式，不代表 App 關閉後仍會依固定間隔持續重新整理，也不保證每次切回前景時都會發出新請求。
- 失敗處理：若自動更新失敗，請返回 Home 手動觸發一次並記錄錯誤。自動觸發無法修復失效的驗證參數或無法連線的訂閱網域。
依請求流程找出更新失敗環節
一次更新至少會經過以下環節。先找出失敗發生在哪一步，再調整相應設定，通常比同時更換 DNS、伺服器和設定檔更容易確認原因。
| 觀察到的狀況 | 優先檢查 | 下一步 |
|---|---|---|
| 立即回傳 401 或 403 | 驗證參數、連結有效性、存取限制 | 向自己的服務商確認目前的訂閱網址及存取條件 |
| 等待後逾時 | 目前網路、網域解析、伺服器回應 | 保持連結不變，切換一次可用網路後再試 |
| 成功回傳，但無法解析 | 確認回應是否為登入頁、驗證頁或不支援的內容 | 確認複製的是可供用戶端匯入的訂閱網址 |
| 重新整理完成，但項目沒有變化 | 確認服務商是否確實修改了內容 | 比對已知名稱、位址或連接埠，不要只看數量 |
| 重新整理成功，但無法連線 | 已選取的伺服器、驗證資訊及連線路徑 | 改為排查連線問題，不要再反覆重新整理訂閱 |
結論：先分清取得失敗與連線失敗
若列表已成功解析，接下來應檢查選取的伺服器與連線記錄；若尚未取得訂閱回應，則應先處理 URL 與網路。不要用同一個「更新失敗」來描述不同階段的問題。
常見錯誤訊息與處理順序
以下列出網路請求中可能出現的原文或 HTTP 狀態訊息。不同系統語言、伺服器及 App 介面的顯示方式可能不同。請保留實際看到的完整錯誤內容，而不要只記下「不能用」。
HTTP 401 Unauthorized
原因：伺服器未接受本次請求的驗證資訊，可能是 token 已失效、缺少參數，或使用了舊網址。
解決方式：在自己的服務商帳戶中確認目前有效的訂閱 URL，完整替換原有網址後手動重新整理。不要自行猜測或拼湊驗證參數。
HTTP 403 Forbidden
原因：伺服器拒絕此次存取，可能與帳戶狀態、來源網路限制或伺服器端的存取政策有關，不能只憑狀態碼判定連結已過期。
解決方式：記錄發生時間、目前的網路類型與狀態碼，並向自己的服務商確認限制條件；不要短時間內連續重試。
HTTP 404 Not Found
原因：訂閱路徑不存在，常見原因包括網址遭截斷、訂閱入口已遷移，或複製了錯誤路徑。
解決方式：重新核對完整 URL 的網域、路徑與查詢參數，改用帳戶中目前顯示的網址後再更新。
The request timed out.
原因：請求未能在限定時間內完成，可能發生在建立連線、網路傳輸或等待伺服器回應的階段。
解決方式：先確認裝置能正常連上網路，再切換 Wi-Fi 與行動網路進行一次交叉測試；若只有其中一種網路失敗，優先檢查該網路的存取條件。
連結可以開啟，卻沒有可用的伺服器項目
瀏覽器能顯示網頁，只能證明它取得了某種回應，不能證明回傳內容就是訂閱。登入頁、帳戶餘額頁或存取驗證頁都可能回傳 HTTP 200，但這些內容無法用作伺服器列表。
- 檢查網址來源：應複製帳戶中明確標示為訂閱的連結，而不是瀏覽器網址列中的管理頁面 URL。
- 檢查回應內容類型：若回傳的是 HTML 頁面、登入提示或錯誤 JSON，應先處理伺服器端的存取問題，不要藉由修改伺服器連接埠來解決。
- 檢查格式相容性：向自己的服務商確認該連結提供的是 Shadowrocket 可辨識的訂閱格式。編碼正確與協定欄位完整是兩項不同的要求。
- 檢查替換結果：若更換網址後仍沒有項目，請先保留原有群組與錯誤記錄，避免尚未釐清問題就刪除所有既有資訊。
Shadowsocks、VMess、VLESS、Trojan、Hysteria2、WireGuard 是協定名稱，不是將一般網頁轉換成訂閱的開關。連接埠也應以回傳內容或服務商提供的參數為準；訂閱 URL 使用 HTTPS 常見連接埠 443，不代表其中所有伺服器也都使用 443。
更新後的連線驗證與問題記錄
更新完成後，先確認 Home 中選取的是預期的伺服器，再核對 Global Routing。Proxy、Direct、Config、Scene 對流量的處理方式不同，目前的模式會影響存取驗證；這些選項都不是訂閱更新按鈕。
- 確認選取項目：服務商移除或更名項目後，請重新選取一個仍存在的項目，避免依據舊的選取項目判斷。
- 確認分流模式：依照原本用途檢查 Global Routing。使用 Config 時，請前往 Config 確認目前啟用的設定檔；規則可能會將測試請求分配至 DIRECT，而非所選的代理伺服器。
- 驗證實際存取：連線後，存取自己常用且允許存取的目標，並搭配連線記錄觀察結果。延遲測試有回應，不代表所有服務請求都正常。
- 保留必要記錄：記錄重新整理時間、錯誤原文、網路類型、目標群組是否有變化，以及是否已完成連線驗證。每次只變更一個條件，方便重現問題。