本文摘要

本文適用於已經持有自己服務商訂閱的 Shadowrocket(小火箭)使用者。先分辨「沒有取得內容」、「取得的不是訂閱」與「訂閱沒有可用項目」三種情況,再檢查連結、服務商狀態、更新時機與網路路徑。排查期間請保留原有紀錄,每次只調整一個條件;最後整理不含憑證的回報資訊,判斷應由裝置端調整,或交由自己的服務商處理。

一、先分辨請求失敗、解析失敗與清單空白

訂閱並不是一組永遠固定在連結中的節點。更新時,客戶端會先連線至網址,取得伺服器回傳的內容,再將支援的伺服器項目加入本機清單。任何一個環節出錯,都可能顯示更新異常,但處理方式並不相同。

讀取連結發出請求接收內容解析項目顯示清單

先在 Home 查看目標訂閱是否只是群組收合,並確認沒有把其他群組的節點數量誤認為該訂閱的結果。接著記下更新時顯示的完整提示。以下現象可協助判斷問題環節,不要只因為畫面空白就刪除整個訂閱。

本文以 iPhone / iPad 上的 Home、Config、Settings 介面為例。Mac、Windows、Android 與 Linux 也可依「請求、回應、解析、顯示」逐步定位問題,但請勿把行動裝置的下拉手勢當成桌面版必備操作;請從目標訂閱的操作選單執行更新。

二、確認連結完整:別把管理頁面當成訂閱網址

回到自己的服務商訂閱管理頁面,重新使用複製訂閱網址的功能。複製後只在本機檢查,確認網址開頭、網域、路徑及查詢參數都完整。瀏覽器網址列中的帳戶首頁、訂單頁和登入頁,通常不是客戶端要讀取的訂閱端點。

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

以上是假資料,只用來辨認格式,不能用於匯入。真實網址中的 token 等欄位可能是存取憑證;即使看起來像隨機字元,也不能刪除。也不要將其他服務商使用的參數名稱套用到自己的連結。

  1. 檢查前後是否多出空格、換行、引號或中文標點。通訊軟體顯示的換行不一定屬於連結,實際貼上後請再確認一次。
  2. 確認 https:// 沒有遭到截斷;路徑的大小寫、? 後的參數,以及 & 分隔符號都要保持原樣。
  3. 如果文字中出現字面上的 &,請回到原頁面重新複製,不要未經確認就批次取代或解碼整個網址。
  4. 如果服務商提供多種匯出格式,請選擇明確標示適用於 Shadowrocket 的訂閱輸出,不要把網頁分享網址或整份 Config 檔案網址當成相同格式。

三、檢查服務商回應:分別處理狀態碼與空內容

瀏覽器能開啟某個頁面,不代表該網址可用作訂閱。登入後的瀏覽器可能保有 Cookie,但訂閱請求不一定具備相同的登入狀態;伺服器也可能回傳驗證頁面。即使 HTTP 狀態為 200,內文仍可能是 HTML,而不是客戶端能解析的伺服器資料。

443
HTTPS 未明確指定連接埠時使用的預設連接埠
401 / 403
優先確認授權要求與存取政策
200
HTTP 請求成功,不代表回應內文是有效訂閱

以下列出的是標準 HTTP 回應原文,供你辨認錯誤詳情或服務商回覆中的狀態;不表示 Shadowrocket 一定會逐字顯示這些訊息。

HTTP 401 Unauthorized

原因與處理方式:請求缺少有效的身分憑證,或憑證已失效。請返回服務商頁面重新複製有效訂閱網址,確認帳戶狀態後,再更新目標訂閱。

HTTP 403 Forbidden

原因與處理方式:伺服器拒絕目前的請求,可能與帳戶權限、來源限制或存取政策有關。記下時間與網路類型,交由自己的服務商確認;修改客戶端規則無法解除伺服器端的權限限制。

HTTP 429 Too Many Requests

原因與處理方式:請求觸發頻率限制。請停止連續更新;若回應包含 Retry-After,請依指示等待,否則依服務商公布的更新間隔重試。

HTTP 503 Service Unavailable

原因與處理方式:伺服器暫時無法處理請求。請先查看自己的服務商維護公告,稍後再試;重複刪除並新增本機訂閱,無法修復伺服器故障。

判斷方式:先確認回應內容類型,再調整本機設定

若服務商確認回應是登入頁、驗證頁或空內容,應先由服務商修正訂閱輸出;在本機切換協定或重新排列規則,都無法將這些回應轉成伺服器項目。

四、選擇更新時機:保留舊項目,每次完成一項驗證

