本文摘要

本文適用於已持有自己服務商訂閱連結的使用者。先在 Home 確認訂閱群組,再手動重新整理;若要在開啟應用程式時檢查更新,請前往 Settings → Subscribe 查看 Update on Open。更新失敗時,依序檢查連結、網路連線及回傳格式。更新訂閱只會重新整理連線項目,不等於更新 Config 中的規則,也不會延長服務期限。

訂閱更新會變更哪些內容?哪些內容不會一併更新?

Shadowrocket(小火箭)中的訂閱,是應用程式透過網址取得伺服器項目的方式。服務商調整網址、連接埠或其他連線參數後,應用程式必須重新請求訂閱,才能取得新資料。手動新增的獨立項目與訂閱群組來自不同資料來源;即使顯示在同一頁,也不表示重新整理會一併修改所有項目。

先分清 Home、Config 和 Settings 的用途。Home 用來查看及選取連線項目;Config 用來管理設定檔;Settings 用來調整應用程式行為。本文說明的是 Home 中訂閱項目的重新整理,不是 Config 中遠端設定檔的更新。

Home
確認訂閱群組及更新後的連線項目
Config
管理設定檔與分流規則
Settings
在 Subscribe 設定訂閱更新行為

例如,設定中的 DOMAIN-SUFFIX,example.com,DIRECT 是一條網域後綴規則。重新整理伺服器訂閱不會自動將這條規則改成其他策略。服務有效期限及剩餘用量由使用者原有的服務商決定;重新整理本身不會增加配額或延長期限。

手動更新:從 Home 重新整理並確認結果

首次匯入後、服務商通知連線參數調整後,或發現項目明顯過時時,可以先手動更新一次。操作前記下目前選取的項目名稱。先不要刪除原有訂閱,以免請求失敗時失去現有資料。

  1. 確認群組

    開啟 Home,找到自己的訂閱群組。若清單中只有手動新增的項目,請先確認是否已匯入訂閱;沒有訂閱來源的獨立項目,無法透過重新整理訂閱取得新參數。

  2. 確認網址

    在訂閱項目的編輯頁面確認 URL 是否完整。首次新增時,可從 Home 右上角的「+」進入,將 Type 設為 Subscribe,再填入自己的訂閱 URL 並儲存。不要將服務商的登入頁面網址當成訂閱網址。

  3. 下拉重新整理

    返回 Home,在清單頂端向下拉並放開,即可觸發訂閱更新。等待本次請求完成後再進行其他操作;清單較長時,先捲回頂端,以免將一般捲動誤認為重新整理。

  4. 檢查結果

    查看是否出現錯誤提示,再確認群組中的項目名稱與數量。若服務商明確通知某個項目已更名或移除,可用這項變更作為比對;清單沒有變化本身並不能證明更新失敗。

  5. 測試連線

    再次確認目前選取的項目,連線後測試自己需要存取的目標。更新成功表示資料已取得並完成解析,但不能單憑此點判定每台伺服器都可用。

訂閱網址屬於敏感資料

網址中的 token 可能具有存取憑證的作用。向自己的服務商反映問題時,請使用其私密支援管道;公開截圖或錯誤紀錄前,務必遮蔽完整 URL、token、密碼及個人識別資訊。

開啟時自動更新:Update on Open 的觸發範圍

前往 Settings → Subscribe,查看 Update on Open。啟用後,應用程式會在開啟時依此設定觸發訂閱更新。這不表示系統會在應用程式長時間未開啟時持續輪詢,也不代表只要 VPN 保持連線,訂閱就會每隔固定分鐘數自動更新。

Update on Open 和 Update via Proxy 處理的是不同問題。前者決定何時發起更新,後者決定更新請求是否透過代理路徑傳送。啟用自動更新前,應先確認同一訂閱可手動更新成功,避免將網址錯誤誤判為自動觸發失效。

反覆快速切換應用程式不是可靠的診斷方式。網路請求需要時間,也可能受到服務商的存取頻率限制。每次只調整一項設定,等待請求完成後再比較結果,才能確認是哪項調整產生作用。

先檢查請求路徑,再判斷是否需要 Update via Proxy

訂閱更新可分為四個階段。取得可辨識的內容後,應用程式才有資料可以寫入清單。因此,「網頁可以開啟」、「VPN 已連線」和「訂閱更新成功」是三種不同的判斷條件。

讀取訂閱網址 建立網路連線 取得回傳內容 解析項目資料 更新本機清單

