Shadowrocket 使用指南：從匯入到連線驗證

訂閱網址：選擇 Subscribe 後儲存

開啟 Shadowrocket 的 Home，找到 Add Server，或使用頁面上的新增入口進入新增頁面。開啟 Type 清單，選擇 Subscribe，再將自己已有的完整網址貼到訂閱的 URL 欄位。也可填寫方便辨識的名稱，然後儲存並返回 Home。若儲存後尚未出現伺服器，請使用該訂閱項目的更新功能並等待結果，避免連續重複新增相同網址。

複製時應從網址開頭到結尾完整選取，尤其留意問號後方的參數。請勿連同網頁標題、說明文字、引號或末尾空格一起貼上。訂閱網址通常包含存取憑證，應像密碼一樣妥善保管。如果取得的是帳戶管理頁面，而非訂閱網址，用戶端便無法將其解析為伺服器清單；請先向自己的服務商確認網址用途，再嘗試匯入。

匯入成功後，返回 Home 的 SERVER 分組，檢查是否出現訂閱分組與伺服器項目。名稱出現只代表資料已匯入用戶端，不代表遠端伺服器一定可以連線。先選取其中一個項目，再繼續選擇模式。若畫面顯示訂閱的流量或有效期限說明，請以該服務的帳戶資訊為準，不可據此推斷用戶端的購買狀態。

手動填寫：Type 決定後續欄位

如果準備的是單筆伺服器資訊，請先在 Add Server 中選擇 Type，再逐項填寫。以截圖中的欄位為例，Host 是伺服器位址，Port 是連接埠，Password 是認證內容，Method 必須與伺服器端提供的加密方式一致。其他協定可能會顯示不同的認證、傳輸或 TLS 欄位，應依既有資料填寫，不可將某種協定的欄位直接套用到另一種協定。

Host 通常填寫網域或 IP 位址，請勿順手加上網頁路徑；Port 應依服務端的實際設定輸入，不要因為熟悉某個常見連接埠就自行替換。儲存前請逐項檢查，尤其留意密碼中的大小寫、數字與符號。若資料未說明某項是否必填，請先確認協定要求，而不是隨意開啟額外選項。協定名稱與欄位的關係可參閱術語表。

QR Code 與 JSON：先確認內容類型

如果已有伺服器 QR Code，可使用 Scan QR Code 並依系統提示允許相機存取。掃描後仍須核對 Type、位址與連接埠，再儲存。Import from Cloud JSON 適用於相應的 JSON 匯入內容，並非貼上任意訂閱網址的通用入口。無論使用哪種方式，最後都應返回 SERVER 分組檢查項目，避免停留在編輯頁面，卻以為已完成新增。

本步完成標誌：Home 中已有可選取的伺服器記錄，而且你清楚知道目前選取的是哪一筆。接下來決定哪些請求使用這台伺服器。

返回 Home，點選 Global Routing，查看目前的選擇。首次操作時，先辨認三種模式：Config、Proxy、Direct。此處的 Config 是模式名稱，底部導覽中的 Config 則用於管理設定檔；兩者相關，但開啟某個檔案查看，不代表已將該檔案選為目前設定。

Config：讓規則決定請求路徑

如果已有明確來源且了解用途的設定檔，可以選擇 Config。接著前往 Config 頁面確認目前使用的檔案，並查看 Rule 中的策略與順序。通常請求會依規則比對結果使用 PROXY、DIRECT 或 REJECT。設定中引用的策略名稱必須有對應定義；僅匯入伺服器訂閱，不代表已匯入完整規則。

官方截圖展示設定編輯頁中的 General、Rule、Hosts、URL Rewrite 與 HTTPS Decryption 等區段。首次連線只需確認目前檔案與 Rule，不必為了完成指南而修改每個區段，也不需要開啟 HTTPS Decryption。Add Rule 用於新增規則；尚未了解現有順序時，請勿隨意追加規則，否則可能將問題從「連線失敗」變成「規則提前命中」。

Proxy 與 Direct：用於指定明確路徑

暫時沒有可確認的規則設定時，可以短暫使用 Proxy 檢查目前伺服器的基本可用性。此模式下通常由選取的伺服器處理可代理的請求，但不能因此假設所有系統流量都經過相同路徑。Direct 則用於不經代理伺服器的連線；在此模式下能開啟網站，並不能證明剛新增的伺服器可用。

如果 Proxy 可以連線，Config 卻無法連線到同一目標，應優先檢查規則、策略引用與解析路徑，而不是立即更換密碼。反之，若兩者都失敗，請先確認伺服器與目前網路。切換模式後應重新發送請求，舊連線可能仍使用原本的路徑。若要了解 DOMAIN-SUFFIX、IP-CIDR、FINAL 等比對方式，請閱讀代理模式說明與Settings 設定參考；本指南先維持最小調整範圍。

本步完成標誌：能說明目前選用的模式；使用 Config 時，也能確認目前的設定檔。記住這個狀態，再進行連線授權。

