適用於已經有自己的服務商與訂閱，在 Shadowrocket（小火箭）中新增後看不到伺服器，或手動更新失敗的情況。先分辨連結、回應內容與連線路徑三個環節，再逐一檢查；首次匯入後列表空白時，別把「開啟連線」當成通用解法，也不要先刪除仍可使用的舊項目。
一、先分辨：尚未匯入、未更新，還是項目無法使用
更新訂閱不等於連線到伺服器。應用程式會先存取訂閱網址、取得回應內容，再將其中支援的伺服器資訊解析並加入列表。訂閱群組已顯示，只能表示相關資訊已儲存，不代表這次請求成功；列表中仍有舊項目，也不代表剛才已完成更新。
先在 Home 查看有問題的訂閱群組，確認是否已展開，並記下手動更新後顯示的訊息。若仍有舊項目，先保留，再檢查這次更新；若首次匯入就是空列表，請優先檢查網址與回應內容。以下狀況各有不同的檢查起點，不宜混為一談。
| 可觀察到的現象 | 優先檢查 | 暫勿進行的操作 |
|---|---|---|
| 首次新增後沒有任何伺服器 | 網址是否完整、回應是否包含有效項目 | 反覆切換 Global Routing |
| 原有伺服器仍在，但更新失敗 | 訂閱狀態、連線路徑與錯誤訊息 | 刪除原訂閱及所有舊項目 |
| 列表有伺服器，但無法連線 | 伺服器參數、連線測試與服務狀態 | 僅憑連線失敗就判定訂閱格式錯誤 |
| 只看到群組名稱，沒有展開內容 | 展開群組，確認是否真的沒有項目 | 立刻重複新增相同網址 |
二、連結格式：複製訂閱網址，而非帳戶頁面
請從自己使用的服務管理頁面重新複製供 Shadowrocket 使用的訂閱網址，再與應用程式中儲存的網址核對。帳戶首頁、登入頁面、購買紀錄頁面與訂閱端點用途不同；能在瀏覽器開啟網頁，不代表該網頁就是應用程式可解析的訂閱。
- 確認複製來源。使用服務頁面中明確標示為匯入訂閱的複製功能，不要直接複製瀏覽器目前的網址列。若有不同內容格式，請選擇適用於 Shadowrocket 的格式；不要只根據副檔名判斷。
- 檢查開頭與結尾。確認開頭沒有多出引號、空格或說明文字，結尾也未被通訊軟體截斷。畫面上自動換行不一定會改變網址，但實際插入換行字元可能導致網址失效。
- 保留查詢參數。網址中
?後的參數可能用於身分驗證，&連接的後續參數也可能影響回傳格式。不要為了讓網址「更簡潔」而刪除這些參數。 - 不要手動解碼憑證。
%2F、%2B等可能是有效的百分號編碼。不要任意替換，也不要將+改成空格。 - 確認網址是否曾重設。服務端重設訂閱憑證後，舊網址可能立即失效。請用新網址取代原訂閱中儲存的網址，避免新舊群組混淆。
訂閱網址與單一伺服器的分享內容也不是同一種輸入。以 ss://、vmess:// 或 trojan:// 開頭的內容通常用來描述伺服器，不應只因為可以複製，就當成遠端訂閱網址。透過 Home → Add Server 新增時，請先確認手上的內容類型，再使用相應的輸入方式。
三、確認服務狀態：請求成功不代表內容可解析
重新複製後仍是空白，請到自己使用的服務管理頁面確認訂閱是否有效、是否仍有可用項目，以及網址是否曾重設。用戶端只能處理服務端實際回傳的內容；若回傳的是登入頁、驗證頁或空白內容，反覆匯入相同網址也不會出現伺服器。
以下卡片中的 HTTP 狀態碼是標準回應狀態，用來說明已取得的診斷資訊，不代表 Shadowrocket 在所有情況下都會顯示相同的錯誤訊息。若只看到「更新失敗」，請記下實際提示，不要直接推斷為帳戶已到期。
錯誤：HTTP 401 Unauthorized
原因與解法：端點拒絕目前的身分驗證憑證；請在自己使用的服務管理頁面確認訂閱網址是否已重設，重新複製有效網址後再更新。
錯誤：HTTP 403 Forbidden
原因與解法：端點拒絕此次存取，可能與權限或存取限制有關；請向自己的服務提供方確認回應原因，不要只因為這個狀態就反覆修改協定參數。
錯誤：HTTP 404 Not Found
原因與解法：請求路徑不存在，或服務端以此狀態隱藏已失效的資源；請核對完整路徑，確認是否仍在使用舊的訂閱端點。
錯誤：HTTP 429 Too Many Requests
原因與解法：請求觸發服務端的頻率限制；請停止連續重新整理，依服務端要求等待後再試，並檢查是否有多部裝置頻繁更新。
即使回傳 HTTP 200，內容也可能只是標示「請登入」的 HTML 頁面，而非訂閱資料。同樣地，可讀取的文字也不一定包含應用程式支援的伺服器描述。請服務提供方確認該網址對目前帳戶實際回傳的內容類型，而不只是確認「網頁能開啟」。
結論：先確認回應內容，再處理解析問題
若服務端確認回傳的是登入頁或空集合，請先處理帳戶或端點狀態；確認回應包含適用的伺服器項目後，再繼續檢查格式相容性與更新設定。
四、更新時機：檢查 Settings → Subscribe 與連線路徑
開啟 Settings → Subscribe，核對訂閱更新相關設定，尤其是 Update via Proxy。此設定會影響訂閱請求的連線路徑，不會修正錯誤網址，也不會產生伺服器項目。首次匯入時沒有任何可用伺服器，不能假設開啟此選項就能完成請求。
- 先手動更新一次。回到 Home 下拉以觸發更新，查看目標訂閱的結果。每次只變更一個條件，並記錄變更前後的提示，避免同時修改網址、網路與路由模式。
- 確認基本網路可用。如果目前的 Wi-Fi 需要網頁認證，請先完成系統網路認證。一般網頁能開啟，只能證明部分網路功能正常，不代表一定能存取訂閱網域。
- 再決定是否使用 Update via Proxy。如果已有可用伺服器，而且訂閱端點必須透過該路徑存取，可啟用此選項，連線至現有伺服器後，再回到 Home 手動更新。若沒有可用伺服器，請先處理首次取得訂閱時的連線條件。
- 確認自動更新條件。在 Settings → Subscribe 查看目前提供的更新選項及其狀態。開啟應用程式、手動重新整理與背景活動並非同一個時機；不應將系統背景排程視為精確的定時工作。
- 以前景結果再次確認。變更設定後，讓應用程式保持在前景並手動更新一次。不要只因連線開關已開啟，或等待了一段時間，就認定訂閱已更新。
Global Routing 中的 Proxy、Direct、Config、Scene 是路由模式選項，與訂閱更新開關不屬於同一層設定。Config 模式會使用目前 Config 中的規則，規則順序與策略可能影響相關請求的路徑；但在確認網址與回應內容之前，不應大幅修改規則。
五、列表仍是空白：用四個問題縮小範圍
以下四項分別對應首次匯入、格式辨識、網路差異與保留舊項目。依照實際狀況選擇操作，不必把所有設定都試一遍。協定名稱只表示連線類型；Shadowsocks、VMess、VLESS、Trojan、Hysteria2 或 WireGuard 這些名稱本身，都不能證明整份訂閱已正確解析。
第一次匯入就是空白，需要先開啟連線嗎？
先檢查 Home 是否已有可用伺服器。完全沒有項目時，開啟連線無法取代取得訂閱；請回到服務頁面核對網址與內容，再於 Settings → Subscribe 檢查 Update via Proxy 是否符合目前的使用情況。
同一個網址在瀏覽器中能開啟，為什麼仍然解析失敗？
瀏覽器可能已有登入狀態，也可能顯示登入頁或驗證頁。請服務提供方確認應用程式直接請求該網址時，回傳的是適用於 Shadowrocket 的訂閱內容，而不只是檢查網頁是否顯示成功。
Wi-Fi 連線失敗，切換到行動網路就能更新，是網址有問題嗎？
同一網址在其他網路上能成功，表示應優先檢查故障網路的認證、網域解析或存取限制。保持網址與 Subscribe 設定不變，再比較不同網路的結果；不要同時重設訂閱憑證，否則無法判斷是哪項變更產生作用。
更新失敗，但舊伺服器仍可用，需要刪除後重新新增嗎？
請先保留舊項目，記下這次更新的錯誤並確認服務狀態。舊伺服器可連線與訂閱端點可存取是兩回事；刪除後可能失去目前可用的連線方式，也無法修復端點權限或回傳內容。
六、重新測試與回報：保留有助於定位問題的紀錄
問題排除後，請在 Home 確認目標群組中確實出現預期項目，再個別檢查伺服器連線狀況。伺服器數量並非越多越能證明更新成功，應與目前帳戶實際回傳的內容相符。也不要只因舊項目名稱沒有變，就判定這次更新失敗。
- 記錄操作：是首次新增還是更新現有訂閱、是否重新複製網址，以及是否變更 Update via Proxy。
- 記錄環境：使用 Wi-Fi 或行動網路、網路是否需要認證，以及更新時應用程式是否在前景。
- 記錄現象：群組是否存在、是否已展開、是否保留舊項目，以及錯誤訊息的完整內容。
- 記錄比較結果：保持網址不變，只切換網路後的結果；或保持網路不變，只調整更新路徑後的結果。
- 保護憑證：向自己的服務提供方回報時，請使用其正式支援管道；分享截圖前，先遮住完整訂閱網址與驗證資訊。
關於網址有效性、帳戶權限與回傳內容，請向自己的服務提供方確認；如需了解應用程式選單與設定的用途，可繼續閱讀教學與協定手冊。本站不提供、不銷售，也不推薦任何伺服器或訂閱。用戶端買斷 ≠ 線路方案，購買應用程式本身不會附帶可匯入的伺服器列表。