Shadowrocket 訂閱更新失敗或節點清單空白:5 步檢查清單

新增訂閱後清單空白或顯示解析失敗?依序檢查連結、複製格式、服務商狀態、更新時機與網路,逐步找出原因。

本文重點

這份清單適合已經有自己的訂閱連結,卻無法在 Shadowrocket(小火箭)中看到項目的使用者。先確認 URL 是否能取得內容,再分辨問題出在內容格式、服務商回應或本機網路;每一步都記下原始連結與觀察結果,避免反覆修改設定後無法判斷原因。

步驟一:確認 Subscribe 連結是否完整

結論:先檢查輸入的 URL,再處理清單。前往 Home,找到自己新增的 Subscribe 項目,開啟編輯內容,逐字比對服務商提供的原始資料。若尚未新增,可從 Home 右上角的「+」進入,選擇 Type 為 Subscribe,再填入自己已有的連結並儲存。不同介面狀態下,入口可能略有差異,請以 App 內實際顯示的欄位為準。

訂閱網址通常包含路徑與查詢參數。以示意網址 https://example.com/sub?token=xxxx 為例,?token=xxxx 是 URL 的一部分;少了問號、等號或末尾字元,都可能讓伺服器回傳不同內容。此網址僅用於說明結構,並非可用的訂閱連結。請勿將自己的完整 URL 貼到公開討論區,其中的參數可能用於識別存取權限。

  1. 找回原始網址

    從自己已有的服務商資料中重新複製完整 URL,保留開頭的 https://、路徑及問號後的參數。不要憑記憶補上字元。

  2. 檢查開頭與結尾

    對照 Subscribe 輸入欄位,確認前後沒有空格、換行或說明文字。複製網頁上一整段說明時,標題和標點可能也會一併複製。

  3. 一次只改一項

    儲存修正後的網址,再更新一次並觀察清單。若同時更換 URL、網路和設定,就無法判斷是哪一項變更造成結果不同。

步驟二:分辨取得失敗與內容無法解析

結論:URL 能開啟,不代表它回傳的是 Shadowrocket 可讀取的訂閱內容。一次更新至少包含請求網址、接收回應、解析項目三個環節;清單空白只表示最後沒有取得可顯示的項目,單憑這個現象無法判定問題出在哪個環節。

讀取 URL送出請求接收回應解析項目顯示清單

先確認自己是否誤將網頁網址、帳戶頁面網址或一段說明文字填入 Subscribe。複製連結時,特別留意引號、中文標點、換行及遭截斷的參數。在 Safari 開啟相同網址,可協助確認是否能連線;但瀏覽器顯示登入頁、錯誤頁或一般網頁時,不能以「頁面能開啟」作為「訂閱格式正確」的證據,也不要將頁面上的敏感內容轉傳給他人。

錯誤:Failed to load subscription

可能原因與處理方式:這類載入提示需搭配實際回應判斷,可能是連結失效,也可能是目前的網路無法取得內容。先確認原始 URL,再向自己的服務商確認該網址是否仍可存取;實際提示文字請以 App 當下顯示為準。

現象:更新後清單仍空白

可能原因與處理方式:請求可能回傳的不是訂閱內容,也可能沒有任何可顯示的項目。確認未填入帳戶網頁網址,並請自己的服務商核對該連結實際輸出的格式與內容。

若 URL 以 https:// 開頭,HTTPS 通常使用連接埠 443,但服務商也可能指定其他連接埠;請以原始網址為準,不要自行修改連接埠。若看到 401 或 403 回應,通常表示存取權限有問題;404 則表示找不到該路徑。即使收到 200,仍須確認回應內容確實是訂閱資料,而非登入頁面。

步驟三:確認服務商端的連結與內容狀態

結論:確認本機輸入無誤後,接著檢查提供該連結的一方。Shadowrocket 會讀取使用者填入的資料;訂閱網址的有效期限、存取權限及回傳內容,則取決於該網址所屬的服務。App 購買與既有服務資料是兩回事;本文僅說明如何檢查自己的連結。

