適用於已有服務商與訂閱，但在 Shadowrocket（小火箭）中無法更新或看不到節點的使用者。請先保留原有設定，分辨是請求失敗、回應無法解析，還是回傳空集合，再檢查連結、帳戶狀態與更新所用的網路。每次只變更一個條件，避免反覆刪除訂閱或連續重新整理而掩蓋原因。
先分辨訂閱更新失敗與節點連線失敗
訂閱更新是向某個網址取得伺服器設定；連線測試則是使用已匯入的伺服器連上網路。兩者的流程不同。舊節點仍可連線，不代表訂閱網址仍有效；訂閱更新成功，也不代表其中每台伺服器都能連線。請先在 Home 確認出問題的是哪個訂閱群組，並記下目前時間、節點數量與完整提示。
「清單空白」也要分成兩種情況：原有項目確實消失，或只是目前檢視畫面沒有顯示。先清除 Home 中的搜尋條件、展開訂閱群組，再確認是否看錯群組。不要用 Config 中的規則檔清單判斷節點是否存在；規則設定與伺服器訂閱的用途不同。
- 記下更新前的節點數量；若已有可用節點，先保留，不要刪除訂閱群組。
- 在 Home 對目標訂閱更新一次；若介面支援下拉更新，可下拉重新整理，並確認目標群組的結果。
- 將結果分為請求失敗、解析失敗、更新成功但內容空白，或節點已顯示但無法連線，再進行相應排查。
檢查訂閱連結：完整網址不等於一般網頁網址
前往使用者原有服務商的帳戶頁面，重新複製明確標示可供 Shadowrocket 使用的訂閱網址。不要從聊天預覽、遭截斷的通知或截圖辨識結果中還原連結。網頁上顯示的省略號不是網址內容；帳戶登入頁和方案介紹頁也不是訂閱介面。
訂閱網址通常包含查詢參數；這些參數通常用於識別身分或選擇格式。貼上後請檢查是否多了引號、空格、換行或中文標點，尤其確認 ?、&、= 後方的內容是否完整。參數值可能區分大小寫，請勿自行修改，也不要為了「簡化」而刪除末尾參數。
https://example.com/sub?token=xxxx以上是無法用於實際訂閱的虛構值，僅用來說明網址結構。真實 token 應視為存取憑證，不要貼在公開留言、截圖或線上轉換頁面中。有些訂閱使用路徑中的憑證，而非 token 參數，因此沒有該參數不代表連結錯誤；請以服務商提供的原始網址為準。
https://網址可能是訂閱，也可能是一般網頁，仍須確認回傳內容。ss://、vmess://、vless://、trojan://通常代表單一伺服器設定，不應當成可定期更新的 HTTP 訂閱網址。- 如果複製的是 QR Code，請先確認內容是訂閱還是單一設定；「掃描成功」本身無法證明它能用來更新整份清單。
- 如果服務商重設了訂閱憑證，請在原訂閱中換成新網址，再更新一次；重新安裝客戶端不會讓舊網址恢復有效。
依錯誤類型檢查連結失效、流量限制與回傳內容
以下列出網路或 HTTP 層常見的錯誤識別碼，不保證每個平台都會逐字顯示。記錄時請保留實際提示，不要只憑「失敗」兩字判斷帳戶已到期。如果只看到一般失敗提示，請搭配更新時間與服務商端的存取記錄確認。
HTTP 401 Unauthorized
原因與解決方式：請求未通過身分驗證，可能是憑證缺漏、已重設或失效；請重新複製帳戶中目前有效的訂閱網址，並向自己的服務商確認憑證狀態。
HTTP 403 Forbidden
原因與解決方式：伺服器拒絕此次存取，可能與帳戶權限、來源位址或存取政策有關；請確認帳戶是否有可用訂閱，並詢問服務商是否限制目前使用的網路或請求方式。
HTTP 429 Too Many Requests
原因與解決方式：請求頻率超過伺服器限制；請停止連續重新整理。若回應提供 Retry-After，請依指示等待；否則按照服務商提供的間隔再試一次。
HTTP 200 OK，但解析失敗或沒有任何項目
原因與解決方式：HTTP 請求成功不代表內容是有效訂閱；回應可能是登入頁面、驗證頁面或空白內容。請服務商確認該網址實際回傳的資料，以及是否相容於 Shadowrocket。
訂閱可能以編碼文字或其他支援的結構回傳，不能只因瀏覽器中「看起來像亂碼」就判定資料損毀。反過來說，能開啟版面完整的網頁，也不能證明訂閱有效。需要確認的是回應中是否包含客戶端可辨識的伺服器設定，而不是網頁能否正常顯示。
結論：若有狀態碼，先處理伺服器端的拒絕原因
若記錄中明確出現 401、403 或 429，請先處理憑證、權限或重新整理間隔；反覆切換 Global Routing 無法修復失效的 token，也無法解除伺服器端的存取限制。
檢查更新使用的網路與 Update via Proxy
若沒有收到 HTTP 回應，只有逾時或網域名稱解析錯誤，再檢查網路路徑。先確認系統網路可正常使用；若連線的是需要網頁驗證的 Wi-Fi，請先完成驗證。接著對同一個訂閱網址進行一次控制變因的測試，不要同時變更 DNS、路由方式與訂閱參數。
在提供此選項的介面中，可前往 Settings → Subscribe → Update via Proxy，檢查訂閱是否透過代理更新。啟用後，請先確認 Home 中選取的現有伺服器可正常連線，再更新目標訂閱。選單位置與名稱依平台實際介面而異，請勿假設所有平台的版面都相同。
| 觀察結果 | 下一步操作 | 判斷依據 |
|---|---|---|
| 一般網頁也無法開啟 | 先恢復 Wi-Fi 或行動網路連線，並完成網路驗證 | 暫時不要修改訂閱連結或規則 |
| 直接更新逾時，但現有伺服器可連線 | 啟用 Update via Proxy 後只重試一次 | 成功只表示兩種網路路徑的連線能力不同 |
| 啟用後失敗，但直接更新成功 | 使用可成功的更新方式，檢查代理路徑 | 不要混淆更新方式與日常分流策略 |
| 兩種方式都回傳 403 | 記下發生時間與狀態碼，聯絡自己的服務商 | 優先檢查伺服器端的存取限制 |
Home → Global Routing 中的 Proxy、Direct、Config、Scene 用於選擇路由方式，不代表訂閱介面有效性檢查。Config 下的 DOMAIN-SUFFIX、IP-CIDR、GEOIP 與 FINAL 會影響相應流量的策略比對，但在規則中新增 FINAL,PROXY 無法補回空白的訂閱回應。
- 若沒有任何可連線的現有伺服器，不要把「透過代理更新」當成一定有效的修復方式。
- 若連線狀態自行變動，請檢查 Settings → On Demand 的隨選連線條件，並記錄測試時是否實際連線。
- 切換 Wi-Fi 與行動網路後，請等網路穩定再更新；不要在切換當下連續送出多次請求。
更新成功但節點空白：確認帳戶、格式與群組
如果客戶端顯示更新完成，但清單仍是空白，請先檢查檢視畫面，再確認伺服器端是否實際分配了伺服器。能登入帳戶、有歷史訂單，與目前有可用訂閱是不同條件。請查看原有服務商帳戶中的有效期限、流量狀態及訂閱權限；停用規則以該服務商的說明為準。
- 排除顯示問題：清除搜尋文字、展開目標群組，並確認不是在查看其他訂閱或頁面。
- 確認輸出格式：若帳戶頁面提供不同格式，請選擇明確支援 Shadowrocket 的輸出；不要把規則檔網址填入伺服器訂閱。
- 確認回傳集合：請服務商確認該網址在此次請求時是否回傳非空的伺服器集合，而不只是確認介面狀態為 200。
- 確認內容可解析：若回傳內容非空但節點仍為零，請提供已遮蔽敏感資訊的錯誤提示，並請服務商檢查欄位與格式相容性；不要在公開管道傳送完整設定。
不要手動將所有協定改成同一種類型。Shadowsocks、VMess、VLESS、Trojan、Hysteria2、WireGuard 的欄位與連線方式各不相同，修改協定名稱並不能完成格式轉換。若只有部分項目消失，請比對缺少項目的類型與服務商輸出，不要先刪除全部設定。
結論：空集合與解析失敗需要分別查證
請服務商確認「回應是否非空、是否包含有效的伺服器設定」，比反覆詢問「連結能不能開啟」更明確；先取得結果，再決定要修復帳戶分配還是訂閱格式。
更新時機與復原順序
剛完成續約、重設憑證或變更帳戶設定時，客戶端取得的內容可能尚未反映伺服器端的最終狀態。不要自行假設固定的等待時間；請查看服務商是否說明生效時間或重新整理間隔，並在確認後再更新。若出現 429，尤其應停止短時間內重複送出請求。
保留仍可用的舊項目，可作為網路測試的參照。復原前不要同時解除安裝應用程式、刪除 Config 並清空訂閱；這些操作會減少可供比較的資訊，也無法解決遠端回應空白的問題。請妥善保管既有備份，因為匯出的設定可能包含伺服器憑證。
- 保存目前的訂閱名稱、原有項目數量與已遮蔽敏感資訊的錯誤記錄。
- 從帳戶頁面取得有效網址，只變更目標訂閱的設定。
- 在穩定的網路環境下，依已確認的更新方式操作一次並記錄結果。
- 項目恢復後，在 Home 選取伺服器進行 Connectivity Test，再測試實際需要存取的頁面。
- 若項目已恢復但仍無法連線，請改為排查連線問題，不要再當成訂閱空白處理。
訂閱更新常見問題與回報資訊
舊節點還能使用，為什麼訂閱卻更新失敗？
舊項目儲存在本機，更新則需要重新向訂閱介面送出請求。請先保留舊項目，確認訂閱憑證是否已重設，再檢查更新請求的狀態碼；不要以連線測試成功取代訂閱有效性檢查。
重新整理次數越多，恢復得越快嗎？
不是。重複重新整理可能觸發流量限制。遇到 429 時，請依 Retry-After 或服務商說明等待；若沒有明確間隔，請先詢問服務商，不要以自動連續重試取代排查。
用瀏覽器開啟連結時要求登入，客戶端該怎麼處理？
先確認複製的是訂閱介面，而不是帳戶頁面。客戶端不會因為瀏覽器已登入，就自動取得相同的工作階段；請從帳戶中重新複製專用訂閱網址。若仍回傳登入頁面，請服務商檢查介面。
更新後只少了幾個節點，也需要重新安裝嗎？
先確認服務商是否調整了回傳集合，再檢查缺少項目的格式與協定欄位。其他項目正常時，重新安裝不是優先處理方式；記錄缺少的範圍，有助於分辨是伺服器端變更還是解析問題。
回報問題時需要提供完整訂閱連結嗎？
公開回報只需提供平台、發生時間、錯誤原文、更新前後的數量、網路類型及 Update via Proxy 狀態。請遮蔽 token、密碼、QR Code 與含憑證的完整網址；若需核對帳戶，請透過原有服務商的私密支援管道處理。
若要進一步檢查客戶端連線與規則，請參閱故障排查。本文所有訂閱操作均以使用者已有自己的服務商與訂閱為前提。