Shadowrocket 訂閱更新教學:手動更新、開啟時自動更新與更新失敗排除

說明如何在 Home 手動更新訂閱、設定開啟時自動更新,並依序排查連結過期、網路無法連線或格式變更造成的更新失敗。

本文重點

已新增訂閱卻看不到新項目時,先在 Home 手動重新整理,再檢查 Settings → Subscribe 中的 Update On Open。本文以 iPhone / iPad 英文介面為操作基準,適合已有服務商與訂閱連結的使用者;其他平台請比對同名功能。閱讀後可分辨連結失效、網路連線失敗與內容解析失敗,並了解更新後仍無法連線的原因。

先辨別更新的內容

Shadowrocket(小火箭)的訂閱更新,是重新連線至已儲存的訂閱網址,將回傳內容解析為連線項目,再同步至對應的訂閱群組。這不是更新應用程式,也不是替線路方案續約。訂閱連結請向你的服務商取得;買斷客戶端 ≠ 線路方案,客戶端的購買費用不會改變服務商帳戶的流量、期限或連線權限。

Home 顯示連線項目與訂閱群組;Config 管理設定檔及其規則;Settings 管理應用程式設定。本文討論的是 Home 中連線訂閱的重新整理,不包含 Config 設定檔的遠端更新。重新整理連線訂閱通常不會變更 Config 中的 DOMAIN-SUFFIX、IP-CIDR 或 FINAL 規則。

2 種
更新方式:Home 手動重新整理、Update On Open
3 類
排查項目:訂閱網址、網路連線、回傳內容
443
HTTPS 未明確指定連接埠時的預設連接埠

訂閱網址、連線伺服器網址與設定檔網址不可混為一談。訂閱網址用於取得項目;連線伺服器網址與連接埠則用來建立實際連線。即使兩者都使用 443,也不代表連線到同一台伺服器。訂閱重新整理成功,只能表示本次取得與解析完成,不能證明每個連線項目都可用。

在 Home 手動更新

初次排查建議手動觸發,方便記錄觸發時間、提示內容與項目變化。先確認 Home 中有包含訂閱來源的群組:如果只有手動輸入的伺服器,沒有訂閱網址,下拉重新整理也不會產生新的訂閱內容。重新整理後沒有變化時,不要反覆匯入同一個連結,否則更難判斷群組來源。

  1. 確認群組

    進入 Home,找到要更新的訂閱群組。若尚未新增,點選 Home 右上角的「+」→ Type → Subscribe,填入向服務商取得的訂閱網址並儲存。

  2. 檢查網址

    在該訂閱的編輯資訊中檢查 URL,確認協定、路徑與查詢參數都完整保留。不要將服務商帳戶的登入網址當作訂閱網址,也不要讓複製時附帶的空格或換行留在連結中。

  3. 下拉重新整理

    回到 Home,將列表捲動至頂端後下拉並放開,等待重新整理完成。此操作可能更新多個已儲存的訂閱,因此請特別查看目標群組,不要只看列表項目總數。

  4. 檢查結果

    記下錯誤提示,或核對服務商明確告知有變動的項目。若名稱與數量都和原本相同,先確認服務商是否確實更新了內容;結果相同不代表更新失敗。

範例網址 https://example.com/sub?token=xxxx 僅供辨識格式,不能用來實際訂閱。其中 token 是存取憑證的一部分,不能只保留網域後再嘗試重新整理。分享排查資訊時,應遮蔽完整查詢參數、帳戶資訊與連線憑證,不要公開訂閱原文。

開啟時自動更新

在 Settings → Subscribe 中找到並開啟 Update On Open 後,應用程式會依此功能的觸發邏輯,在開啟時嘗試重新整理訂閱。這適合希望在使用前取得最新項目的情況,但不等於每隔幾分鐘定時重新整理,也不保證應用程式關閉後會持續執行。系統背景排程、目前網路與伺服器回應都會影響結果。

Update On Open 與 Settings → On Demand 是不同設定。前者用於重新整理訂閱;後者則是在符合條件時觸發 VPN 連線。開啟 On Demand 不會自動修復訂閱下載失敗;關閉它也不是更新訂閱的必要步驟。排查時只調整與目前問題相關的設定,才能判斷變化原因。

了解重新整理流程

觸發更新 要求訂閱網址 接收回應 解析項目 同步群組

「要求訂閱網址」階段需要完成網域解析、建立連線,以及 HTTPS 網址所需的 TLS 交握。網域解析失敗、網路無法連線或憑證驗證失敗,都會導致後續解析無法進行。此時更改 Home 中某個連線項目的協定參數,通常無法修復訂閱請求本身。

「接收回應」完成後,還需要檢查內容。HTTP 200 僅表示伺服器回傳成功回應,不代表本文內容是可辨識的訂閱;服務商登入頁、網頁驗證頁或空白內容也可能成功下載。反之,HTTP 401、403、404 已提供存取權限或路徑方面的線索,應先檢查連結,而非立即更改 DNS。

重點:先找出失敗階段

