本文適合已擁有自己的服務商與訂閱連結，並需要更新伺服器清單的使用者。先在 Home 手動更新，確認連結能正常取得資料，再前往 Settings → Subscribe 設定開啟時更新；若更新失敗，請依序檢查存取權限、網路連線與回應格式。更新訂閱、更新 Config 和更新應用程式是不同操作，彼此不能取代。
訂閱更新會變更哪些內容
Shadowrocket（小火箭）儲存訂閱網址後，會從該網址取得伺服器資訊。之後更新時仍會連線至這個網址，並依據回傳內容更新清單中的伺服器與連線參數等資訊。因此，清單沒有新增項目不一定代表更新失敗：服務商回傳的內容可能與上次相同。
請分別判斷以下操作，避免在錯誤的位置反覆更新。本文主要介紹 iPhone / iPad 上 Home、Settings 頁面的操作；其他平台的介面可能不同，但排查網路要求與訂閱回應的順序仍適用。
| 操作項目 | 操作目的 | 無法取代的操作 |
|---|---|---|
| Home 中的訂閱 | 重新取得伺服器清單與連線參數。 | 無法延長服務商帳戶效期，也不等於更新規則。 |
| Config 中的設定 | 管理設定檔及其中的規則、DNS 等設定。 | 不等於更新 Home 的訂閱清單。 |
| Shadowrocket 應用程式 | 更新用戶端程式本身。 | 無法自動讓已失效的訂閱網址恢復有效。 |
在 Home 手動更新訂閱
先手動更新一次，確認網址與網路都正常，再開啟自動更新。請勿先刪除原有訂閱：既有伺服器可能仍可使用；若刪除後新網址無法連線，也會失去可供排查的舊資料。
-
確認訂閱項目
開啟 Home，找到自己的訂閱群組，確認其中不是只有手動新增的伺服器。手動輸入的單一伺服器資訊沒有可用來更新清單的訂閱網址。
-
新增訂閱網址
尚未新增訂閱時，前往 Home → 右上角「+」→ Type → Subscribe，在 URL 欄位輸入完整的訂閱網址，填入方便辨識的名稱後儲存。
-
下拉更新
返回 Home 的伺服器清單，在清單頂端下拉後放開，等待更新完成。清單較長時請先捲動至頂端；下拉通知中心並不是在應用程式內更新。
-
查看結果
留意是否出現錯誤訊息，再確認目標訂閱中的伺服器名稱與數量。若有多個訂閱，請分別查看目標群組；不能只根據其中一個群組有變化，就判定所有訂閱都已更新成功。
-
測試連線
選取更新後的伺服器並測試連線。若更換了伺服器或連線參數，請先中斷連線再重新連線，接著測試網頁是否能開啟，避免把原有連線的結果誤認為新參數的效果。
訂閱網址通常包含帳戶憑證。例如 https://example.com/sub?token=xxxx 只是無法用來取得服務的虛構範例。實際複製時請保留完整查詢參數，不要漏掉問號後方的內容，也不要把網址兩側的引號、空格或聊天軟體附加的文字一併貼上。
設定開啟時自動更新
開啟時自動更新適合希望進入應用程式後取得最新清單的使用者。更新會在應用程式開啟時觸發，不表示應用程式關閉後系統仍會持續或定時存取訂閱，也不保證網路無法使用時一定能更新成功。
-
前往設定
開啟 Settings → Subscribe，找到 Update on Open。介面語言不同，顯示文字可能有所差異；請在訂閱設定中確認對應的開啟時更新選項。
-
啟用更新
啟用 Update on Open，再返回 Home。此選項只會變更更新的觸發方式，不會更換 URL，也無法修復已過期的帳戶憑證。
-
重新開啟應用程式
確認網路可用後重新開啟應用程式，並查看更新結果。只在應用程式內切換 Home 與 Settings 頁面，不能用來確認重新開啟後是否會觸發更新。
-
保留手動檢查方式
服務商通知清單已調整，但目前清單沒有變化時，仍可返回 Home 下拉更新。若出現錯誤，請先記錄訊息，不要短時間內連續重試。
Settings → On Demand 用於依條件建立 VPN 連線，不是訂閱定時更新功能。啟用 On Demand 不代表啟用 Update on Open；同樣地，自動更新成功也不代表 VPN 已連線。請分別確認訂閱更新結果與 Home 的連線狀態。
更新時透過 Proxy 或直接連線
訂閱網址能否連線，與清單中的伺服器是否可連線是兩回事。某台伺服器可以正常使用，不代表目前能連上訂閱網站；訂閱可以下載，也不代表每台回傳的伺服器都能連線。請先確認失敗發生在哪個步驟，再決定是否變更要求路徑。
| 檢查項目 | 用途 | 操作判斷 |
|---|---|---|
| Settings → Subscribe → Update via Proxy | 控制更新訂閱時是否透過 Proxy 發出要求。 | 直接連線失敗且已有可用 Proxy 時，可啟用後再試。 |
| Home → Global Routing | 選擇 Proxy、Direct、Config 或 Scene 等路由模式。 | 先記錄原本設定；請勿為了更新訂閱而長期變更日常路由。 |
| Settings → On Demand | 依設定條件觸發 VPN 連線。 | 排查中斷連線時的直接連線狀況，並留意是否重新建立了連線。 |
若目前網路無法直接連線至訂閱網址，可先使用仍能連線的既有伺服器建立連線，再前往 Settings → Subscribe 啟用 Update via Proxy，然後返回 Home 更新。若所有既有伺服器都無法使用，就不能把「透過 Proxy 更新」當成可行的修復方式；此時請改用可信任的網路，或向自己的服務商確認網址能否直接連線。
- 每次只變更一個項目：先切換 Wi-Fi 與行動網路，或只切換 Update via Proxy，再更新並比較結果。
- 使用公共 Wi-Fi 前，通常需要先完成網路登入。尚未通過驗證時，要求可能會被導向登入頁，而不是取得訂閱資料。
- 確認完成後，請恢復原本的 Global Routing 設定，不必為了更新一次訂閱而一直使用 Proxy。
依錯誤訊息判斷原因
錯誤訊息可能來自應用程式、系統網路層或訂閱伺服器，且文字會因語言與情況而異。以下列出常見提示與 HTTP 狀態碼；請以實際顯示的訊息為準，不要只憑「更新失敗」就判定帳戶已到期。
錯誤：The request timed out.
原因與處理方式：要求未能在時限內完成，可能是網路連線路徑異常或伺服器回應過慢。先切換網路重試一次；若已有可用連線，再比較啟用 Update via Proxy 後的結果，避免連續更新增加伺服器負載。
錯誤：A server with the specified hostname could not be found.
原因與處理方式：無法解析訂閱網域。請確認 URL 的主機名稱是否完整複製，並確認目前網路能正常解析其他網域；接著向自己的服務商確認訂閱網域是否已變更。
錯誤：401 Unauthorized
原因與處理方式：伺服器不接受目前要求所附的憑證。請登入自己的服務商帳戶，確認連結是否已重設，並重新複製完整 URL；不要只更換連結中的網域，卻繼續使用舊 token。
錯誤：403 Forbidden
原因與處理方式：伺服器拒絕了要求，可能與帳戶權限或存取限制有關。請確認服務狀態，並將狀態碼與發生時間提供給自己的服務商；反覆切換規則無法解除伺服器端的權限限制。
錯誤：404 Not Found
原因與處理方式：找不到目前路徑所指向的資源，可能是連結路徑遭截斷，或原網址已撤銷。請重新取得完整訂閱網址，不要將帳戶登入頁的網址當成訂閱 URL。
錯誤：429 Too Many Requests
原因與處理方式：要求次數已觸發伺服器限制。請停止反覆下拉更新，等待伺服器允許再次嘗試；若回應中包含 Retry-After，請依照指定時間等待，再更新一次。
憑證驗證錯誤應另外處理：先確認裝置日期與時間正確，再改用可信任的網路驗證，並請自己的服務商檢查憑證有效期限與網域是否相符。請勿關閉憑證驗證來掩蓋問題，否則無法可靠確認訂閱回應是否來自預期的伺服器。
格式錯誤或清單沒有變化
網路要求成功，不代表訂閱解析也成功。HTTP 200 只表示伺服器成功傳回回應，回應本文仍可能是帳戶登入頁、存取驗證頁面、到期通知或空白內容。遇到這類情況，應檢查回傳內容的類型，而不是繼續修改 Global Routing。
- 回傳網頁：若開啟網址後需要登入或顯示完整網頁，請確認複製的是訂閱連結，而非帳戶頁面。瀏覽器可以登入帳戶，不代表應用程式發出的訂閱要求已取得存取權限。
- 回傳空白內容：請向自己的服務商確認帳戶是否有可用項目，以及目前網址是否應回傳資料。沒有備份時，請勿刪除舊群組後再反覆重新匯入。
- 格式無法解析：請使用服務商明確提供給 Shadowrocket 的訂閱格式。不要只根據檔案副檔名判斷是否相容，也不要自行轉換網頁本文後重新匯入。
- 只有部分項目：請確認缺少項目的協定與參數是否受目前用戶端支援。Shadowsocks、VMess、VLESS、Trojan、Hysteria2、WireGuard 的欄位各不相同，不能只修改協定名稱來轉換連線資訊。
- 更新後數量未變：請比較伺服器名稱與參數是否有所變動。數量相同不代表內容相同；若內容原本就沒有變動，也不必刻意新增項目來驗證更新。
訂閱更新常見問題
已開啟自動更新，為什麼清單還是舊的？
先在 Home 下拉更新並查看錯誤訊息，再檢查 Settings → Subscribe → Update on Open。若手動更新也失敗，請排查網址或網路問題；若手動更新成功但內容相同，請向自己的服務商確認來源清單是否確實有變動。
更新成功了，為什麼網頁還是打不開？
更新成功只表示清單已取得並完成解析。請返回 Home 選取可用伺服器，重新連線並檢查 Global Routing；若使用 Config，也請檢查對應設定中的 DNS、規則與 FINAL 策略。請勿將網頁無法開啟直接當成訂閱故障。
每次更新都要重新匯入連結嗎？
不需要。訂閱網址仍有效時，在 Home 更新即可。只有自己的服務商更換網址、重設憑證或撤銷舊連結時，才需要編輯訂閱網址；重複新增相同連結容易產生多個難以辨認的群組。
已購買用戶端，為什麼訂閱還是顯示到期？
用戶端買斷 ≠ 線路方案。iPhone / iPad 版在 App Store 一次性購買，價格為 $2.99；Mac、Windows、Android、Linux 版免費。上述取得方式都不會延長自己的服務商帳戶效期。訂閱權限與有效期限請向自己的服務商確認。
排查完成後，建議記錄成功更新時使用的網路類型、Update via Proxy 狀態，以及是否啟用 Update on Open。下次更新失敗時，先與這組已知可用的條件比較，通常比同時修改 DNS、路由模式和訂閱網址更容易找出問題。本站不提供、不銷售，也不推薦節點、訂閱、連線服務。