本文重點

本文適合已持有自己的訂閱，卻遇到匯入後清單空白、更新失敗或節點名稱顯示異常的 Shadowrocket 使用者。先確認加入的是訂閱而非單一伺服器，再依序檢查網址、回應內容、格式與協定欄位；完成修正後重新匯入並測試。訂閱網址可能包含帳戶識別資訊，排查時不要公開貼出完整網址或憑證。

先分清訂閱、單一伺服器與設定檔

Shadowrocket（小火箭）中的訂閱通常是可供 App 取得或更新多筆連線資料的網址；單一伺服器則是某一筆連線設定；Config 中的設定檔則可能包含規則與其他參數。三者用途不同。若把設定檔網址當成訂閱匯入，或把單一伺服器連結貼進訂閱欄位，可能無法得到預期的節點清單。

開始排查前，先回想匯入時使用的入口及選項。一般可從 Home 右上角「+」新增項目，並在 Type 選擇 Subscribe，再輸入自己的訂閱網址。不同平台版本的版面可能略有差異，請以目前介面中的英文項目名稱為準。匯入完成後，回到 Home 檢查清單；不要只根據成功提示判斷內容已正確載入。

3 類資料
訂閱、單一伺服器、Config 設定檔用途不同
2 個階段
先確認匯入，再確認更新回應
1 個原則
每次只改一項，保留前後結果

若不確定自己拿到的是哪一類資料，請查看提供訂閱的服務說明，確認它標示為訂閱網址、伺服器連結或設定檔。不要把網址內容直接貼到公開討論區；即使網址看起來只是隨機字串，也可能是可用來存取帳戶資料的憑證。

核對網址與更新回應

訂閱網址應完整保留服務端提供的字元。複製時若少了網址尾端的一段、被訊息軟體自動換行，或在前後多出空格，都可能造成更新失敗。部分網址包含問號、等號及百分比編碼，不能自行刪除或改寫。若服務端提供重新複製功能，請由原處再次複製，避免手動重打一長串字元。

接著確認更新當下的網路狀態。若訂閱端要求特定網路才能存取，暫時切換 Wi-Fi 或行動網路進行對照；若目前的連線設定已可用，也可依服務端說明確認是否需要透過代理更新。不要在還沒記錄原始狀態前，同時改動 DNS、Global Routing 和其他網路設定，否則難以判斷是哪個變更影響結果。

  1. 確認類型

    在 Home 右上角「+」新增項目，確認 Type 選擇 Subscribe，而不是手動新增伺服器或匯入 Config。

  2. 重新複製

    從自己的服務管理頁重新複製訂閱網址，檢查複製結果沒有多餘空格、換行或漏掉尾端字元。

  3. 更新一次

    儲存後回到 Home 執行更新，記下是否顯示失敗、逾時或完成，以及清單數量有沒有變化。

  4. 更換網路測試

    只切換 Wi-Fi 或行動網路其中一項，再更新一次；若結果不同，記下兩種網路下的差異。

更新失敗也可能是訂閱已失效、服務端暫時無法回應，或帳戶所用的網址已被更換。這些狀況無法單靠重裝 App 或反覆新增同一筆資料確認。若同一網址在不同網路下都無法更新，應向自己的服務提供者確認網址有效性、存取限制及目前服務狀態。

辨認常見格式與內容編碼

訂閱回應可能是多筆連線資料的文字清單，也可能採用編碼後的內容；另有服務會提供結構化設定檔。外觀看起來像一串亂碼，不一定表示格式損壞，可能只是內容經過編碼。反之，瀏覽器能打開網址，也不代表回應內容一定是 Shadowrocket 可解析的訂閱資料：頁面可能顯示登入畫面、錯誤訊息或服務端說明文字。

若要協助判斷格式，可以先確認回應是否包含多筆連線資料，或是否明確指出需要匯入設定檔。不要把完整回應內容、含帳戶識別資訊的網址、密碼或金鑰貼到公開網頁。若需要詢問服務提供者，提供錯誤時間、使用的網路類型及錯誤現象即可；敏感資料應透過其指定的安全管道處理。

依取得的資料形式選擇檢查方向

訂閱網址
  • 從服務端重新複製完整網址。
  • 在 Shadowrocket 的 Subscribe 類型中加入。
  • 更新後回到 Home 檢查項目數量。
設定檔或單筆資料
  • 確認來源說明要求的匯入方式。
  • Config 設定檔與 Home 連線項目分開核對。
  • 需要手動輸入時，逐欄對照協定欄位。

格式應依提供者的說明判定；不要只憑字串長短或是否可讀來判斷內容正確。

若回應呈現 HTML 標籤、登入提示或一般錯誤文字，App 收到的可能不是訂閱資料。此時先確認是否複製到正確的訂閱網址，以及帳戶是否仍有權限存取。若回應是編碼文字，請勿自行使用不明網站解碼；除了可能暴露訂閱內容，也可能因轉換方式不符而讓資料更難排查。

手動輸入時核對協定欄位

如果使用者拿到的是單筆伺服器資料，或服務端要求手動建立連線，欄位必須與所選協定相符。常見協定名稱包括 Shadowsocks、VMess、VLESS、Trojan、SOCKS5 與 HTTP；不同協定需要的驗證資訊並不相同。不要把一種協定的欄位照搬到另一種協定，也不要因為伺服器名稱相同，就推斷位址、連接埠或驗證方式仍然有效。

基本欄位