變更帳戶方案、重設訂閱憑證或服務商調整項目後,管理頁面與訂閱端點的結果可能不會同步更新。此時連續點選更新,不但難以判斷結果,也可能觸發頻率限制。請依服務商說明等待,並分開記錄「最近一次嘗試時間」與「最近一次確認成功時間」。

  1. 保留現況:記下原訂閱名稱、目前項目數與錯誤訊息。若舊節點仍可使用,先不要刪除整個群組,也不要清除應用程式資料。
  2. 確認新網址已生效:若剛重設憑證,請確認本機訂閱網址已替換;保留舊網址反覆更新,只會一再得到失敗結果。
  3. 只更新目標訂閱:在 Home 找到對應的訂閱並執行更新;使用下拉更新時,請留意實際觸發了哪些訂閱請求,避免將其他訂閱的結果混在一起判斷。
  4. 等更新完成再比較:確認該群組是否出現項目、數量是否變動,以及錯誤是否相同。一次操作完成後,再調整下一個條件。

不要把「反覆重新匯入」當成預設的修復步驟。這可能建立同名群組,讓新舊項目同時存在,也會難以判斷究竟是哪一次更新成功。若確實需要重建紀錄,請先確認有效網址已保存,並清楚知道要移除哪個訂閱群組。

五、切換網路測試:分開檢查訂閱請求與節點連線

訂閱網址能否連線,與某個節點能否連線是兩個不同條件。節點可連線,不代表訂閱網域也能存取;反過來,訂閱更新成功,也不代表每個節點都能建立連線。測試時先固定同一條訂閱網址,只變更 Wi-Fi 或行動網路其中一項。

觀察結果優先檢查項目下一步
Wi-Fi 失敗,行動網路成功Wi-Fi 的認證狀態、DNS 與對外連線政策先完成網路登入,記錄失敗的網路環境,暫時不要變更訂閱內容
兩種網路都回傳 401訂閱憑證與帳戶權限重新複製有效網址,向自己的服務商確認授權
兩種網路都出現解析錯誤回應內文與匯出格式請服務商確認端點實際回傳的內容
更新成功,但連線仍失敗伺服器位址、連接埠與連線參數轉而排查連線問題,不要再反覆更換訂閱網址

如果測試時連線開關反覆自動開啟,可前往 Settings → On Demand 檢查隨選連線條件,並記下原始設定。只有在了解其作用時才暫時調整,測試完成後請還原。On Demand 會影響連線的觸發條件,不是解析訂閱內文的開關。

Global Routing 下的 Proxy、Direct、Config、Scene 用來控制路由行為,不是訂閱資料格式。不要藉由改寫 DOMAIN-SUFFIX、GEOIP、IP-CIDR 或 FINAL 修復無效內容;是否需要調整某條網路路徑,應以實際請求結果為準。

六、節點清單仍空白:先確認項目,再整理回報資訊

若目標群組已展開、更新時也沒有網路錯誤,但仍看不到伺服器項目,請服務商確認該訂閱目前是否確實包含可匯出的節點。帳戶到期、方案尚未生效、伺服器端篩選條件或輸出異常,都可能造成內容空白;具體原因須由服務商依帳戶與回應內容判斷。

協定名稱相同,不代表每種輸出都能直接匯入。Shadowsocks、VMess、VLESS、Trojan、Hysteria2、WireGuard 的連線參數各不相同。不要只替換項目開頭的協定名稱,也不要自行補上連接埠;請取得服務商提供給 Shadowrocket 使用的有效輸出。

七、訂閱更新常見問題

同一個連結在瀏覽器中有內容,為什麼匯入還是失敗?

先確認看到的是伺服器資料還是網頁。如果是登入表單、驗證提示或帳戶面板,就不能據此認定訂閱正常。不要把整段網頁原始碼貼到 Home;請自己的服務商確認客戶端實際能取得的訂閱輸出。

我是不是先刪除舊訂閱,再新增一次就能解決?

先不要刪除。記下目標群組與錯誤訊息,確認原網址仍有效後,再執行一次更新。只有確認紀錄填錯或確實需要重建時,才刪除對應群組,以免連同仍可使用的舊項目一起移除。

剛更新完卻沒有新節點,需要一直下拉更新嗎?

不需要連續更新。先確認服務商管理頁面是否已顯示新項目,再依其更新間隔等待;若出現 429,請停止嘗試。等待後仍是空白,請將時間、目標群組與網路測試結果提供給服務商確認。

已經有節點,但網頁打不開,也算解析失敗嗎?

這不是同一個階段的問題。先確認 Home 中選取的伺服器,再檢查 Global Routing 目前的模式與連線結果;使用 Config 時,也要確認實際啟用的設定檔。訂閱項目已顯示後,繼續重複匯入通常無法解決伺服器連線或規則比對問題。

取得 Shadowrocket 並查看匯入教學

iPhone / iPad 版於 App Store 一次性付費 $2.99;Mac(Apple 晶片 / Intel)/ Windows / Android / Linux 版免費,共有 2 種取得方式。iPhone / iPad 的系統需求請以 App Store 頁面標示為準。前往下載頁選擇對應裝置,或查看首次匯入與連線步驟。