本文適用於已經持有自己服務商訂閱的 Shadowrocket(小火箭)使用者。先分辨「沒有取得內容」、「取得的不是訂閱」與「訂閱沒有可用項目」三種情況,再檢查連結、服務商狀態、更新時機與網路路徑。排查期間請保留原有紀錄,每次只調整一個條件;最後整理不含憑證的回報資訊,判斷應由裝置端調整,或交由自己的服務商處理。
一、先分辨請求失敗、解析失敗與清單空白
訂閱並不是一組永遠固定在連結中的節點。更新時,客戶端會先連線至網址,取得伺服器回傳的內容,再將支援的伺服器項目加入本機清單。任何一個環節出錯,都可能顯示更新異常,但處理方式並不相同。
先在 Home 查看目標訂閱是否只是群組收合,並確認沒有把其他群組的節點數量誤認為該訂閱的結果。接著記下更新時顯示的完整提示。以下現象可協助判斷問題環節,不要只因為畫面空白就刪除整個訂閱。
- 等待後逾時:優先確認目前的網路能否連上訂閱網域,不能因此斷定連結已過期。
- 很快出現解析錯誤:可能已收到回應,但回應內容是登入頁、錯誤頁或不支援的格式。
- 更新完成但目標群組空白:確認服務商是否確實回傳伺服器項目,以及本機顯示狀態。
- 項目存在但無法連線:問題已進入伺服器連線階段,不再是單純的訂閱解析問題。
本文以 iPhone / iPad 上的 Home、Config、Settings 介面為例。Mac、Windows、Android 與 Linux 也可依「請求、回應、解析、顯示」逐步定位問題,但請勿把行動裝置的下拉手勢當成桌面版必備操作;請從目標訂閱的操作選單執行更新。
二、確認連結完整:別把管理頁面當成訂閱網址
回到自己的服務商訂閱管理頁面,重新使用複製訂閱網址的功能。複製後只在本機檢查,確認網址開頭、網域、路徑及查詢參數都完整。瀏覽器網址列中的帳戶首頁、訂單頁和登入頁,通常不是客戶端要讀取的訂閱端點。
https://example.com/sub?token=xxxx
以上是假資料,只用來辨認格式,不能用於匯入。真實網址中的 token 等欄位可能是存取憑證;即使看起來像隨機字元,也不能刪除。也不要將其他服務商使用的參數名稱套用到自己的連結。
- 檢查前後是否多出空格、換行、引號或中文標點。通訊軟體顯示的換行不一定屬於連結,實際貼上後請再確認一次。
- 確認
https://沒有遭到截斷;路徑的大小寫、?後的參數,以及&分隔符號都要保持原樣。 - 如果文字中出現字面上的
&,請回到原頁面重新複製,不要未經確認就批次取代或解碼整個網址。 - 如果服務商提供多種匯出格式,請選擇明確標示適用於 Shadowrocket 的訂閱輸出,不要把網頁分享網址或整份 Config 檔案網址當成相同格式。
三、檢查服務商回應:分別處理狀態碼與空內容
瀏覽器能開啟某個頁面,不代表該網址可用作訂閱。登入後的瀏覽器可能保有 Cookie,但訂閱請求不一定具備相同的登入狀態;伺服器也可能回傳驗證頁面。即使 HTTP 狀態為 200,內文仍可能是 HTML,而不是客戶端能解析的伺服器資料。
以下列出的是標準 HTTP 回應原文,供你辨認錯誤詳情或服務商回覆中的狀態;不表示 Shadowrocket 一定會逐字顯示這些訊息。
HTTP 401 Unauthorized
原因與處理方式:請求缺少有效的身分憑證,或憑證已失效。請返回服務商頁面重新複製有效訂閱網址,確認帳戶狀態後,再更新目標訂閱。
HTTP 403 Forbidden
原因與處理方式:伺服器拒絕目前的請求,可能與帳戶權限、來源限制或存取政策有關。記下時間與網路類型,交由自己的服務商確認;修改客戶端規則無法解除伺服器端的權限限制。
HTTP 429 Too Many Requests
原因與處理方式:請求觸發頻率限制。請停止連續更新;若回應包含 Retry-After,請依指示等待,否則依服務商公布的更新間隔重試。
HTTP 503 Service Unavailable
原因與處理方式:伺服器暫時無法處理請求。請先查看自己的服務商維護公告,稍後再試;重複刪除並新增本機訂閱,無法修復伺服器故障。
判斷方式:先確認回應內容類型,再調整本機設定
若服務商確認回應是登入頁、驗證頁或空內容,應先由服務商修正訂閱輸出;在本機切換協定或重新排列規則,都無法將這些回應轉成伺服器項目。
四、選擇更新時機:保留舊項目,每次完成一項驗證
變更帳戶方案、重設訂閱憑證或服務商調整項目後,管理頁面與訂閱端點的結果可能不會同步更新。此時連續點選更新,不但難以判斷結果,也可能觸發頻率限制。請依服務商說明等待,並分開記錄「最近一次嘗試時間」與「最近一次確認成功時間」。
- 保留現況:記下原訂閱名稱、目前項目數與錯誤訊息。若舊節點仍可使用,先不要刪除整個群組,也不要清除應用程式資料。
- 確認新網址已生效:若剛重設憑證,請確認本機訂閱網址已替換;保留舊網址反覆更新,只會一再得到失敗結果。
- 只更新目標訂閱:在 Home 找到對應的訂閱並執行更新;使用下拉更新時,請留意實際觸發了哪些訂閱請求,避免將其他訂閱的結果混在一起判斷。
- 等更新完成再比較:確認該群組是否出現項目、數量是否變動,以及錯誤是否相同。一次操作完成後,再調整下一個條件。
不要把「反覆重新匯入」當成預設的修復步驟。這可能建立同名群組,讓新舊項目同時存在,也會難以判斷究竟是哪一次更新成功。若確實需要重建紀錄,請先確認有效網址已保存,並清楚知道要移除哪個訂閱群組。
五、切換網路測試:分開檢查訂閱請求與節點連線
訂閱網址能否連線,與某個節點能否連線是兩個不同條件。節點可連線,不代表訂閱網域也能存取;反過來,訂閱更新成功,也不代表每個節點都能建立連線。測試時先固定同一條訂閱網址,只變更 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 修復無效內容;是否需要調整某條網路路徑,應以實際請求結果為準。
- 遇到憑證或 TLS 錯誤時,請先檢查系統日期、時間與服務商網域狀態,不要關閉憑證驗證來掩蓋問題。
- 公共 Wi-Fi 可能需要先在瀏覽器完成網路認證;認證頁面不是訂閱回應。
- 螢幕截圖與紀錄必須來自自己的測試。尚未實際測試時,不要把「換網路後一定成功」當成結論。
六、節點清單仍空白:先確認項目,再整理回報資訊
若目標群組已展開、更新時也沒有網路錯誤,但仍看不到伺服器項目,請服務商確認該訂閱目前是否確實包含可匯出的節點。帳戶到期、方案尚未生效、伺服器端篩選條件或輸出異常,都可能造成內容空白;具體原因須由服務商依帳戶與回應內容判斷。
協定名稱相同,不代表每種輸出都能直接匯入。Shadowsocks、VMess、VLESS、Trojan、Hysteria2、WireGuard 的連線參數各不相同。不要只替換項目開頭的協定名稱,也不要自行補上連接埠;請取得服務商提供給 Shadowrocket 使用的有效輸出。
- 描述現象:是逾時、出現解析提示,還是更新後目標群組的項目數為零;並附上已遮住憑證的錯誤截圖。
- 提供環境資訊:裝置平台、系統資訊、Wi-Fi 或行動網路,以及是否能在另一個網路重現。
- 提供時間資訊:最近一次正常更新的時間、故障發生時間及所在時區,方便服務商比對記錄。
- 明確說明要確認的問題:請對方核對 HTTP 狀態、是否重新導向至登入頁、回應格式及實際項目數量,而不只是詢問「是不是客戶端壞了」。
七、訂閱更新常見問題
同一個連結在瀏覽器中有內容,為什麼匯入還是失敗?
先確認看到的是伺服器資料還是網頁。如果是登入表單、驗證提示或帳戶面板,就不能據此認定訂閱正常。不要把整段網頁原始碼貼到 Home;請自己的服務商確認客戶端實際能取得的訂閱輸出。
我是不是先刪除舊訂閱,再新增一次就能解決?
先不要刪除。記下目標群組與錯誤訊息,確認原網址仍有效後,再執行一次更新。只有確認紀錄填錯或確實需要重建時,才刪除對應群組,以免連同仍可使用的舊項目一起移除。
剛更新完卻沒有新節點,需要一直下拉更新嗎?
不需要連續更新。先確認服務商管理頁面是否已顯示新項目,再依其更新間隔等待;若出現 429,請停止嘗試。等待後仍是空白,請將時間、目標群組與網路測試結果提供給服務商確認。
已經有節點,但網頁打不開,也算解析失敗嗎?
這不是同一個階段的問題。先確認 Home 中選取的伺服器,再檢查 Global Routing 目前的模式與連線結果;使用 Config 時,也要確認實際啟用的設定檔。訂閱項目已顯示後,繼續重複匯入通常無法解決伺服器連線或規則比對問題。
取得 Shadowrocket 並查看匯入教學
iPhone / iPad 版於 App Store 一次性付費 $2.99;Mac(Apple 晶片 / Intel)/ Windows / Android / Linux 版免費,共有 2 種取得方式。iPhone / iPad 的系統需求請以 App Store 頁面標示為準。前往下載頁選擇對應裝置,或查看首次匯入與連線步驟。