本文適合已向服務商取得訂閱的使用者。先在 Home 手動更新並確認結果，再設定開啟 App 時自動更新；若更新失敗，依序檢查連結、網路、HTTP 回應及內容格式。訂閱請向你的服務商取得。更新成功只代表訂閱內容已讀取，不表示其中每個連線都能使用。
訂閱更新與連線的差異
Shadowrocket（小火箭）中的訂閱，是透過網址讀取伺服器設定的方式。更新訂閱時，App 會重新存取該網址，並依回傳內容更新對應的群組。這不是更新 App，也不是更新 Config 檔案。個別新增的伺服器設定沒有訂閱來源，下拉重新整理不會替你向服務商取得新的網址、連接埠或帳密。
各個環節可能發生不同問題：網址錯誤時可能無法存取；網路不通時請求可能逾時；伺服器正常回應但傳回登入頁面時，內容仍無法解析為訂閱。因此，Home 中仍顯示舊項目，不代表這次更新成功。排查時請一併查看重新整理提示、訂閱群組內容，以及服務商通知的變更。
在 Home 手動更新
先手動更新一次並確認結果，再啟用自動更新。如此可分辨是「觸發方式未生效」還是「訂閱請求本身失敗」。如果已有訂閱群組，請從以下第二步開始，不必重複新增相同網址。
-
確認訂閱
在 Home 確認是否已有對應的訂閱群組。首次新增時，前往 Home → 右上角「+」→ Type → Subscribe，填入向服務商取得的完整訂閱網址，儲存後返回 Home。
-
下拉更新
在 Home 清單頂端向下拉動以重新整理。請讓 App 保持在前景，等候更新完成；不要連續下拉，也不要在請求進行時反覆切換網路。
-
查看結果
留意重新整理完成後的提示，並檢查目標群組。若服務商明確通知新增、刪除或更名，請確認對應項目；若遠端內容沒有變更，即使更新成功，清單看起來也可能維持原狀。
-
個別測試連線
確認更新成功後，再選擇要使用的伺服器並測試實際連線。分別記錄「訂閱是否更新」和「伺服器是否連線成功」，避免把連線失敗誤判為訂閱失效。
若有多個訂閱，請留意提示所指的是哪個群組，不要因為一個群組更新成功，就推斷其他群組也已更新。更新可能會變更由服務商管理的項目，因此需要長期保留的個人修改，不建議直接寫在訂閱產生的項目上；修改前請先記下必要資訊。
設定開啟時自動更新
設定路徑為 Settings → Subscribe → Update On Open。啟用後，App 會依此設定在開啟時嘗試更新訂閱。這項設定控制的是取得訂閱內容，不是系統 VPN 的自動連線；Settings → On Demand 用於管理隨選連線，兩者是不同的開關。
- 先在 Home 手動重新整理一次，確認目前的網址可以正常讀取。
- 前往 Settings → Subscribe，找到並啟用 Update On Open。
- 離開 App 後再重新開啟，查看 Home 的更新狀態與結果。不要只憑項目數量是否改變，判斷是否已發出更新請求。
- 若手動更新成功，但自動更新沒有預期結果，先確認開關仍為啟用狀態，再記下當時使用的網路及開啟 App 的方式。
「開啟時」不代表 App 會在背景持續輪詢，也不表示鎖定畫面後會按固定間隔更新。系統會自行管理背景執行；若要立即確認訂閱狀態，前往 Home 手動重新整理較容易核實。自動更新若遇到網路或授權錯誤，也需要依下文排查；開關本身無法修復失效的網址。
先確認網址與授權狀態
訂閱網址通常包含憑證。複製時請保留完整查詢參數，不要截掉問號後的內容，也別把訂閱頁面的網址誤當成訂閱介面。以下僅以虛構值示意格式，並非可用訂閱，請勿匯入測試。
https://example.com/sub?token=xxxx- 確認網址完整：檢查網址前後是否多了空格、換行或通訊軟體自動附加的標點。不要自行刪除看似複雜的參數。
- 確認網址來源：使用向服務商取得且適用於 Shadowrocket 的訂閱網址，不要使用帳戶首頁、付款頁面或公告頁面的網址。
- 確認有效期限：向自己的服務商確認訂閱授權是否有效、網址是否已重設，以及是否有存取頻率限制。
- 確認替換範圍：服務商重設 token 後，請更新本機儲存的訂閱網址。重新開啟 App 不會自動將舊 token 換成新的 token。
若錯誤訊息中出現 HTTP 狀態碼，可先依下列三種情況判斷。狀態碼只代表請求的處理結果，無法直接判定訂閱格式是否正確；尤其是 200，仍須確認 App 是否成功解析內容。
網路錯誤與請求失敗排查
以下列出網路請求可能傳回的英文錯誤原文；實際顯示方式依目前介面及系統回傳資訊而異。排查時請保留實際錯誤內容，不要一律記成「無法更新」。每次只變更一個條件，再手動重新整理一次，方便判斷是哪個步驟有效。
錯誤：The request timed out.
原因：請求未能在等候時間內完成，可能與目前的網路或訂閱伺服器回應有關。
解決方法：先確認一般網頁可以正常開啟，再切換 Wi-Fi 與行動網路測試；若兩種網路都逾時，請向自己的服務商確認介面狀態。
錯誤：A server with the specified hostname could not be found.
原因：無法解析訂閱網域，可能是網域拼字錯誤、網路 DNS 異常，或伺服器端已變更網域。
解決方法：核對原始網址中的網域，再改用其他可用網路重試；若仍然失敗，請向自己的服務商確認目前使用的網址。
錯誤：Could not connect to the server.
原因：無法與目標伺服器建立連線，可能是伺服器停機、連接埠無法存取或網路存取受到限制。
解決方法：保持網址不變，比較不同網路下的結果；若只有這個訂閱失敗，請提供已隱去敏感資訊的錯誤內容，讓自己的服務商協助確認。
若系統時間明顯不正確，HTTPS 請求也可能出現憑證錯誤，請先在裝置的系統設定中確認日期與時間。不要透過略過憑證驗證來處理訂閱失敗。網址中的 HTTPS 連接埠通常為 443；除非服務商明確提供其他連接埠，否則不要自行填寫或修改連接埠號碼。
- 若目前的連線完全中斷，請先恢復裝置本身的網路，再測試訂閱請求。
- 若連線時更新失敗、斷線後卻成功，請記下這項差異，並檢查目前的路由與連線狀態，不必立刻刪除訂閱。
- Global Routing 中的 Proxy、Direct、Config、Scene 是路由模式選項，不是訂閱格式設定。切換模式無法修復失效的 token 或不相容的內容。
- 若出現 HTTP 429，請停止連續重新整理，依服務商指示等候一段時間後再試，以免進一步觸發頻率限制。
格式不符、清單空白與舊項目
網路請求完成後，仍可能無法匯入。常見原因是介面傳回 HTML 登入頁、驗證頁、錯誤說明或空白內容，而非 App 可辨識的訂閱資料。不要只因為瀏覽器能開啟某個頁面，就認定它是有效訂閱；瀏覽器可能帶有登入狀態，App 發出的請求條件不一定相同。
| 觀察到的現象 | 優先檢查項目 | 下一步 |
|---|---|---|
| 請求有回應，但無法解析 | 確認回應內容是否為登入頁或錯誤頁面 | 確認使用的是適用於 Shadowrocket 的訂閱介面 |
| 重新整理後沒有可用項目 | 確認遠端是否傳回空白清單或授權提示 | 向自己的服務商確認訂閱內容與帳戶狀態 |
| 服務商更名後仍顯示舊名稱 | 確認這次更新是否成功，以及查看的是否為正確群組 | 確認目標訂閱網址與更新結果後，再比較項目 |
| 清單已更新，但連線失敗 | 確認伺服器網址、連接埠、憑證及目前的網路 | 改為診斷連線問題，不要繼續重複更新訂閱 |
Type → Subscribe 代表依訂閱網址取得設定集合，並非讓使用者在此選擇 Shadowsocks、VMess、VLESS、Trojan、Hysteria2 或 WireGuard。實際使用的協定與連線欄位取決於訂閱內容。若服務商提供多種格式，請向自己的服務商確認哪一種適用於 Shadowrocket，不要只改網址副檔名來猜測格式。
也不要為了排除格式問題而直接清空所有項目。請先保留錯誤資訊，確認自己持有完整且有效的訂閱網址，再考慮替換對應訂閱。刪除舊群組後，若新網址仍無法使用，原有資訊也會一併消失，讓前後狀況更難比較。
再次確認結果並整理回報資訊
完成排查後，返回 Home 再手動更新一次，並將結果分為三類：請求失敗、請求完成但解析失敗、解析成功但連線失敗。確認問題發生在哪個環節後，再決定要檢查網路、聯絡自己的服務商確認訂閱，還是繼續診斷連線。
- 記錄操作步驟：例如在 Home 下拉重新整理，或啟用 Settings → Subscribe → Update On Open 後重新開啟 App。
- 記錄錯誤原文：保留 HTTP 狀態碼或系統網路錯誤；擷取畫面前，請遮住完整訂閱網址、token、密碼及個人帳戶資訊。
- 記錄環境差異：說明問題發生時使用 Wi-Fi 或行動網路、是否已建立連線，以及切換網路後結果是否相同。
- 記錄清單變化：說明是所有訂閱都失敗，還是只有某個群組失敗，以及服務商預告的變更是否已出現。
請勿將含有 token 的訂閱網址傳送至公開留言區或公開檢測頁面。回報時請先提供已隱去敏感資訊的網域與錯誤內容；若需提供完整憑證，請使用自己的服務商指定的私人支援管道。手動更新穩定成功後，再保留 Update On Open 作為日常設定；實際使用遇到異常時，仍應確認更新結果。