先確認目前的 Wi-Fi 或行動網路可正常連線,且沒有尚待登入的網路驗證頁面。若目前網路無法直接存取訂閱網域,而既有連線確實可用,可嘗試前往 Settings → Subscribe 啟用 Update via Proxy,再返回 Home 手動重新整理並比較結果。

切換 Wi-Fi 與行動網路可作為對照測試。若同一網址只在其中一種網路下失敗,請優先檢查該網路的存取條件;若不同網路都回傳相同的授權錯誤,則應回頭檢查連結與服務狀態。

更新失敗:依逾時、授權、網址及格式分別處理

錯誤可能出現在提示視窗或相關請求紀錄中,顯示方式會因系統語言及回應來源而異。以下列出的是網路請求可能回傳的英文錯誤原文或 HTTP 狀態行,不保證每次都會以完全相同的提示視窗顯示。回報問題時,請保留實際看到的文字。

The request timed out.

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

解決方式:先切換網路重試一次;若已有可用的代理連線,再比較開啟與關閉 Update via Proxy 的結果。請勿短時間內連續重新整理。

401 Unauthorized

原因:伺服器未接受本次請求的身分憑證,訂閱 token 可能已失效或遭到重設。

解決方式:向自己的服務商重新確認訂閱網址,完整替換後再試;僅切換網路無法修復失效的憑證。

403 Forbidden

原因:伺服器拒絕存取,可能與帳戶狀態、存取政策或請求來源限制有關。

解決方式:向自己的服務商確認訂閱存取條件,並提供已遮蔽敏感資訊的錯誤紀錄;不要因此直接判定是用戶端解析異常。

404 Not Found

原因:伺服器找不到與該請求網址相對應的資源,常見原因是路徑不完整或入口已變更。

解決方式:確認連結路徑與查詢參數,重新複製自己的完整訂閱網址,避免手動拼接或刪除參數。

如果沒有上述網路錯誤,但更新後沒有可用項目,請檢查回傳內容是否為應用程式支援的訂閱格式。登入頁面、到期提示頁面或網路驗證頁面即使成功回傳,也不是伺服器清單。瀏覽器能顯示頁面,只能表示已取得某些內容,不能證明該內容可用於 Subscribe。

更新後的常見問題與確認方式

更新完成後,請分別確認資料是否已取得、清單是否符合預期,以及選取的項目是否能連線。不要因為一次網頁存取失敗,就推斷整個訂閱請求一定失敗。以下問題可協助進一步縮小故障範圍。

顯示更新完成,但項目完全沒有變,是沒有重新整理嗎?

不一定。遠端內容沒有變更時,本機清單可能維持原狀。先確認本次沒有錯誤提示,再以服務商已明確通知變更的項目作為比對;不要為了讓數量改變而反覆刪除及重新匯入。

已啟用開啟時自動更新,為什麼還需要手動重新整理?

手動重新整理可主動取得目前內容,也方便立即查看錯誤。Update on Open 只規定觸發時機,不保證網路請求一定能完成。發生異常時,返回 Home 下拉重新整理,記錄結果後再排除問題。

更新後,原本選取的項目不見了,該怎麼辦?

先確認該項目是否已從遠端移除或更名。重新選取目前群組中仍有效的項目,再測試連線。不要將訂閱產生的舊項目視為永久保留;如需手動維護,請清楚區分資料來源。

更新成功但仍無法連線,接下來要檢查什麼?

確認 Home 目前選取的項目,再檢查連線狀態與 Global Routing。使用 Config 模式時,請繼續確認比對規則與策略;更新訂閱不會自動修正錯誤的規則選擇。可前往常見問題頁面,繼續排除連線問題。

完成排除後,保留成功使用的更新路徑,並記下故障發生時的網路類型、實際提示及已嘗試的操作。需要進一步協助時,提供這些資訊比只說「無法重新整理」更容易找出問題。連線故障可繼續閱讀常見問題中的排除說明。

分開確認用戶端購買與訂閱服務

用戶端買斷 ≠ 連線方案。Shadowrocket 是閉源商業應用程式,僅於 Apple 平台透過 App Store 提供,主要供 iPhone 與 iPad 使用。開發者為 Shadow Launch Technology Limited,應用程式 ID 為 932747118。價格、系統需求及通用購買適用範圍,請以 App Store 頁面標示為準。本文僅說明如何管理使用者自己已有的訂閱資料。