本文適合已向自己的服務商取得訂閱連結的使用者。先在 Home 手動下拉更新,再檢查 Settings → Subscribe → Update on Open。若更新失敗,可從連結有效性、網路請求和回傳格式三個環節逐步排查。更新成功後,還要分別確認伺服器清單、預設選擇與實際連線狀態,不能只看刷新動畫判斷結果。
訂閱更新會改變哪些內容
Shadowrocket(小火箭)的 Subscribe 記錄會儲存訂閱網址。更新時,應用程式會向該網址送出請求,讀取服務商回傳的伺服器資料,再更新對應群組。這不是更新應用程式,也不等於續訂服務方案。本文以 iPhone / iPad 介面為例,其他平台請依實際介面確認對應項目。
Home 的伺服器清單、Config 的規則設定,以及 Settings 的應用程式設定,分屬不同層級。訂閱更新成功,通常只代表伺服器資料已成功取得並解析,不能因此認定 Config 中的規則檔也已更新。個別新增的伺服器,也不會因為另一筆訂閱更新而自動納入該訂閱。
在 Home 手動下拉更新
排查時先手動更新一次,明確記下觸發時間,也方便將畫面上的錯誤訊息對應到這次請求。第一次失敗後不要立刻刪除整個群組;先保留原有記錄與錯誤訊息,避免連目前使用的伺服器選擇也一併遺失。
-
確認訂閱記錄
進入 Home,找到需要更新的 Subscribe 記錄。開啟該記錄的編輯畫面,確認 Type 為 Subscribe,並核對 URL 是否仍是服務商目前提供的網址。
-
新增訂閱記錄
如果目前只有手動新增的伺服器,沒有訂閱記錄,請在 Home 右上角點選「+」,將 Type 設為 Subscribe,並在 URL 欄位貼上自己的訂閱連結後儲存。已有記錄則可略過此步驟。
-
下拉更新
返回 Home,在清單頂端向下滑動後放開,等待本次更新完成。如果有多筆訂閱,請逐筆確認結果;其中一筆更新成功,不代表全部都成功。
-
確認更新內容
查看目標訂閱下的伺服器名稱與項目變化。清單沒有變化,可能是遠端內容並未更新;若出現明確錯誤,請記下完整錯誤訊息,不要只寫「更新不了」。
-
測試連線
重新確認預設伺服器的圓點標記,視需要連線後再執行 Connectivity Test。成功取得清單與伺服器能否連線,是兩項不同的結果。
設定開啟時自動更新
前往 Settings → Subscribe → Update on Open,開啟應用程式時更新。之後正常開啟應用程式,確認是否觸發訂閱更新。各平台的設定排列可能不同,請尋找同名選項;不要在 Config 中找這個開關。
- 先建立手動更新基準:先手動更新同一筆訂閱一次。若手動請求本身失敗,開啟自動更新也無法修正網址、權限或格式問題。
- 分清觸發方式:Update on Open 是在開啟應用程式時更新,不代表應用程式會一直在背景以固定分鐘間隔刷新。
- 確認網路已連線:剛切換 Wi-Fi、完成網路登入或從飛航模式恢復時,請先確認網路可用,再開啟應用程式檢查。
- 確認實際結果:開啟後仍顯示舊名稱,不能單憑這點判定開關失效。遠端內容可能沒有變化,請搭配錯誤提示與手動更新結果判斷。
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 中的權杖通常用於身分驗證。複製時漏掉問號後的參數、多出空格或換行,都可能導致請求失敗。服務商重設連結後,舊網址也可能立即失效。請向服務商確認連結是否仍有效,並確認帳戶有權取得該訂閱內容。
- 比對通訊協定、網域、路徑與查詢參數,不要只確認網域是否相同。
- 若連結重新導向至登入頁,請先向服務商確認目前提供的是訂閱網址,而非帳戶管理頁面。
- 替換 URL 後,請先儲存並沿用原記錄進行測試,避免不斷新增同名群組而造成誤判。
網路連線能力:區分 DNS 解析、連線與憑證問題
HTTPS 訂閱網址未明確指定連接埠時,通常會透過 TCP 443 連線。網域解析失敗、連線逾時與 TLS 憑證驗證失敗,是不同的問題。裝置能開啟其他網頁,只能證明部分網路存取正常,不能證明訂閱網域也能連線。
- DNS 解析失敗:確認網域拼寫,並切換至其他本地網路重新測試。不要因為一筆訂閱更新失敗,就重設所有 DNS 設定。
- 連線逾時:保持網址不變,比較 Wi-Fi 與行動網路的測試結果,並記錄問題是否只在 VPN 連線期間發生。
- 憑證異常:確認裝置上的日期與時間,並請服務商檢查憑證是否有效。不要關閉憑證驗證來掩蓋問題。
Home → Global Routing 中的 Proxy、Direct、Config、Scene 會影響連線與分流方式,但不應直接假設每次訂閱請求都會走固定路徑。切換 Proxy 與 Direct 也會改變其他應用程式的流量路徑。排查時請記錄目前的模式與 VPN 狀態,不要為了更新訂閱而長時間切換至其他模式。
格式無法辨識:請求成功不代表內容可匯入
伺服器回傳 HTTP 200,只代表 HTTP 請求成功,不保證回應內容是有效訂閱。回傳內容可能是登入頁面、維護通知或空白內容。即使訂閱格式可辨識,若缺少必要欄位或通訊協定參數不完整,也可能無法建立可用項目。
| 觀察到的狀況 | 優先確認 | 下一步 |
|---|---|---|
| 回應內容是 HTML 頁面 | 是否回傳登入或驗證頁面 | 向服務商確認提供的是可供 Shadowrocket 使用的訂閱網址 |
| 回應內容為空或清單為空 | 帳戶是否已配置伺服器資料 | 請服務商檢查回應內容,不要直接刪除原有群組 |
| 部分項目無法匯入 | 對應的通訊協定與必要欄位是否完整 | 提供已遮蔽敏感資訊的錯誤訊息與通訊協定類型,不要自行猜測參數 |
| 名稱與項目數量沒有變化 | 遠端是否確實發布了變更 | 先確認請求成功,再向服務商確認預期內容 |
更新成功後仍無法連線時的檢查項目
更新成功不代表每台伺服器都能連線。若遠端已刪除或替換原有項目,請重新確認預設伺服器。VMess、VLESS、Trojan 等記錄的位址、連接埠、UUID 或密碼、傳輸方式與 TLS 參數,都應以服務商提供的資料為準,不要為了排除錯誤而任意補填。
- 在 Home 確認選取的是更新後的目標伺服器,而不是同名的手動新增記錄。
- 連線後執行 Connectivity Test,分辨「能取得訂閱」與「伺服器可連線」這兩種情況。
- 若測試可用,但特定網域仍有異常,請檢查 Global Routing 的目前模式,以及 Config 中的規則比對結果。
- 檢查 DOMAIN-SUFFIX、IP-CIDR、GEOIP 與 FINAL 等規則時,只調整與目標問題相關的項目,不要把修改規則當成修復訂閱格式的方法。
向服務商回報時,請提供發生時間、使用的本地網路、完整錯誤訊息、手動更新結果與開啟時更新結果。請遮蔽訂閱 URL 中的權杖、UUID 和密碼。不要將完整連結貼在公開截圖或留言中;若連結已外洩,請向服務商重設連結,再更新應用程式中的 URL。