返回 Home，在 SERVER 分組點選要使用的伺服器，檢查選取標記。接著開啟頂部連線開關。首次執行時，系統可能提示允許 Shadowrocket 新增 VPN 設定；閱讀提示並確認是這次主動操作後，依系統要求完成授權或裝置身分驗證。此授權用於讓用戶端接管相應的網路請求，不會自動補齊缺少的伺服器參數。

如果剛才拒絕授權，請先返回應用程式重新發起連線，查看系統提示是否再次出現；仍無法繼續時，請前往系統的 VPN 設定管理確認相關狀態。請勿從陌生頁面安裝額外的描述內容來「修復」連線。裝置受組織管理時，系統政策也可能限制 VPN 設定，請先確認裝置允許的操作範圍。

完成授權後返回 Home，觀察頂部是否已離開 Not Connected 狀態，並等待狀態穩定。請勿快速反覆開關：這會讓建立連線、斷線與測試請求彼此交錯，反而難以判斷哪次操作產生了結果。如果開關立即彈回，請記錄當時出現的錯誤；若一直停留在建立連線階段，先保留目前設定，前往最後的排錯步驟檢查。

系統顯示 VPN 狀態，只代表通道或網路延伸功能處於相應狀態，不代表每個遠端請求都已成功。伺服器認證、目標存取、DNS 解析和規則命中仍須分別驗證。完成測試前，也先不要啟用 On Demand，以免自動連線行為干擾手動開關的判斷。

本步完成標誌：已完成系統授權，Home 的連線狀態穩定，且操作期間沒有誤選其他伺服器。接著以實際請求確認可用性。

訂閱未匯入，或更新後沒有伺服器

先查看訂閱更新顯示的具體錯誤。取得失敗與內容解析失敗並非同一回事：前者先檢查裝置基本網路、網址完整性與訂閱存取權限；後者應確認回傳內容確實是用戶端可辨識的伺服器資料，而非登入頁、到期提示頁或一般網頁。更新成功卻沒有可用項目時，再檢查是否設有篩選條件，以及訂閱本身是否包含有效伺服器。

請勿為了測試網址，就將含有憑證的完整訂閱連結貼到公開檢測服務。需要確認訂閱狀態時，應在自己的服務帳戶頁面核對，或向原服務方說明錯誤現象。保留既有項目，先嘗試更新與核對，不要連續刪除全部記錄後重新新增。

有伺服器，但連線失敗或立即中斷

重新開啟伺服器編輯頁，核對 Type、Host、Port 與認證參數。使用 TLS 或特定傳輸方式時，也應核對相應的伺服器名稱、路徑等欄位；這些值應來自既有資料，不要憑經驗補寫。確認裝置時間正常，再檢查目前網路是否允許存取該位址與連接埠。參數正確也不代表服務端一定在線上，必要時請向原服務方確認狀態。

如果系統授權尚未完成，請先處理授權，而非修改伺服器密碼。若連線一開啟就被其他自動連線行為改變，請進入 Settings 檢查 On Demand，並依系統中其他 VPN 設定的目前狀態判斷。先用手動連線完成一次驗證，再設定按需連線條件。

Connectivity Test 失敗，但部分連線正常

進入 Settings 查看 Test Method，確認使用的測試方式與要判斷的問題相符。某種測試沒有回應，不代表網頁請求一定失敗；同樣地，某項測試通過也不能證明認證、DNS 與目標服務都正常。保持伺服器與模式不變，換一個自己需要使用的實際目標交叉驗證，再決定是否繼續調整測試設定。

連線正常，但目標無法開啟或分流不符

先區分網域解析失敗、連線逾時、認證錯誤與目標服務回傳錯誤。若懷疑 DNS，先記錄目前設定，再依Settings 設定參考檢查系統 DNS、自訂 DNS 與規則的搭配；不要一次加入多個來源不明的解析位址。若 Proxy 正常而 Config 異常，請著重檢查 Rule 是否提早命中 REJECT、是否使用非預期的 DIRECT，以及策略引用是否存在。

調整規則前先保留一份原始設定，修改後重新建立相關請求，再查看命中情況。DOMAIN-SUFFIX 與 DOMAIN-KEYWORD 的比對範圍不同，IP-CIDR 則涉及位址比對，不宜只憑規則名稱猜測含義。需要補充基礎概念時，請先查閱規則關鍵字術語，再回到設定中修改。

準備可複查的診斷資訊

Settings 中的 Diagnostics 可作為診斷入口，實際可用項目以目前介面為準。請記錄模式、伺服器協定、使用的網路、失敗步驟與錯誤原文；提供記錄前，先檢查其中的位址、認證內容與訂閱參數，並移除敏感資訊。對外說明「在 Config 下某個網域逾時，切換到 Proxy 後恢復」，比只說「無法使用」更容易定位問題。

本步完成標誌：能將故障歸納為匯入、授權、伺服器、DNS 或規則其中一個階段，並保留相應的觀察結果。若連線已恢復，再逐項還原日常設定，不要把排錯期間的暫時模式當成最終設定。