本文重點

本文適合已向自己的服務商取得訂閱連結的使用者。先在 Home 手動下拉更新,再檢查 Settings → Subscribe → Update on Open。若更新失敗,可從連結有效性、網路請求和回傳格式三個環節逐步排查。更新成功後,還要分別確認伺服器清單、預設選擇與實際連線狀態,不能只看刷新動畫判斷結果。

訂閱更新會改變哪些內容

Shadowrocket(小火箭)的 Subscribe 記錄會儲存訂閱網址。更新時,應用程式會向該網址送出請求,讀取服務商回傳的伺服器資料,再更新對應群組。這不是更新應用程式,也不等於續訂服務方案。本文以 iPhone / iPad 介面為例,其他平台請依實際介面確認對應項目。

讀取訂閱網址 請求遠端內容 解析伺服器資料 更新所屬群組 確認連線結果

Home 的伺服器清單、Config 的規則設定,以及 Settings 的應用程式設定,分屬不同層級。訂閱更新成功,通常只代表伺服器資料已成功取得並解析,不能因此認定 Config 中的規則檔也已更新。個別新增的伺服器,也不會因為另一筆訂閱更新而自動納入該訂閱。

3 個位置
在 Home 查看清單、在 Config 管理設定、在 Settings 調整更新行為
2 種觸發方式
分別測試手動下拉與 Update on Open
3 個檢查環節
連結有效性、網路連線能力、回傳格式

在 Home 手動下拉更新

排查時先手動更新一次,明確記下觸發時間,也方便將畫面上的錯誤訊息對應到這次請求。第一次失敗後不要立刻刪除整個群組;先保留原有記錄與錯誤訊息,避免連目前使用的伺服器選擇也一併遺失。

  1. 確認訂閱記錄

    進入 Home,找到需要更新的 Subscribe 記錄。開啟該記錄的編輯畫面,確認 Type 為 Subscribe,並核對 URL 是否仍是服務商目前提供的網址。

  2. 新增訂閱記錄

    如果目前只有手動新增的伺服器,沒有訂閱記錄,請在 Home 右上角點選「+」,將 Type 設為 Subscribe,並在 URL 欄位貼上自己的訂閱連結後儲存。已有記錄則可略過此步驟。

  3. 下拉更新

    返回 Home,在清單頂端向下滑動後放開,等待本次更新完成。如果有多筆訂閱,請逐筆確認結果;其中一筆更新成功,不代表全部都成功。

  4. 確認更新內容

    查看目標訂閱下的伺服器名稱與項目變化。清單沒有變化,可能是遠端內容並未更新;若出現明確錯誤,請記下完整錯誤訊息,不要只寫「更新不了」。

  5. 測試連線

    重新確認預設伺服器的圓點標記,視需要連線後再執行 Connectivity Test。成功取得清單與伺服器能否連線,是兩項不同的結果。

設定開啟時自動更新

前往 Settings → Subscribe → Update on Open,開啟應用程式時更新。之後正常開啟應用程式,確認是否觸發訂閱更新。各平台的設定排列可能不同,請尋找同名選項;不要在 Config 中找這個開關。

Settings → On Demand 管理的是依條件連線的行為,不是訂閱更新排程。不要為了自動更新訂閱而反覆更動 On Demand。若手動更新正常、開啟時更新異常,請先確認 Update on Open 是否仍為開啟狀態,再記錄開啟應用程式時的網路狀況。

先確認完整錯誤訊息,再決定排查順序

同樣是「更新失敗」,問題可能發生在不同階段。下方列出常見錯誤訊息或 HTTP 狀態。實際顯示內容可能由系統與伺服器端決定,請以畫面上出現的完整訊息為準,不要一概認定是連結過期。

錯誤:Failed to load subscription

原因與處理方式:這是訂閱載入失敗的概括訊息,無法單憑這句判斷是連結過期還是格式有問題。請先核對完整 URL,再確認同一次請求是否有更明確的網路或 HTTP 錯誤。

錯誤:The request timed out.

原因與處理方式:請求未能在允許時間內完成,可能與本地網路、遠端回應或目前的請求路徑有關。請先確認一般網路連線正常,再使用同一網址,分別透過 Wi-Fi 與行動網路測試一次。