1 個 URL
先比對 Subscribe 中儲存的完整網址
3 位數狀態碼
可記錄 401、403、404 等 HTTP 回應
443
HTTPS 常用連接埠;實際連接埠以原始 URL 為準

查看自己已有的服務商帳戶資料時,請確認三件事:目前取得的是供 App 讀取的訂閱 URL;該 URL 的存取權限仍有效;回傳內容包含預期項目。若服務商更新了連結,請改用目前提供的網址取代舊網址,不要只修改 URL 中看似日期或隨機碼的片段。

聯絡服務商時,可提供問題發生時間、網址是否能存取、觀察到的狀態碼,以及「能取得內容但清單空白」或「請求直接失敗」等明確現象。不要傳送完整 token、密碼或未遮蔽的設定內容。若服務商確認回傳內容為空,應先請對方檢查其資料;在 Home 反覆更新不會憑空產生項目。

判斷方式:先確認回傳內容,再調整 App 設定

如果同一個 URL 回傳的是登入頁、錯誤頁或空白內容,請先處理網址及服務商端的狀態;確認已取得預期的訂閱內容後,再檢查匯入後的顯示結果。

步驟四:掌握更新時機,確認單次操作結果

結論:修改 URL 後更新一次,等這次操作完成,再比較項目是否有變化。短時間內連續觸發更新,會讓人難以判斷哪次請求對應哪項修改,也無法取代對回傳內容的確認。先記下修改前的現象,再儲存連結、更新並記錄修改後的現象。

不要把 Global Routing 的 Proxy、Direct、Config 或 Scene,與「訂閱是否成功解析」混為一談。這些是連線後的路由模式;訂閱清單空白時,應優先檢查 URL 請求與回傳內容。已有項目但連線結果不如預期時,才進一步核對路由與規則,例如 DOMAIN-SUFFIX、GEOIP、IP-CIDR 和 FINAL 的比對結果。

步驟五:切換網路複查,再決定下一個檢查方向

結論:同一個已確認無誤的 URL 在不同網路下表現不同,才有理由繼續檢查本機到訂閱網址的連線。保持 Subscribe 內容不變,分別透過自己可用的 Wi‑Fi 與行動網路更新一次,記錄是否能取得內容,以及提示是否改變。切換網路前後不要同時修改網址,否則比較結果便失去意義。

現象:一種網路可更新,另一種網路失敗

可能原因與處理方式:兩種網路連往訂閱網址的路徑不同。確認發生問題的網路本身能正常瀏覽網頁,再檢查該網路是否能存取自己的訂閱網址;向服務商回報兩種網路下的實際結果。

現象:兩種網路都取得空白清單

可能原因與處理方式:優先重新檢查 URL 與回應內容。若兩次使用的是同一個網址,單純持續切換網路,通常無法解釋為何回傳內容沒有項目。

排查時也要分清「訂閱更新失敗」與「已有項目但無法連線」。前者發生在讀取資料階段;後者則需進一步確認自己既有設定中的 Type、Address、Port,以及對應協定所需的欄位。Shadowsocks、VMess、VLESS、Trojan、Hysteria2 與 WireGuard 的欄位各不相同,不要為了修復空白清單而任意更改既有項目的協定或連接埠。

若 URL、回應內容與網路都已確認,仍無法在 Home 看到預期項目,可整理前述記錄,再確認自己查看的是正確的 Subscribe 項目,以及資料是否儲存在預期位置。若要區分 Config 與 Home 的用途,可參閱伺服器管理說明;不確定介面詞彙的意思時,可查閱術語表。

結論:透過差異找出問題

只有在網路變更、URL 不變時,結果差異才適合用來檢查連線環境;只有在 URL 變更、網路不變時,結果差異才適合用來檢查連結。一次只改一項,才能交由相應的檢查步驟找出原因。

確認 App 並繼續閱讀

Shadowrocket 僅透過 App Store 在 Apple 平台提供。確認產品頁時,可查看開發者 Shadow Launch Technology Limited 與 App ID 932747118;系統需求請以 App Store 頁面標示為準。備妥自己的訂閱資料後,再依照教學確認匯入步驟。

前往官方頁面核對 查看教學
App Store 官方頁面核對