本文適用於已持有自家服務商訂閱連結的使用者。先分清 Home 中的節點訂閱與 Config 中的設定檔,再手動更新一次;確認成功後,設定開啟 App 時自動更新。若更新失敗,依序檢查連結是否有效、網路請求路徑是否暢通,以及回傳格式是否正確。訂閱更新成功只表示已取得並解析清單,不代表清單中的每個連線都能使用。
一、先確認更新項目:節點訂閱不等於規則設定
Shadowrocket(小火箭)的訂閱更新,是使用已儲存的 URL 再向服務商要求一次內容,並據此更新對應的節點群組。服務商變更伺服器位址、連接埠、驗證資訊或節點名稱後,重新取得訂閱才能讓本機清單與遠端內容保持一致。單純關閉再開啟連線開關,不等於重新下載訂閱。
本文以 iPhone / iPad 的 Home、Config、Settings 介面名稱說明操作。其他平台可依相同的設定名稱尋找對應入口,實際版面可能不同。開始前先確認要更新的是節點清單,別把 Config 頁面中遠端規則檔案的更新,當成節點訂閱更新。
| 項目與入口 | 更新內容 | 不代表的事項 |
|---|---|---|
| Home 中的 Subscribe 群組 | 服務商回傳的節點位址、連接埠及協定參數。 | 不代表每個節點都已通過連線測試。 |
| Config 中的遠端設定 | 設定檔中的規則及相關設定。 | 不等於更新 Home 中的所有節點訂閱。 |
| Settings → Subscribe | 訂閱取得方式,例如開啟時更新、透過代理更新。 | 不會替服務商續訂方案或恢復失效連結。 |
本站不提供、不販售也不推薦節點或訂閱。操作前提是使用者已有服務商及有效訂閱;服務狀態、流量餘額、裝置數量限制,以及訂閱 URL 是否已重設,請至自己的服務商帳戶確認。
二、手動更新:從 Home 更新並確認結果
初次排查時,先手動更新一次,方便查看錯誤訊息與更新結果。不要先刪除原有群組:舊清單中的連線可能仍可使用,刪除後反而會失去可用來恢復連線的途徑。訂閱中的驗證資訊屬於敏感資料,回報問題時只保留錯誤文字,不要公開完整 URL。
-
確認群組
進入 Home,找到既有的 Subscribe 群組,確認名稱與訂閱網址。若尚未新增,可點選 Home 右上角的「+」,將 Type 設為 Subscribe,在 URL 欄位填入自己的訂閱連結後儲存。
-
下拉更新
在 Home 清單頂端向下滑動後放開,觸發訂閱更新,並等待此次要求完成。若有多個訂閱,請逐一確認各群組的結果;不要連續下拉重複送出要求,以免混淆提示或觸發服務商的頻率限制。
-
檢查清單
展開目標群組,確認節點名稱、數量,以及服務商明確通知已調整的項目。若遠端內容沒有變動,更新前後數量相同是正常情況,不能只憑這點判定更新失敗。
-
測試連線
選取更新後的節點,在 Home 執行 Connectivity Test,再嘗試實際連線至目標服務。若清單已更新但仍無法連線,請改為檢查節點參數與連線路徑,不要反覆更新同一份訂閱。
訂閱管理的項目可能在下次更新時重新建立或取代,因此不宜將群組中手動修改的連接埠、密碼視為長期設定。若確實需要保留獨立項目,請先記錄其來源與用途,再與訂閱管理的項目區分,避免日後誤把舊參數當成服務商提供的最新資料。
三、開啟 App 時自動更新:設定位置與觸發時機
手動更新成功後,再前往 Settings → Subscribe,啟用 Update on Open。此選項會在開啟 App 時觸發訂閱更新;它不是固定間隔全天候執行的下載工作,也不保證 App 留在背景時持續更新。各平台介面上的大小寫與選項排列可能不同,請以目前畫面為準。
- 設定順序:先在 Home 手動更新成功,再前往 Settings → Subscribe → Update on Open 開啟,避免將既有連結的問題誤判為自動更新失效。
- 驗證方式:離開 App 後重新開啟,等待網路要求完成,再查看目標群組;只在頁面間切換,不能據此認定一定會再次觸發更新。
- 網路條件:開啟 App 時若遇到 Wi-Fi 登入驗證頁面、訊號切換或網路無法使用,更新可能失敗;恢復網路後請手動更新。
- 功能範圍:Settings → On Demand 用於依條件發起連線,不是訂閱更新排程器。啟用 On Demand 不會取代 Update on Open。
若想保留目前清單以便找出問題,可暫時關閉 Update on Open,再手動更新目標訂閱。排查完成後,再依需求重新啟用。自動化只會改變要求的觸發方式,不會改變服務商的存取權限、回傳格式或方案有效期限。
四、訂閱更新的流程,以及何時使用 Update via Proxy
訂閱更新必須先連至 URL 所在的伺服器,再解析回應內容。網域解析失敗、TCP 連線失敗、TLS 交握失敗、HTTP 拒絕存取與本文格式錯誤,分別發生在不同環節。只有區分失敗階段,才能判斷該更換網路、修正連結,還是聯絡服務商確認輸出格式。
Settings → Subscribe → Update via Proxy 可讓訂閱要求嘗試透過代理存取。若目前的直連網路無法連上訂閱網域,但既有節點仍可使用,可先在 Home 選取可用節點並開啟連線,再啟用此選項後手動更新。這個開關不會建立可用的連線路徑,也無法修復已過期的驗證權杖。
避免更新依賴失效節點
若更新要求必須透過代理,而目前的代理節點也已失效,就可能陷入「必須更新才能連線,卻必須連線才能更新」的循環。此時先保留原有群組,測試關閉 Update via Proxy 後能否直接更新,或改用可連上訂閱網域且可信任的網路;不要關閉 TLS 驗證來略過憑證錯誤。
例如,未明確指定連接埠的 HTTPS 訂閱通常會連線至 TCP 443;節點本身使用的位址與連接埠可能完全不同。節點延遲測試成功,不代表訂閱伺服器的 TCP 443 一定連得上。Global Routing 中的 Proxy、Direct、Config、Scene 是連線路由模式,不是四種訂閱更新方式;診斷時每次只變更一項設定,避免同時切換路由、節點與網路而無法判斷原因。
五、訂閱更新失敗原因:依回應與現象排查
先記錄完整錯誤訊息與發生條件:是只有 Wi-Fi 會失敗、只有啟用 Update via Proxy 後才失敗,還是所有網路都回傳相同狀態。以下列出伺服器或網路層可能回傳的英文錯誤原文;App 也可能顯示本地化說明,請依錯誤含義排查,不必要求文字完全一致。
錯誤:401 Unauthorized
原因:訂閱服務不接受目前要求中的驗證資訊,可能是權杖失效或 URL 已重設。
處理方式:登入自己的服務商帳戶,重新複製有效的訂閱連結,替換目標群組的 URL 後手動更新;不要自行猜測 token。
錯誤:403 Forbidden
原因:伺服器拒絕存取,可能與帳戶狀態、來源 IP、裝置限制或存取防護規則有關。
處理方式:確認帳戶狀態與裝置限制,並向服務商提供狀態碼及要求時間;不要認為更換節點就一定能解決。
錯誤:404 Not Found
原因:要求的路徑不存在,常見原因包括複製不完整、訂閱入口已遷移,或連結已撤銷。
處理方式:從帳戶頁面重新完整複製連結,確認路徑及查詢參數,避免只複製到問號之前。
錯誤:429 Too Many Requests
原因:伺服器限制短時間內的要求次數,連續更新可能再次觸發限制。
處理方式:停止重複更新,依服務商說明或回應中的 Retry-After 等待後再試,並確認是否有多台裝置同時更新。
錯誤:The request timed out.
原因:要求未能在時限內完成,可能受阻於網域解析、連線、伺服器回應或目前的代理路徑。
處理方式:先切換 Wi-Fi 與行動網路進行比對,再檢查 Update via Proxy 及所選節點是否可用;每次只變更一項設定。
沒有明確狀態碼,但提示內容無法辨識
HTTP 要求完成不代表訂閱內容有效。伺服器即使回傳 200,也可能提供登入頁面、驗證碼頁面、到期說明或空白本文,讓客戶端無法解析成節點清單。請向服務商確認該 URL 回傳的是適用於 Shadowrocket 的節點訂閱,而非帳戶管理頁面或其他類型的設定檔。
- 連結完整性:檢查前後是否有空格、換行,或複製時混入中文標點。示意網址
https://example.com/sub?token=xxxx中的查詢參數是 URL 的一部分,此範例不能用於實際更新。 - 內容與數量:更新後若群組變成空的,先確認帳戶狀態與服務商回傳內容,不要立刻刪除所有本機項目。
- 時間與憑證:若出現憑證尚未生效或已過期的提示,先確認裝置日期、時間與時區是否正確,再檢查伺服器端憑證狀態。
- 回報資料:提供錯誤訊息、網路類型、是否啟用 Update via Proxy,以及重現問題的步驟;截圖時請遮蔽 URL 查詢參數與驗證資訊。
六、訂閱自動更新常見問題
開啟自動更新後,為什麼節點數量沒有變?
數量沒變不代表沒有更新。先在 Home 手動下拉更新一次,檢查是否出現錯誤,再確認服務商明確通知變更的節點名稱或參數。若遠端清單本身沒有變動,本機內容維持原樣是預期結果。
必須讓 App 一直開著才能更新嗎?
Update on Open 的作用是在開啟 App 時觸發更新,不需要讓畫面一直停留在前景。若要立即取得最新清單,請回到 Home 手動更新並等待完成;不要以 App 是否在背景執行,推斷訂閱是否更新成功。
訂閱更新成功了,為什麼還是無法連線?
先在 Home 對新清單執行 Connectivity Test,再確認選取的節點與 Global Routing。取得訂閱與使用節點是兩個不同的要求流程;節點連接埠、驗證參數或目標服務的存取問題,都需要另外排查。
連結重設後,需要重新安裝 App 嗎?
通常只要編輯對應的 Subscribe 群組,將 URL 換成自己的新連結並儲存,再回到 Home 下拉更新即可。重新安裝無法讓舊 token 恢復有效,還可能導致尚未備份的本機設定遺失。
可以把完整訂閱連結傳給別人協助排查嗎?
訂閱 URL 通常包含可直接取得帳戶節點資訊的權杖,不宜公開。提供問題回報時請遮蔽 token 等敏感參數;若連結已外洩,請至自己的服務商帳戶重設連結,並更新各裝置儲存的 URL。