Shadowrocket 使用教學

Step 01 / Add Server

新增伺服器或匯入現有訂閱

先確認手上的資料類型：若是用來取得伺服器清單的訂閱連結，請使用 Subscribe；若是獨立伺服器的位址、連接埠與驗證資料，請依照對應的 Type 手動填寫。兩種方式擇一即可，不必把訂閱連結拆成 Host 和 Password，也不要把一般網站網址當作訂閱網址。若不確定資料的用途，請先向現有服務供應商確認，再開始填寫。

使用 Subscribe 匯入

開啟 Shadowrocket，在 Home 找到 Add Server，進入後點選 Type，再選擇 Subscribe。回到新增頁面，將自己持有的完整訂閱連結填入 URL，並填上方便辨識的備註，再使用頁面上的儲存功能。複製時請保留連結中的查詢參數，並刪除不慎一併複製的前後空格或換行；連結可能包含存取憑證，請勿張貼在留言、聊天截圖或公開文件中。

儲存並取得內容後，回到 Home 查看訂閱分組及其中的伺服器項目。若只看到分組名稱而沒有項目，請先確認訂閱是否成功取得內容，不要立即嘗試連線。資料有更新時，使用該訂閱項目提供的更新功能重新取得內容，再確認是否出現預期項目。匯入只是將連線參數加入客戶端，不代表伺服器已可使用；連線能力需在後續步驟另外驗證。

透過 Add Server 手動填寫

在 Add Server 中先選擇 Type，再依自己的資料填寫 Host、Port 及該類型所需的驗證欄位。例如，Shadowsocks 需確認 Password 與 Method；其他類型可能使用不同的驗證、傳輸或 TLS 欄位。欄位名稱相近也不可互相替代，Host 也不可填入帶有路徑的網頁連結。伺服器位址、連接埠、大小寫及加密方式都應與原始資料一致。

若已有對應的 QR Code，可使用 Scan QR Code 讀取資料；Import from Cloud JSON 僅適用於確實持有相應格式資料的情況。匯入後仍須開啟項目，檢查 Type 與重要欄位。儲存後回到 Home，確認 SERVER 中找得到該項目，並以備註區分其他項目。此時先保留原始資料，下一步設定路由，再選取該項目進行連線。

Step 02 / Global Routing

選擇 Global Routing 模式

儲存伺服器資料後，回到 Home 並點選 Global Routing。此處決定流量的處理方式，不會修正伺服器參數。三種常用模式分別是設定 (Config)／代理 (Proxy)／直連 (Direct)。先依目前需求選擇，再開啟連線；「已選擇伺服器」不等於「所有要求都會經由伺服器」。

設定 (Config)：依目前設定比對規則

需要規則分流時，選擇 Config，再進入 Config 頁面確認目前實際使用的設定檔。開啟設定後檢查 Rule，並留意末尾的預設規則。規則通常依序比對，特定網域應放在較廣泛的規則之前；FINAL 用來接收前面未匹配的要求。修改未啟用的設定檔不會改變目前連線的路由結果，因此請先確認檔案，再編輯內容。

以下規則片段用來說明比對方式：example.com 及其子網域匹配 PROXY，其餘要求交由 FINAL,DIRECT 處理。此例只示範規則語法，不含伺服器資料，也不應直接取代完整設定。PROXY 對應的實際輸出選擇，仍須在自己的設定與 Home 中確認；DIRECT 表示該規則要求直連。

[Rule]
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT

代理 (Proxy) 與直連 (Direct)：明確指定目前路徑

Proxy 會依代理模式處理目前路由，可用來暫時排除規則因素，檢查所選伺服器能否正常完成實際連線。Direct 依直連模式處理，不能以直連成功證明伺服器可用。測試期間請記下原本的模式，測試後再恢復，否則容易誤以為「剛才可以用，改完規則卻沒有變化」。

初次使用時，不必同時修改 DNS、HTTPS Decryption 和多條規則。先保留現有設定，完成一次連線與驗證，再逐項調整。若要比較 Shadowsocks、VMess、VLESS、Trojan、WireGuard 或 Hysteria2 的欄位差異，請參閱協定參考；本頁繼續使用已匯入並確認無誤的資料。

Step 03 / Home

選取伺服器並開啟連線

回到 Home，在 SERVER 分組中點選剛才確認過的伺服器，並確認選取標記位於目標項目上。訂閱中的多個項目代表不同的連線選擇，不表示客戶端會自動判斷哪些可用。為方便核對，首次測試只選一個項目，並記下其備註、目前網路及 Global Routing 模式。

