Shadowrocket 訂閱匯入失敗或清單空白：檢查連結格式與更新時機

本文摘要

本文適用於已有自己的服務商與訂閱，但在 Shadowrocket（小火箭）中無法匯入，或更新後看不到伺服器的使用者。排查依序從「連結完整性、請求結果、回傳內容、重新匯入」著手；先保留現有設定，再進行一次可供比對的更新，避免混淆連線失敗、內容空白與無法連線等狀況。

先區分匯入失敗、清單空白與連線失敗

Subscribe 的用途是從指定網址取得內容，並將可辨識的伺服器設定加入清單。儲存訂閱項目，不代表已取得有效內容；清單中出現伺服器，也不代表該伺服器一定能連線。先判斷問題發生在哪個環節，再調整對應設定，比反覆刪除整份清單更能保留排查線索。

讀取連結請求網址取得內容解析設定顯示清單

儲存時就無法繼續：優先確認 Type 是否為 Subscribe、連結是否完整，以及是否將網頁標題一併貼入網址欄位。
更新時顯示失敗：檢查網路、網域解析、HTTPS 憑證及伺服器回應。此時不應先修改伺服器的連接埠或協定。
更新完成但清單空白：確認回傳內容是否確實包含目前可用的伺服器設定，並檢查是否收合訂閱群組或啟用了清單篩選。
已顯示伺服器但無法連線：這表示已完成訂閱解析，接下來應檢查伺服器參數、可用狀態與實際連線記錄。

Home 用於查看伺服器與連線狀態，Config 用於管理設定檔，Settings 則提供 App 設定。不要為了修復 Subscribe 請求失敗而先清空 Config；兩者處理的項目不同。本文也不會將修改 Global Routing 當作通用解法，因為訂閱更新請求的實際路徑還會受到相關設定與目前網路環境影響。

檢查 Subscribe 連結，保留原始字元

訂閱網址通常包含網域、路徑與查詢參數。查詢參數中的 token 具有存取憑證的性質，少一個字元就可能變成另一個請求。請直接從自己的服務商訂閱頁面複製，不要從聊天預覽、截圖辨識結果或遭截斷的網址列文字拼湊。

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

以上是假資料，不可用於實際連線，僅供說明格式。https:// 是存取方式，example.com 是範例網域，/sub 是範例路徑，token=xxxx 是範例參數。實際網址的路徑與參數名稱可能不同，請以自己的服務商提供的原文為準，不要照著範例替換真實連結。

443

HTTPS 未明確指定連接埠時使用的預設連接埠

URL 路徑與查詢部分之間的分隔符號

查詢部分中多個參數常用的分隔符號

檢查開頭與結尾是否帶有空格、換行、中文引號或說明文字。保留網址原有的大小寫與編碼。
不要刪掉查詢參數中的 &，也不要手動解碼 %2F 等百分比編碼；這些字元可能會用於憑證驗證。
一般登入頁面、帳戶管理頁面與訂閱端點不是同一種網址。網頁能開啟，只能表示該網頁可以存取。
單一伺服器 URI 與 Subscribe 網址也不相同。請先確認複製的是訂閱入口，而不是某個伺服器的分享內容。

結論：重新複製，再比較結果

如果懷疑網址遭截斷，請直接從自己的帳戶重新複製完整連結，並保留舊項目以供比對。不要憑記憶補上 token，也不要將完整網址傳到公開討論區或線上檢測工具。

依請求結果區分網路問題與伺服器端問題

收到 HTTP 錯誤狀態與完全沒有收到回應，需要採取不同的處理方式。以下卡片列出標準 HTTP 狀態短語，方便對照診斷資訊或服務商提供的回應記錄；Shadowrocket 顯示的提示文字可能不同，不必要求畫面逐字出現這些英文。若沒有狀態碼，請記錄 App 實際顯示的提示，不要自行推斷為憑證過期。

HTTP 401 Unauthorized

原因與處理方式：伺服器未接受目前的驗證資訊。確認連結是否完整、憑證是否已重設，再從自己的帳戶複製目前有效的訂閱網址。

HTTP 403 Forbidden

原因與處理方式：伺服器拒絕此次存取，但不能只憑狀態碼判定原因。請向自己的服務商確認帳戶權限、存取限制或安全性封鎖情況，並提供已隱藏憑證的錯誤記錄。

HTTP 404 Not Found

原因與處理方式：找不到請求的路徑，也可能是伺服器刻意隱藏資源時的回應。先比對網域與路徑，再確認訂閱端點是否已變更，不要只更換 token 後繼續嘗試。

HTTP 429 Too Many Requests

原因與處理方式：請求觸發頻率限制。請停止連續重新整理；若回應包含 Retry-After，請依指定的間隔或時間再試，否則依服務商說明等待。

HTTP 503 Service Unavailable

原因與處理方式：服務暫時無法處理請求。保留原有設定，確認伺服器狀態與恢復安排；反覆刪除並重建訂閱，無法修復伺服器故障。

如果發生逾時、網域無法解析或 TLS 驗證失敗，先確認 iPhone 或 iPad 目前的網路能否正常存取一般 HTTPS 網頁，再分別切換 Wi-Fi 與行動網路進行比對。每次只變更網路這一項，並記錄結果。若出現憑證錯誤，也應檢查系統日期與時間是否正確，不要透過關閉憑證驗證來繞過問題。

回應成功但內容空白：檢查回傳內容，不只看狀態