逾時時先檢查網路與連線狀態;出現 401、403、404 時先確認服務商提供的連結;請求成功但沒有項目時,再檢查回傳內容與訂閱格式。依階段處理,避免同時修改網路、設定檔與訂閱等多個變數。

依提示排查失敗原因

以下列出常見的英文網路錯誤訊息或 HTTP 狀態碼。實際提示的語言與顯示方式可能因系統和介面而異,請保留原文。單一提示只能縮小排查範圍,無法單獨證明帳戶已過期或伺服器故障。

錯誤:The request timed out.

原因:請求未能在等待時間內完成,可能與目前網路、連線路徑或訂閱伺服器回應有關。

處理方式:先停止連續重新整理,分別使用可連線的 Wi-Fi 與行動網路各重試一次;若只有其中一種網路失敗,優先檢查該網路的 DNS 解析與存取限制。

錯誤:Could not connect to the server.

原因:客戶端無法與目標服務建立連線,可能與網址、連接埠、網路連線狀態或伺服器狀態有關。

處理方式:檢查 URL 的網域與明確指定的連接埠是否完整,再向服務商確認訂閱服務是否可連線;不要自行猜測替代網域。

狀態:HTTP 401 Unauthorized

原因:訂閱伺服器拒絕目前請求的身分憑證,常見原因包括 token 無效或需要重新授權。

處理方式:向服務商取得目前有效的完整連結,替換原有訂閱 URL 後再重新整理;不要只修改參數中的幾個字元。

狀態:HTTP 403 Forbidden

原因:伺服器拒絕存取,可能與帳戶狀態、來源限制或請求頻率有關;不能只憑此狀態判定訂閱已過期。

處理方式:暫停頻繁重試,向服務商確認權限與存取限制,並提供已隱去敏感資訊的錯誤狀態與發生時間。

狀態:HTTP 404 Not Found

原因:伺服器找不到所要求的路徑,可能是複製不完整,或原有訂閱路徑已變更。

處理方式:重新取得完整訂閱連結,檢查路徑與查詢參數;不要將首頁網址拼成訂閱網址。

遇到憑證相關錯誤時,先確認裝置日期與時間正確,再檢查網域是否與服務商提供的相符。不要藉由關閉憑證驗證來掩蓋問題。若其他 HTTPS 服務都能連線,只有該訂閱失敗,請將網域與錯誤提示提供給服務商,確認憑證與服務狀態。

格式變更與列表空白

若網路請求已完成,卻出現解析失敗、群組空白或項目明顯缺漏,請檢查訂閱內容是否已變更。服務商可能調整輸出格式、替換訂閱路徑,或在原路徑回傳帳戶提示頁面。網頁可以開啟,不代表內容符合 Shadowrocket 的訂閱格式;不要將可瀏覽的 HTML 網頁當作連線訂閱重新匯入。

觀察到的情況優先確認下一步
提示成功,但項目沒有變化服務商是否確實發布了變更確認一個已知更名或新增的項目,不要只看項目總數。
回傳登入頁或驗證頁是否複製了帳戶網頁網址向服務商取得供客戶端使用的訂閱連結。
原本可用,現在解析失敗服務商是否變更格式或路徑確認目前適用的訂閱輸出格式,保留原群組資訊後再修改 URL。
只有部分項目缺漏服務商是否刪除項目或變更欄位提供已隱去敏感資訊的差異說明,請服務商檢查輸出;不要自行猜測並填入憑證。

不要一開始就刪除訂閱再重新新增。刪除後會失去現有群組作為比對依據,也可能影響目前選取的項目。先記下訂閱名稱、錯誤原文與變化情況,再決定是否更換網址;若確實需要重新新增,請先確認新群組已成功建立且可以使用,再整理重複項目。

更新後檢查連線

重新整理完成後仍無法瀏覽網頁時,請將訂閱問題與連線問題分開處理。Home 中顯示的新項目可能尚未選取;原先選取的項目也可能已被服務商移除。先選取目前訂閱中仍存在的項目,測試連線與實際存取,再排查 DNS 或規則;不要只依賴延遲測試結果。

  1. 確認目前選取項目:在 Home 確認目前的連線項目屬於已更新的目標訂閱,而不是同名的舊群組。
  2. 確認路由模式:檢查 Global Routing。Config 會依設定規則處理請求;Proxy 與 Direct 用於不同的整體路由選擇。重新整理訂閱本身不會替你切換這些模式。
  3. 確認實際存取:使用自己原本需要存取的服務進行測試。延遲測試有結果,不代表 DNS、TLS 與網頁請求都成功。
  4. 準備回報資訊:記錄網路類型、發生時間、錯誤原文與失敗階段;聯絡服務商前,先隱藏 token、密碼與完整訂閱網址。

日常使用時,可保留 Update On Open,方便取得更新內容;服務商通知調整後,再手動重新整理一次。若更新經常失敗,依序檢查「網址是否有效、網路是否可連線、回傳內容是否可解析」,比反覆重新安裝應用程式更能對症處理。Shadowrocket 不提供、不販售也不推薦節點或訂閱;本文操作均以使用者已有自己的服務商與訂閱為前提。

下載 Shadowrocket