處理首次 VPN 設定授權

開啟 Home 頂端的連線開關。首次建立連線時，系統會要求新增 VPN 設定；請閱讀系統提示，確認目前操作的是 Shadowrocket，再依指示允許並完成裝置驗證。此授權用於讓 App 建立系統網路通道，與購買狀態及訂閱內容屬於不同事項。允許授權後回到 App，查看頂端狀態是否從 Not Connected 改變。

若剛才取消了系統提示，請先回到 App 再次啟動連線並確認授權，不要連續重複點按開關。也可在系統設定的 VPN 設定中確認授權是否已建立，實際位置會依系統介面而異。若裝置受管理或已有其他 VPN 連線，也需先確認裝置允許的設定及目前連線狀態；請勿直接刪除不熟悉的系統設定。

連線狀態不等於已驗證連線

頂端顯示連線狀態有所變化，只表示客戶端的連線流程進入相應狀態，不能證明所有目標都能連線。伺服器驗證、目標網站、規則匹配與名稱解析仍可能各自發生問題。因此開啟開關後，請先保留目前設定，不要急著新增規則，接著執行 Connectivity Test 並驗證實際連線。

若開關開啟後立即關閉，請記下當時的提示文字與發生時機：是在系統授權前、授權後，還是已連線後才中斷。這個順序有助於區分授權問題與連線參數問題。暫時不要啟用 On Demand；先完成手動連線驗證，避免自動連線影響觀察。

Step 05 / Settings

依故障發生位置檢查設定

從剛才中斷的步驟開始排查，不必重做所有設定。先保存目前設定，記下錯誤提示與重現條件；每次只調整一項，完成後重複相同測試。進入 Settings 後，可確認 Test Method、On Demand 與 Diagnostics 等項目，但這些設定無法取代正確的伺服器參數，也不應一次調整所有開關。

訂閱匯入失敗或沒有顯示項目

回到 Add Server，確認 Type 是否為 Subscribe、URL 是否完整，以及是否包含空格、換行或遺漏參數。接著確認目前網路能否取得訂閱內容，並核對服務供應商提供的資料是否仍有效。訂閱網址與其中伺服器的連線位址是不同項目：更新訂閱失敗，不代表所有已儲存的伺服器都無法使用；已有項目能連線，也不能證明更新網址一定可連線。

開關關閉或連線逾時

開關關閉時，先檢查系統 VPN 授權與目前 VPN 狀態；連線逾時時，先確認裝置的基本網路正常，再逐項核對 Type、Host、Port 和驗證欄位。若項目啟用了 TLS 或特定傳輸方式，也應對照原始資料檢查相關欄位，不能只確認密碼。系統日期與時間應準確，以免時間差影響憑證或驗證判斷。

在 Settings 檢查 Test Method，確認目前採用的測試方式，再比較測試結果。若某種測試失敗但實際要求成功，應先分析測試目標與方法，不要只根據單一結果刪除資料。需要更多線索時，進入 Diagnostics，檢查剛才重現問題時的診斷資訊；若只有一台伺服器失敗，再檢查該項目的資料與伺服器端狀態。

已連線，但無法正常瀏覽或分流不符預期

先回到 Home 確認 Global Routing，避免停在 Direct 卻期待要求經由代理。使用 Config 時，檢查目前啟用的檔案、規則順序及 FINAL 的策略，再參考 Data 中的記錄定位。只有特定目標失敗時，記下目標位址與發生時間；所有目標都失敗時，優先檢查基本網路與伺服器連線，不要先大量新增網域規則。

若手動開關的行為與預期不符，請檢查 On Demand 是否已啟用，以及是否設有自動連線條件。初次排查時可先改用手動連線，確認結果穩定後再視需要設定 On Demand。不要為了排錯同時調整 Proxy、TCP、UDP 等多個項目；各項設定影響範圍不同，變更越多，越難判斷原因。

保留資訊，再進一步排查

需要向現有服務供應商確認時，提供協定類型、錯誤現象、測試時間及已完成的檢查即可。分享截圖或診斷內容前，請遮蔽訂閱連結、密碼、驗證識別資訊及其他連線憑證。詳細協定參數請參閱協定參考；若要重新確認連線流程，可從新增與匯入返回，但請保留已確認無誤的部分，不必反覆重建所有項目。