本文適用於已持有自己服務商訂閱的使用者。先分辨請求失敗、回應內容無法解析，或有效項目為空，再確認連結與帳戶狀態，最後檢查 Subscribe 的更新路徑。排查時保留原有訂閱與可用項目，每次只調整一個條件並記錄結果。
一、先分辨「匯入失敗」與「匯入後清單為空」
Shadowrocket（小火箭）是透過 App Store 發行的閉源商業 App，採一次買斷制。可在產品頁確認開發者 Shadow Launch Technology Limited 與 App ID 932747118。購買 App 不包含連線方案；本文不提供、不販售或推薦節點與訂閱。
訂閱更新包含三個步驟：請求訂閱網址、讀取回應內容，再將支援的項目加入清單。清單為空不一定代表網路連線失敗。伺服器也可能正常回應，卻傳回登入頁面、錯誤說明，或不含有效項目的內容。
- 請求未完成：可能發生逾時、無法解析網域或連線失敗。先檢查連線路徑，不要急著修改協定參數。
- 請求完成但解析失敗：應優先檢查回應格式。網頁能開啟，不代表內容可作為訂閱匯入。
- 更新後仍沒有項目：請服務商確認回應中是否確實包含有效項目，以及帳戶是否具備相應使用權限。
- 項目已顯示但連線失敗：匯入已取得結果，接下來應檢查伺服器連線狀態與驗證參數。
二、確認 Subscribe 連結，別把網頁網址當成訂閱
請先從自己的服務商帳戶頁面重新複製完整訂閱網址。帳戶首頁、訂單頁、登入頁與訂閱介面的用途各不相同。不要只因網域相同就認定網址正確，也不要自行拼接不熟悉的參數。
https://example.com/sub?token=xxxx以上是不可用於連線的格式範例。https:// 是通訊協定部分，/sub 是示範路徑，token=xxxx 是示範驗證參數。實際介面的路徑與參數名稱由你的服務商決定，不一定與範例相同。
-
保留原有紀錄
先記下原訂閱名稱、目前項目數與錯誤提示。若原清單仍有可用項目，先不要刪除整個群組。
-
重新複製網址
在自己的服務商頁面使用複製功能取得連結。檢查開頭與結尾是否多了空格、換行、引號，或聊天 App 附加的標點符號。
-
選擇 Subscribe
前往 Home → 右上角「+」→ Type → Subscribe。在 URL 欄位貼上完整訂閱網址，不要將整條網址填入單一伺服器的 Address 或 Password 欄位。
-
儲存並重新整理
儲存後返回 Home，向下滑動以觸發更新。等候本次請求完成，記下提示訊息與項目數，再決定下一步。
查詢參數中的 &、= 與百分比編碼可能用於驗證。不要自行刪除後續參數，也不要重複進行 URL 編碼。若複製的文字含有字面上的 &，請回到原頁面重新複製正確連結，不要逐段猜測修正。
三、辨識服務商回應：狀態碼不等於有可用項目
若錯誤詳情或服務商提供的診斷紀錄中有 HTTP 狀態碼，可用來縮小問題範圍。以下是標準 HTTP 狀態說明，不代表 Shadowrocket 在所有情況下都會顯示相同錯誤。若未看到狀態碼，請勿自行判定是哪一類錯誤。
HTTP 401 Unauthorized
原因與處理方式：請求未通過介面驗證，可能是 token 遺漏或已失效。請重新複製自己的有效訂閱網址，並請服務商確認驗證狀態。
HTTP 403 Forbidden
原因與處理方式：伺服器拒絕目前的請求，可能與帳戶權限或存取限制有關。記下發生時間與網路類型，向服務商確認拒絕原因，不要反覆修改 App 的密碼欄位。
HTTP 429 Too Many Requests
原因與處理方式：介面觸發請求頻率限制。請停止連續重新整理，依服務商說明或回應中的 Retry-After 指示等候，再更新一次。
200 OK 僅表示 HTTP 請求成功收到回應，不代表內容一定可解析。登入頁面、維護公告與驗證頁面也可能使用此狀態碼。瀏覽器可能帶有登入狀態，但 App 的訂閱請求未必具備相同的工作階段條件。
- 傳回 HTML 頁面：請服務商確認該網址是否為可直接讀取的訂閱介面，以及是否需要先在瀏覽器登入。
- 傳回空白內容：確認帳戶狀態、訂閱權限，以及介面是否已產生有效項目。
- 有傳回內容但解析失敗：確認所選的訂閱格式是否適用於 Shadowrocket。單純修改檔案副檔名無法變更格式。
- 出現憑證錯誤：確認裝置的日期與時間，並請服務商檢查網域憑證。不要將關閉安全性驗證當作一般修復方式。
結論：先確認介面傳回的內容
已收到 HTTP 回應但仍匯入失敗時，應優先請服務商確認回應內容與格式；切換 Global Routing 無法將登入網頁轉換成訂閱項目。
四、檢查更新時機與 Update via Proxy
訂閱介面與訂閱中的伺服器並非同一個測試目標。一般網頁能開啟，只能證明部分網路存取正常；某個項目的 Connectivity Test 成功，也不能證明訂閱網域目前可連線。請分別記錄兩種測試結果。
在 Settings → Subscribe 中檢查 Update via Proxy。此設定用於調整訂閱更新的存取路徑，無法修復連結格式或帳戶權限。啟用前應先有可用的代理連線，否則可能陷入「需要更新才能取得項目，卻又必須依賴這些項目才能更新」的循環。
- 先保留目前清單，在穩定的網路環境下更新一次，並記錄是否逾時。
- 若已有可用項目，先選取該項目並啟用連線，確認實際存取正常。
- 前往 Settings → Subscribe，啟用 Update via Proxy，再返回 Home 向下滑動更新一次。
- 比較兩次結果。只有在更新路徑變更後結果也隨之改變，才有依據繼續檢查該路徑的連線狀況。
- 若出現明確的 401、403 或內容解析錯誤，請回頭檢查驗證資訊與回應內容，不要一直切換網路碰運氣。
首次匯入時完全沒有可用項目，不要將啟用 Update via Proxy 當作必要條件。可先改用另一個自己有權使用的穩定網路進行一次比對。若介面仍無法連線，請服務商確認該介面的存取條件。
五、項目已顯示時，別再按「訂閱清單為空」排查
清單已顯示伺服器項目，代表至少有部分內容成功解析。接下來應測試特定項目，而不是重複匯入相同網址。服務商變更密碼、連接埠或伺服器網址後，舊項目仍可能留在本機；因此也要確認這次更新是否確實成功。
- Home → Connectivity Test：檢查目標項目的連線狀況。單次測試成功，不代表所有網站、協定與時段都正常。
- Home → Global Routing：確認目前選用的是 Proxy、Direct、Config 還是 Scene。在 Direct 模式下的直連結果，無法證明所選代理項目可用。
- 使用 Config 時：檢查目前設定的比對規則與策略。
DOMAIN-SUFFIX、IP-CIDR、GEOIP與FINAL會影響流量處理，但不會建立訂閱清單。 - 部分項目可用：記下無法連線項目的名稱與測試時間，請服務商檢查對應伺服器，不必刪除整份訂閱。
訂閱介面使用 HTTPS 預設連接埠 443，不代表訂閱中的伺服器也使用 443。Shadowsocks、VMess、VLESS、Trojan、Hysteria2、WireGuard 各自有不同的連線參數。不要將訂閱 URL 的連接埠填入所有項目，也不要為了讓測試通過而隨意更改 Type。
六、聯絡服務商前，整理可重現問題的資訊
在 App 端可以檢查連結、更新路徑與可見提示，但無法代替服務商恢復帳戶權限、修復介面憑證或產生遠端項目。提交問題時請說明故障發生在哪個步驟，避免只寫「不能用」。
- 發生時間：記錄日期、確切時間與時區，方便比對伺服器端紀錄。
- 網路狀況：說明使用 Wi-Fi 或行動網路，以及在其他網路環境下是否也會發生。
- 更新路徑：說明 Update via Proxy 的設定狀態；若已啟用，請說明所依賴的連線是否已確認可用。
- 畫面結果：提供錯誤原文、HTTP 狀態碼（如有）及更新前後的項目數，不要自行推測錯誤原因。
- 保護隱私：公開截圖前，請遮住完整訂閱 URL、token、密碼與帳戶資訊；完整憑證僅透過服務商的私密支援流程提供。
結論：每次只變更一個條件
保留原有紀錄，分別測試連結、網路與更新路徑。若同時重建訂閱、切換網路並修改連線設定，即使恢復正常，也難以判斷是哪個步驟解決了問題。
七、訂閱匯入與更新常見問題
連結能在瀏覽器開啟，為什麼還是匯入失敗？
先確認開啟的是訂閱內容還是登入頁面。瀏覽器可能帶有帳戶工作階段。請返回服務商頁面重新複製訂閱網址，再透過 Home →「+」→ Type → Subscribe 新增；若仍失敗，請服務商確認介面能否直接供 App 讀取。
更新失敗後，需要立刻刪除原本的訂閱嗎？
先不要刪除。保留原有群組與可用項目，記下錯誤後再檢查 URL 與更新路徑。刪除紀錄無法修復遠端驗證，反而會讓後續比對失去依據。
重設訂閱連結後，舊連結還能繼續使用嗎？
舊連結是否立即失效由服務商決定。重設後，請將新的完整 URL 更新到對應的 Subscribe 紀錄，再手動重新整理一次。舊清單仍留在本機，不代表舊連結仍有存取權限。
啟用 Update via Proxy 後仍逾時，該怎麼辦？
先確認目前的代理連線本身可用，再檢查訂閱介面是否能透過此路徑存取。若沒有可用連線，請先恢復可驗證的更新路徑。若兩種路徑都失敗，請將發生時間、網路狀況與錯誤提示提供給服務商。
已購買 Shadowrocket，為什麼 Home 還是空的？
購買的是 App，不包含連線方案。已持有自己服務商訂閱的使用者，需依照 Subscribe 流程匯入。App 僅於 Apple 平台發行，以 iPhone 和 iPad 為主；系統需求以 App Store 頁面標示為準。