Shadowrocket 訂閱更新失敗、節點清單空白：逐步排查指南

1. 先分辨更新失敗與節點清單空白

訂閱更新包含三個步驟：連線至訂閱網址、取得回應內容，再將內容解析為節點。任何一步失敗，最後都可能造成 Home 中沒有預期的節點，但處理方式各不相同。若舊節點仍在，刷新時卻出現錯誤，通常應先確認請求是否成功；若首次匯入後完全沒有節點，還要確認回應內容是否真的是節點訂閱。

「更新成功」和「節點可連線」是兩回事。前者表示訂閱請求與解析已完成；後者還取決於節點位址、連接埠、驗證參數及目前的網路狀況。本文先處理清單載入問題；清單恢復後，再另外測試連線。

2. 檢查連結完整性與訂閱類型

訂閱 URL 是取得節點清單的網址，不是帳戶登入頁或服務商網站首頁。複製時請使用自己的服務商提供的訂閱複製功能，檢查開頭的通訊協定、網域、路徑，以及問號後的查詢參數。聊天軟體中的換行、末尾句號、引號或省略顯示，都可能讓看似相同的連結變成另一個網址。

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

以上僅為格式示意，並非可用的訂閱連結。實際網址可能採用不同路徑或參數名稱，請勿照著範例改寫。尤其不要刪除 ? 後的內容，也不要手動替換 &、= 或經過百分比編碼的字元。訂閱憑證可能位於路徑中，不一定會叫做 token。

1. 重新複製網址

   請從自己的服務商帳戶頁重新複製適用於 Shadowrocket 的訂閱 URL。若有不同格式可選，請依照服務商對 Shadowrocket 的說明選擇，不要複製帳戶管理頁面的網址。

2. 檢查訂閱類型

   在 Home 右上角點選「+」進入新增頁面，並在 Type 選擇 Subscribe。單一節點的分享內容與批次訂閱 URL 用途不同，不要將網頁網址填入某個協定的伺服器位址欄位。

3. 檢查 URL 欄位

   將完整連結填入 URL，確認前後沒有空格、換行或多餘標點。可以設定方便辨識的名稱，但不要把完整憑證寫進名稱中。

4. 儲存並重新整理

   儲存後返回 Home，更新訂閱；使用下拉刷新時，確認目標訂閱的結果，再檢查其群組中是否出現節點。排查期間只修改這一筆訂閱，避免同時調整其他來源。

3. 根據回應結果檢查服務商狀態

若錯誤訊息中有 HTTP 狀態碼，可用來縮小排查範圍。以下說明的是狀態碼在伺服器回應中的標準意義，不代表所有版本都會顯示相同的完整錯誤訊息。若介面只顯示概括的失敗提示，請記下實際訊息，再向自己的服務商確認對應的請求結果。

也要確認帳戶是否有效、流量是否用完，以及目前方案是否包含可用節點。不同服務商可能會回傳錯誤碼、說明文字或空清單，不一定都會以相同方式提示。若在瀏覽器開啟連結後看到登入頁、安全驗證頁或帳戶提示頁，即使狀態碼是 200，也不是能直接解析的節點內容；瀏覽器能看到內容，也不代表應用程式的請求會收到完全相同的回應。

• 回應內容為空：確認訂閱介面是否暫時異常，以及目前帳戶是否確實已配置節點。
• 回應為 HTML 頁面：確認複製的是訂閱端點，而非需要互動登入的網頁。
• 回應是可讀文字但解析失敗：請服務商確認輸出格式適用於 Shadowrocket，避免直接混用不同設定格式。

4. 遇到逾時，先檢查請求路徑，再確認更新時機

逾時只表示請求未能在限定時間內完成，不能直接證明連結已過期。先確認目前的 Wi-Fi 或行動網路能否正常連線至其他網站；若公共 Wi-Fi 尚未完成網路登入，請先完成驗證。切換一次網路後再更新同一筆訂閱，有助於分辨問題來自本機網路限制還是訂閱伺服器。

訂閱請求的路徑與節點測試並不完全相同。Settings → Subscribe 中的 Update via Proxy 會影響訂閱更新是否透過代理送出；只有在已有可用節點、連線已建立，且實際請求能抵達訂閱端點時，這個選項才可能有助於處理直連受限的問題。首次匯入且清單完全空白時，不能依賴尚不存在的節點來完成更新。

如果連線開關才剛關閉就又自動開啟，請檢查 Settings → On Demand 是否設定了自動連線條件。這項功能控制何時建立連線，無法將錯誤的連結修正為正確的訂閱。排查時記下原有設定，只有在需要固定測試條件時才暫時關閉，完成後再恢復。也不要反覆切換 Global Routing 碰運氣：Proxy、Direct、Config、Scene 是流量處理模式，不是訂閱格式轉換開關。

5. 節點清單空白時，先檢查群組與回應內容

更新後先返回 Home，確認目前檢視的是剛更新的訂閱群組，展開收合的群組，並清除搜尋條件。群組收合或搜尋字詞未清除時，「看不到節點」不代表訂閱回傳了零個節點。若其他訂閱正常、只有一個群組空白，應優先檢查該群組的來源，不要同時重設所有訂閱。

• 群組存在但內容空白：請服務商確認回應中確實包含節點，而不只是流量資訊、到期提示或空內容。
• 部分節點出現、部分缺漏：檢查訂閱本身的篩選條件、服務商提供的內容範圍，以及缺漏項目的格式是否受到支援。
• 節點出現但無法連線：節點清單載入問題已與連線問題分開，接下來請檢查對應協定的位址、連接埠與驗證參數。
• 刷新後舊清單中的節點變少：確認是否是服務商調整了節點清單，不要直接將「節點數量變少」判定為用戶端解析錯誤。

6. 重新匯入前應保留哪些資訊

重新匯入適合修復本機儲存的舊網址或錯誤項目，但無法修復服務商介面故障。刪除舊訂閱前，請確認能重新取得完整 URL，並記下手動新增的節點、原有群組名稱及目前選取的節點。如果訂閱中仍有可用節點，應優先保留原有項目，避免連尚可使用的連線也一併移除。

1. 記錄錯誤資訊：記下實際提示、發生時間、使用的網路，以及更新是否透過代理送出；不要只記「不能用」。
2. 確認目前連結：從自己的服務商帳戶頁重新複製，不要使用很久以前保存在聊天記錄中的網址。
3. 確認帳戶回傳內容：確認帳戶有效、介面已恢復，而且該連結應至少回傳一個可用節點。
4. 單獨驗證新項目：需要重新新增時，請在 Home →「+」→ Type → Subscribe 中使用容易辨識的名稱，只測試更新一次。
5. 確認正常後再清理：新項目能展開節點，且連線測試結果符合預期後，再刪除確認失效的舊訂閱；不要只因名稱相同就批次刪除。

若仍無法恢復，請將以上記錄提供給自己的服務商，並說明問題屬於「請求逾時」、「HTTP 錯誤」還是「請求成功但清單空白」。這些資訊比包含完整 URL 的截圖更適合初步判斷問題。若需要更換憑證，請透過服務商自己的安全支援管道處理。

7. 常見問題