HTTP 200 表示請求在 HTTP 層級成功，不保證回應本文是 Shadowrocket 能辨識的訂閱內容。登入頁、到期提示頁與安全驗證頁也可能回傳 200；這些是網頁文字，不是可直接匯入的伺服器清單。瀏覽器能顯示頁面，因此不能單獨據此判定「訂閱正常」。

觀察到的結果	可能卡住的環節	下一步
回傳登入頁面或安全驗證頁面	請求未取得預期的訂閱本文	確認使用訂閱專用端點，並向服務商確認存取要求
回應本文沒有內容	伺服器未輸出伺服器設定	確認帳戶狀態，以及該訂閱目前是否應包含項目
有內容，但格式不符	回傳格式與匯入入口不相符	確認服務商提供的是適用於 Shadowrocket 的訂閱格式
已有項目，但主清單未展開	清單顯示狀態	在 Home 展開對應群組並檢查篩選條件

帳戶到期、權限調整、伺服器維護或訂閱尚未生成完成，都可能影響回傳內容，但不能只憑「清單空白」判斷是哪種情況。請前往自己的帳戶頁面確認狀態，並請服務商確認此網址目前應回傳幾筆有效設定。不要將帳戶頁面顯示的方案名稱，當作已生成有效訂閱的證據。

協定名稱與訂閱封裝格式也應分開理解。Shadowsocks、VMess、VLESS、Trojan、Hysteria2、WireGuard 是連線設定涉及的協定或通道類型，並不表示任何包含這些名稱的文字都能由 Subscribe 直接解析。不要自行改寫編碼內容或拼接協定欄位；若需要手動設定參數，請依照對應入口與完整參數填寫。

結論：HTTP 200 與有效項目是兩項不同的判斷

請求成功但沒有項目時，先確認伺服器確實回傳了可辨識的內容，再檢查 App 清單狀態。此時調整 DOMAIN-SUFFIX 或 FINAL 等分流規則，不會讓空白本文變成伺服器設定。

保留現有設定，依步驟重新匯入一次

重新匯入適合用來確認「複製網址是否出錯」或「舊項目儲存的網址是否已失效」，不應成為每次失敗後的第一步。開始前記錄原訂閱名稱與項目數量；若已有可用設定，請先保留，不要刪除整份 Home 清單。不同介面的版面可能略有差異，請以相同的英文入口辨認操作。

記錄目前狀況

在 Home 查看原訂閱群組，記下可見伺服器數量與上次更新結果。保留原有項目，排查時不要同時修改 Config 或伺服器參數。
複製網址

從自己的服務商帳戶入口重新複製完整訂閱連結。若剛重設憑證，請使用新網址，並確認舊網址是否已失效。
選擇類型

前往 Home → 右上角「+」→ Type → Subscribe。返回新增頁面後，將連結貼到 URL 欄位，並使用容易辨識的備註，區分此次測試與原有項目。
儲存並更新

儲存後返回 Home，下拉以觸發更新，並等待此次請求完成。記錄實際顯示的提示，請勿在請求尚未完成時連續下拉；若有多筆訂閱，請留意是哪一筆更新失敗。
檢查清單

展開新訂閱群組，確認是否出現伺服器及其數量。新項目成功後再整理重複項目；若新舊項目都失敗，請保留錯誤記錄，轉而檢查網路或伺服器端。

若新網址可以匯入、舊網址仍然失敗，請優先比對兩者儲存的 URL 與憑證狀態。若兩筆項目都顯示伺服器，但只有連線失敗，應結束本輪匯入排查，另行檢查所選伺服器。不要將延遲測試失敗直接記錄為 Subscribe 解析失敗。

更新時機與回報記錄

更新訂閱會重新向伺服器請求內容，但不會自動恢復已到期的帳戶權限，也不會立即解除請求頻率限制。重設憑證、恢復權限或調整內容後，請先確認伺服器端已生效，再手動更新一次。自動更新的啟用狀態與執行時機會受到設定及系統運作條件影響，不要因為「已開啟 App」就認定更新已成功。

帳戶狀態剛變更：請向自己的服務商確認訂閱內容已生成，再更新一次。不要自行假設等待幾分鐘就一定會生效。
剛切換網路：等網路連線建立後再試，分別記錄 Wi-Fi 與行動網路的結果，避免同時更換網址和網路而無法比對。
已觸發頻率限制：停止頻繁重試，依 Retry-After 或服務商提供的等待時間操作。
更新後數量減少：先確認伺服器端是否調整了回傳項目，再決定是否保留舊記錄；不要立即認定是 App 遺失資料。

回報問題時應保留哪些資訊

有效的問題回報應能重現操作，同時保護存取憑證。請向自己的服務商說明發生時間、使用的網路、匯入入口、更新前後的項目數量，以及實際錯誤訊息原文。若記錄包含完整 URL，請隱藏 token、帳戶識別資訊及其他授權參數；不要傳送訂閱本文、伺服器密碼或 QR Code。

入口：Home → + → Type → Subscribe
操作：儲存後返回 Home，下拉更新一次
現象：原有項目仍在，新訂閱群組沒有伺服器
比對：分別記錄 Wi-Fi 與行動網路的更新結果
錯誤：抄錄此次實際提示，不要根據現象猜測狀態碼
隱私：回報資料中隱藏 URL 憑證與帳戶資訊

最後依三個層級的結果整理：請求未完成，繼續檢查網路與端點；請求完成但沒有有效項目，檢查回傳內容與帳戶狀態；項目已出現但無法連線，檢查伺服器設定與連線過程。每次只處理一個層級，可減少誤刪設定，也能讓後續回報有明確依據。