回應狀態:HTTP 401

原因與處理方式:伺服器要求有效的身分驗證資料,網址中的權杖可能遺漏、失效或已重設。請向自己的服務商重新取得目前有效的訂閱連結,完整替換 URL 後再試。

回應狀態:HTTP 403

原因與處理方式:伺服器拒絕了這次請求,可能與帳戶權限或存取政策有關。請向自己的服務商提供狀態碼與發生時間;不能只憑此狀態判定服務方案已到期。

回應狀態:HTTP 429

原因與處理方式:請求頻率觸發了伺服器端限制。請停止連續下拉,依服務商指示等待後再試;若回應中有 Retry-After,請按照其指示等待。

排查時每次只變更一個條件。例如先維持訂閱網址不變,只切換本地網路;下一次再維持網路不變,改用服務商重新提供的網址。若一次改動多項設定,即使恢復正常,也難以確認是哪項變更生效。

連結過期、網路無法連線與格式無法辨識

連結有效性:檢查完整 URL 與帳戶狀態

訂閱 URL 中的權杖通常用於身分驗證。複製時漏掉問號後的參數、多出空格或換行,都可能導致請求失敗。服務商重設連結後,舊網址也可能立即失效。請向服務商確認連結是否仍有效,並確認帳戶有權取得該訂閱內容。

網路連線能力:區分 DNS 解析、連線與憑證問題

HTTPS 訂閱網址未明確指定連接埠時,通常會透過 TCP 443 連線。網域解析失敗、連線逾時與 TLS 憑證驗證失敗,是不同的問題。裝置能開啟其他網頁,只能證明部分網路存取正常,不能證明訂閱網域也能連線。

Home → Global Routing 中的 Proxy、Direct、Config、Scene 會影響連線與分流方式,但不應直接假設每次訂閱請求都會走固定路徑。切換 Proxy 與 Direct 也會改變其他應用程式的流量路徑。排查時請記錄目前的模式與 VPN 狀態,不要為了更新訂閱而長時間切換至其他模式。

格式無法辨識:請求成功不代表內容可匯入

伺服器回傳 HTTP 200,只代表 HTTP 請求成功,不保證回應內容是有效訂閱。回傳內容可能是登入頁面、維護通知或空白內容。即使訂閱格式可辨識,若缺少必要欄位或通訊協定參數不完整,也可能無法建立可用項目。

觀察到的狀況優先確認下一步
回應內容是 HTML 頁面是否回傳登入或驗證頁面向服務商確認提供的是可供 Shadowrocket 使用的訂閱網址
回應內容為空或清單為空帳戶是否已配置伺服器資料請服務商檢查回應內容,不要直接刪除原有群組
部分項目無法匯入對應的通訊協定與必要欄位是否完整提供已遮蔽敏感資訊的錯誤訊息與通訊協定類型,不要自行猜測參數
名稱與項目數量沒有變化遠端是否確實發布了變更先確認請求成功,再向服務商確認預期內容

更新成功後仍無法連線時的檢查項目

更新成功不代表每台伺服器都能連線。若遠端已刪除或替換原有項目,請重新確認預設伺服器。VMess、VLESS、Trojan 等記錄的位址、連接埠、UUID 或密碼、傳輸方式與 TLS 參數,都應以服務商提供的資料為準,不要為了排除錯誤而任意補填。

  1. 在 Home 確認選取的是更新後的目標伺服器,而不是同名的手動新增記錄。
  2. 連線後執行 Connectivity Test,分辨「能取得訂閱」與「伺服器可連線」這兩種情況。
  3. 若測試可用,但特定網域仍有異常,請檢查 Global Routing 的目前模式,以及 Config 中的規則比對結果。
  4. 檢查 DOMAIN-SUFFIX、IP-CIDR、GEOIP 與 FINAL 等規則時,只調整與目標問題相關的項目,不要把修改規則當成修復訂閱格式的方法。

向服務商回報時,請提供發生時間、使用的本地網路、完整錯誤訊息、手動更新結果與開啟時更新結果。請遮蔽訂閱 URL 中的權杖、UUID 和密碼。不要將完整連結貼在公開截圖或留言中;若連結已外洩,請向服務商重設連結,再更新應用程式中的 URL。