Shadowrocket 訂閱解析失敗或伺服器列表空白：逐步排查指南

一、先分辨列表空白、更新失敗與連線失敗

訂閱網址用於取得一組伺服器設定，不等同於單一伺服器的連線網址。訂閱成功更新，不代表其中每台伺服器都能連線；反過來說，舊伺服器仍可使用，也不代表目前能連上訂閱介面。開始排查前，先在 Home 展開對應的訂閱群組，確認是整個群組沒有項目，還是項目仍在、只有 Connectivity Test 未取得有效結果。

1. 記錄狀況：記下錯誤原文、發生時間、使用的網路，以及更新後項目是否有變化。不要只記「無法使用」。
2. 保留現有紀錄：先不要刪除原訂閱、Config 或仍可連線的伺服器。若需保留畫面，請遮蔽訂閱網址、密碼與 token。
3. 檢查顯示狀態：確認 Home 中的對應群組已展開；若有使用搜尋或篩選，先清除條件，再確認列表是否真的空白。
4. 限定測試範圍：一次只檢查一筆訂閱。更新單一群組後觀察結果，不要以其他群組更新成功來代替這筆訂閱的驗證。

若項目正常顯示，只是連線逾時，應改查伺服器參數與連線狀況，而非繼續處理訂閱編碼。本文後續步驟主要針對無法取得或解析訂閱內容的情況。

二、核對連結格式、完整性與匯入位置

請從自家服務商的訂閱管理頁面重新複製完整網址，再與 Shadowrocket 中儲存的網址核對。不要拿帳戶登入頁、訂單頁或瀏覽器網址列中的管理頁面代替訂閱介面。含有 token 的查詢參數通常用於驗證身分；少一個字元或複製時多出換行，都可能改變請求結果。

https://example.com/sub?token=xxxx

以上僅為說明結構的虛構網址，無法提供伺服器項目。https:// 是通訊協定部分，example.com 是示例主機名稱，/sub 是示例路徑，問號後方則是查詢參數。實際路徑與參數應保留服務商提供的原樣，不要依照示例自行修改。

• 檢查首尾：移除複製時附帶的空格、引號與說明文字；確認結尾參數沒有遺漏。
• 檢查字元：全形標點不能取代半形 :、?、&。不要任意解碼或重新編碼網址中的 % 跳脫序列。
• 確認內容類型：單一伺服器分享內容與訂閱 URL 是不同類型的輸入。將多筆伺服器分享內容串在一起，也不會自動成為有效的訂閱介面。
• 檢查匯入位置：在 Home 新增訂閱類型的紀錄；Config 用於管理設定檔與規則，不應將任意訂閱網址當成 Config 設定檔網址匯入。
• 檢查憑證是否變更：若曾重設訂閱網址或 token，App 內的舊網址不會自動更新為新網址，請重新核對已儲存的內容。

三、確認服務商端狀態與 HTTP 回應

網址完整不代表介面一定會回傳伺服器設定。帳戶到期、存取權限變更、介面維護或請求頻率限制，都可能讓同一網址回傳不同內容。請先在自己的帳戶頁面確認訂閱是否有效、是否仍有可用項目，以及網址是否曾重設；這些狀態需由服務商確認，客戶端無法修復伺服器端的權限或資料。

以下是請求記錄或伺服器診斷中可能出現的 HTTP 狀態原文，並非 Shadowrocket 彈出訊息的逐字保證。若 App 未顯示狀態碼，不要只憑「列表空白」就認定是其中某一種狀況。

四、分別驗證更新時機與網路路徑

更新訂閱本身也是一次網路請求，需要完成網域解析、連線與 HTTPS 驗證。目前網路能開啟一般網頁，不代表也能連上訂閱主機。瀏覽器若已登入帳戶，可能會使用 Cookie 顯示內容；App 透過訂閱 URL 發出請求時，不一定具有相同的登入狀態，因此「瀏覽器能開啟」只能作為線索。

1. 先完成網路登入：若目前 Wi-Fi 需要網頁認證，請先完成認證，再回到 Home 手動更新。認證頁回傳的 HTML 不能當成訂閱內容解析。
2. 記錄一次更新結果：在 Home 下拉重新整理後，等候這次請求結束並記錄結果。請勿在請求尚未完成時連續操作。
3. 一次只變更一個條件：情況允許時，分別透過 Wi-Fi 與行動網路測試相同網址；其他訂閱設定保持不變，以判斷問題是否與目前網路有關。
4. 核對更新路徑：查看 Settings → Subscribe 中與更新相關的選項。若目前 App 顯示 Update via Proxy，請記錄其狀態，並確認所選路徑確實可用；實際初始值以目前 App 顯示為準。
5. 有可用連線後再測試代理路徑：若需透過代理更新，請先使用現有伺服器建立連線並確認可用，再更新訂閱。若列表空白且沒有其他可用伺服器，只開啟代理更新無法建立可用連線。
6. 檢查自動連線的影響：查看 Settings → On Demand 是否會在測試網路時自動重新連線。記下原有設定，避免把自動重新連線後的路徑誤記為未連線狀態；測試結束後請還原設定。

Home 中的 Global Routing 用於決定流量處理方式；Proxy、Direct、Config、Scene 並不是四種訂閱格式。尤其不要只看到 Proxy 就斷定訂閱請求已透過代理；訂閱更新選項、連線狀態與實際請求結果都需要分別確認。Config 中的規則也無法修復伺服器回傳的空白回應。

五、成功取得內容後，檢查回應內容與編碼

HTTP 請求成功不等於訂閱解析成功。即使狀態為 200 OK，回應本文仍可能是登入頁、維護通知、空白文字，或不適用於目前匯入入口的內容。此時應核對服務商提供的輸出類型，而不是反覆執行相同的下載。

Base64 是編碼方式，不是加密，也不保證內容就是有效訂閱。編碼文字遭截斷、混入說明文字，或解碼後仍是錯誤頁面，都可能導致解析失敗。不要將完整訂閱上傳至線上解碼工具；可請自家服務商檢查原始回應與編碼完整性，並提供適用於 Shadowrocket 的輸出。

• 保留原始內容：不要手動新增換行、刪除看似多餘的符號，或將多筆回應拼接後重新匯入。
• 核對格式與欄位：Shadowsocks、VMess、VLESS、Trojan、Hysteria2、WireGuard 是不同的通訊協定類型，不能只靠改寫名稱，就把一組參數變成另一種協定。
• 分辨缺少資料與無法連線：缺少伺服器位址、連接埠、驗證資訊等欄位，可能影響解析；欄位完整但 Connectivity Test 失敗，則需繼續檢查實際連線條件。
• 確認輸出用途：若服務商提供多個匯出入口，請選擇明確標示適用於 Shadowrocket 的訂閱輸出，不要將任意設定文件當成伺服器列表。

六、常見問題與恢復後的驗證

向自家服務商回報問題時，可提供發生時間、使用的網路、更新是否經過代理、錯誤原文，以及「完全空白」或「部分項目缺少」的狀況。請勿提供完整 token、密碼或伺服器憑證。本網站不提供、不販售也不推薦節點或訂閱；訂閱是否有效及伺服器端輸出內容，需由使用者自己的服務商確認。