Type
必須與服務端提供的協定一致
Address
確認完整主機名稱或 IP 位址
Port
確認為服務端提供的連接埠數值
Name
僅供本機辨識，不決定連線參數

複製資料時留意冒號、逗號及半形字元，不要自行替換欄位內容。

依協定確認

Shadowsocks
核對加密方式及密碼等必要資料
VMess / VLESS
核對使用者識別與傳輸相關設定
Trojan
核對密碼及服務端指定的連線選項
SOCKS5 / HTTP
依服務端要求確認認證欄位

所需欄位依協定與服務端設定而異，請以自己的服務資料為準。

若清單中有節點，但選取後測試失敗，先確認是否已選中正確項目，再檢查 Type、Address、Port 及該協定要求的驗證欄位。遇到 TLS、傳輸方式或其他進階選項時，不要憑名稱猜值；請對照服務端提供的設定資料。節點名稱顯示正常，只能證明名稱字元可讀，不能證明其他欄位正確。

Type: Shadowsocks
Address: server.example.invalid
Port: 443
Name: Example node

上方僅為虛構欄位示意，不是可用的連線設定。example.invalid 是示範用網域；實際設定應使用自己的服務資料。若從分享內容手動建立節點，請一次核對一個欄位，完成後再測試，避免同時改動多個參數而無法定位錯誤。

重新匯入並確認連線

確定訂閱網址與格式無誤後，可更新原有訂閱，再回到 Home 查看節點是否出現。若先前使用錯誤網址建立了空白項目，先記下目前清單狀況，再依介面提供的管理方式移除錯誤項目並重新加入。不要一開始就刪除所有設定；保留原有資料有助於比較更新前後的結果，也可避免誤刪仍在使用的連線。

現象：更新完成，但 Home 清單仍為空白

原因與解法：回應可能不是可解析的節點清單，或匯入時選錯資料類型。確認 Type 為 Subscribe，並向自己的服務提供者核對網址回應類型與帳戶存取狀態。

現象：更新逾時或無法取得資料

原因與解法：可能是網路無法連到訂閱服務、網址失效或服務端暫時沒有回應。切換 Wi-Fi 與行動網路各測一次，記錄結果後再確認網址有效性，不要公開完整網址。

現象：名稱出現亂碼或符號不完整

原因與解法：可能與來源字元編碼或服務端提供的名稱格式有關。先重新更新並確認其他欄位是否完整；若只有名稱異常，請向來源確認字元編碼，不要自行改寫訂閱內容。

現象：節點可見，但連線測試失敗

原因與解法：訂閱可解析不代表伺服器仍可用。重新更新後選取正確節點，檢查網路與協定參數；仍失敗時將測試時間及錯誤現象提供給自己的服務提供者。

確認節點出現在 Home 後，選取其中一項，再使用 Home → Connectivity Test 進行測試。若測試成功，仍應以實際使用的 App 或網站建立新請求確認；既有連線可能沿用先前的路徑。若測試失敗，先確認目前網路可用、節點資料已更新，並確認 Global Routing 設定符合測試目的。

重新匯入不是每次排錯的第一步。若問題只出現在單一節點，可先更新訂閱並觀察該項目；若所有項目都消失，優先確認網址及回應格式。一次只變更一項，並記錄更新時間、網路類型、清單狀態和測試結果，才能把「取不到訂閱」與「連線參數不可用」分開處理。

常見問題與訂閱安全

匯入成功提示出現了，為什麼沒有節點？

成功提示不一定代表回應已解析成節點。回到 Home 檢查清單，再確認加入類型是 Subscribe，並請自己的服務提供者核對網址回應是否為 Shadowrocket 可辨識的訂閱資料。

更新一直失敗，要不要先刪除再重裝？

不必先重裝。先重新複製訂閱網址，分別在 Wi-Fi 與行動網路下更新，並記錄是否逾時或立即失敗。重裝未必能修復網址失效或服務端拒絕存取，還可能增加重新設定的工作。

可以把訂閱網址貼給別人請他幫忙看嗎？

不要公開貼出完整網址或訂閱內容。網址可能含有可存取帳戶資料的識別資訊；如需協助，先遮蔽敏感部分，並透過自己的服務提供者指定的安全管道詢問。

換到另一部裝置後需要重新檢查嗎？

需要。確認新裝置已使用正確的訂閱網址、更新後清單有載入，並重新測試所選節點。若使用 iPhone 或 iPad，Shadowrocket 在 App Store 一次性購買為 $2.99；Mac（Apple 晶片版與 Intel 版）、Windows、Android 與 Linux 版免費，均可從本站下載頁取得。電腦或 Android 首次開啟若遭系統攔截，請依下載頁的「安裝放行」說明處理。

訂閱更新通常會從來源取得最新連線資料，不應把它當成可公開分享的普通網址。管理多部裝置時，應在每部裝置確認目前使用的訂閱、最近更新結果及 Home 清單；不要只以某一部裝置已能連線，推斷其他裝置也已同步。若服務提供者更換網址，請依其正式通知更新本機資料，並妥善移除已失效的舊項目。

最後可用四項結果完成排查記錄：匯入類型是否正確、更新是否取得回應、Home 是否出現節點、Connectivity Test 是否成功。這四項分別對應資料類型、網址存取、格式解析及連線測試。先找出停在哪個階段，再處理相應問題，比反覆重貼網址或一次修改多個網路選項更容易得到明確結果。