Shadowrocket 使用教學

01 · Add Server：新增伺服器或匯入訂閱

先確認手上的資料是哪一種：可更新且包含多台伺服器的訂閱連結，或單一伺服器的位址、連接埠與驗證資料。兩者在 App 中的新增方式不同，請勿將訂閱 URL 填入伺服器位址欄位。開啟 Shadowrocket，前往 Home，點選右上角的新增按鈕，進入 Add Server。儲存前先確認 Type，這會決定接下來顯示哪些欄位。

已有訂閱：使用 Subscribe 匯入

在 Add Server 的 Type 中選擇 Subscribe，將完整訂閱連結填入 URL，再加上方便自己辨識的名稱。貼上後，檢查連結開頭、結尾及查詢參數是否完整，尤其留意從通訊軟體複製時是否帶入空格、換行或說明文字。訂閱連結通常含有存取憑據，請完整保留，但不要公開貼到討論區或截圖中。

填寫完成後儲存，等待 App 取得並解析訂閱內容，再返回 Home 查看結果。只有看到訂閱群組及其中的伺服器，才表示已取得可選取的連線項目；單純儲存訂閱名稱，不代表內容已成功取得。若群組中沒有伺服器，請先檢查訂閱回應及有效性，不要直接進入後續連線步驟。更新訂閱只會刷新連線資料，無法取代服務商提供的權限或有效期限。

已有單一伺服器：依 Type 填寫資料

若收到的是單一伺服器參數，請在 Add Server 中選擇相應協定的 Type，再逐項填入位址、連接埠與驗證資料。不同協定所需欄位各異：例如 Shadowsocks 需核對加密方式與密碼，VMess、VLESS 通常需核對 UUID，Trojan 則需核對密碼及 TLS 相關參數。欄位名稱相似不代表可以互換，也不要將一種協定的資料填入另一種協定的表單。

若服務商提供的資料還包含傳輸方式、路徑、Host 或 SNI，請依原始說明填寫。伺服器位址與 TLS 驗證所用的名稱可能不同，不要為了讓表單看起來一致而自行修改，也不要以關閉憑證驗證取代參數核對。儲存後返回 Home，確認新伺服器已出現，再選取準備使用的項目。此時僅完成資料輸入，尚未證明連線可用。

若已有分享連結或 QR Code，也可使用相應的剪貼簿匯入功能或 Scan QR Code；匯入後仍應開啟項目，核對協定與位址。掃描與匯入管理方式請參閱掃碼與匯入管理，協定概念請參閱術語手冊。確認已選取明確的伺服器後，再繼續選擇流量處理方式。

02 · Global Routing：選擇流量處理模式

在 Home 開啟 Global Routing，依目前用途選擇設定檔 (Config)、代理 (Proxy) 或直連 (Direct)。這三個選項決定如何處理請求，並非三種協定，也不是速度等級。選取伺服器不代表所有請求都會經過它；若模式與預期不同，可能出現連線開關已開啟、目標請求卻走其他路徑的情況。

設定檔 (Config)：依設定檔中的規則處理

日常需要依規則分流時，請使用設定檔 (Config)。先前往 Config，確認目前選取的是準備使用的設定檔，再返回 Global Routing 選擇 Config。這裡有兩個不同層次：Config 頁面用來管理設定檔；Global Routing 中的 Config 選項則表示依所選設定檔處理請求。匯入伺服器訂閱，不代表已匯入或啟用規則設定檔。

規則通常依序比對，最後由符合的規則決定使用 PROXY、DIRECT 或 REJECT。若請求符合 DIRECT，即使連線開關已開啟，也可能直接連線；若符合 REJECT，請求則會遭到拒絕。不要只看最後一條規則就判斷所有請求的處理方式。規則範例及關鍵字說明請參閱規則分流說明。

代理 (Proxy)：檢查所選的代理路徑

初次排查伺服器是否可用時，可暫時選擇代理 (Proxy)，讓適用的請求經由代理路徑傳送，減少規則分流對觀察結果的影響。選取後仍須在 Home 確認目標伺服器已選中。Proxy 無法修正錯誤密碼、失效伺服器或受限的傳輸條件；它只會改變流量處理方式，不能保證伺服器可用。

直連 (Direct)：直接連線

直連 (Direct) 用於直接連線，不適合用來證明代理伺服器已生效。若目前使用 Direct，目標頁面成功開啟，只能表示在當下條件下可透過直連路徑存取。若要比較本機網路與代理路徑，可將直連作為對照，但應記下每次選擇的模式，避免混淆不同條件下的測試結果。

選擇完成後返回 Home，再次確認目前的 Global Routing 設定。接下來的連線與驗證都應在已知條件下進行；若只是暫時使用 Proxy 排查，確認後請記得切回需要的 Config，並重新驗證分流結果。

03 · Home：開啟連線並完成系統授權

返回 Home 後，先選取剛才核對過的伺服器，再開啟上方的連線開關。若訂閱中有多個名稱相近的項目，請確認選取標記所在的位置，不要只看畫面上最近出現的名稱。更新訂閱後也應重新確認目前的選取項目，避免將另一台伺服器的表現誤認為剛才測試項目的結果。

首次建立連線時，系統可能會顯示新增 VPN 設定的授權提示。這是系統允許 App 建立相應網路連線的確認步驟，與購買 App 或匯入訂閱是不同操作。請閱讀提示，確認由 Shadowrocket 發起，再依系統指示完成確認或身分驗證。若尚未完成授權，返回 App 後看到開關關閉，不能直接判定為伺服器參數錯誤。

完成授權後返回 App，確認連線開關是否維持開啟。系統顯示的 VPN 狀態與 App 中的開啟狀態，可用來確認連線機制已啟動，但不能單獨證明目標服務可存取。伺服器驗證失敗、DNS 解析異常或規則比對結果不符，都可能發生在開關已開啟之後，因此仍須進行實際測試。

若開關立刻恢復關閉，先確認系統授權是否完成，以及裝置上是否有其他正在使用的 VPN 連線。不同 VPN 設定可能會爭用連線狀態，排查時應先確認目前執行的是哪一個。受管理的裝置也可能受到組織設定限制；遇到系統提示時請依提示處理，不要反覆刪除 App 來嘗試繞過裝置政策。

初次驗證期間，先維持其他設定不變，暫時不要調整 On Demand 等自動連線條件。按需觸發是後續使用習慣的設定，並非手動連線成功的必要條件。確認手動開關、伺服器選擇與模式後，再進行驗證；如此遇到問題時，才能找出從哪個環節開始不符預期。

04 · Connectivity Test：驗證測試結果與實際請求

開啟連線後，在 Home 使用 Connectivity Test 檢查伺服器。先測試目前選取的項目，再視需要比較其他項目，避免一開始批次測試後忘記實際選了哪一台。解讀測試結果時，也要考量所用的測試方式：不同方式可能涵蓋不同連線階段，因此不能將任何一個回傳數值都視為完整業務存取成功。

收到回應，表示在當時條件下，相應測試已完成指定環節；這不代表下載速度，也無法保證所有目標服務都可使用。測試逾時表示未能在等待時間內完成，但原因可能出在伺服器、本機網路或測試目標本身。單次結果可作為判斷線索，不適合用來對整條連線路徑下永久結論。測試方式與排序的詳細說明，請參閱延遲測試與伺服器整理。

接著開啟自己需要使用的網站或 App，執行容易重複的操作，例如重新整理同一個頁面。記下頁面是否能開啟、是否只有部分資源載入失敗，以及問題發生時的網路環境。不要只憑 App 中的開關或系統 VPN 標示判定成功；真正需要確認的是目標請求是否如預期完成，以及請求採用的路徑是否符合目前模式。

使用設定檔 (Config) 時，還須檢查實際請求記錄中的規則比對與處理結果。目標請求符合 DIRECT，不代表代理失效，也可能正是設定檔的預期結果；若符合 REJECT，請先核對規則的用途。懷疑問題由規則造成時，可暫時切換至代理 (Proxy)，在相同伺服器與本機網路下重複相同請求，再切回 Config 比對結果。比對期間不要同時更換伺服器及修改 DNS，否則難以解讀結果。

可將本次驗證結果簡要記錄下來：所選伺服器名稱、Global Routing 設定、本機網路、目標操作，以及成功或失敗的現象。記錄時不必包含完整訂閱 URL、密碼或 UUID。確認實際請求正常後，再逐項恢復日常設定；每恢復一項就執行一次相同驗證，才能將後續異常與特定變更對應起來。

05 · 常見故障：從問題發生的環節開始檢查

排查時先分層處理，不要一次修改所有參數。依序確認「匯入內容是否完整 → 系統是否已建立連線 → 伺服器測試是否有回應 → 實際請求是否符合規則」，找出第一個失敗環節。保留原有可用設定，每次只變更一項，再重複第四步中的相同驗證操作。以下順序適用於初次使用，也適用於更新訂閱或切換本機網路後重新檢查。

已儲存訂閱，卻沒有伺服器

返回訂閱項目，確認 Type 為 Subscribe，且 URL 是完整訂閱網址，而非服務商管理頁面的網址。檢查是否混入引號、空格或缺少查詢參數，並查看 App 顯示的取得或解析提示。瀏覽器能開啟網頁，不代表收到的內容一定是可匯入的訂閱資料；若內容為空或權限已失效，請向你的服務商確認原始連結，不要任意修改參數嘗試修復。

開關無法維持開啟

先檢查系統 VPN 設定授權與裝置管理限制，再確認其他 VPN 連線的狀態。若 App 顯示設定錯誤提示，請回頭查看最近修改的設定及具體問題。若系統連線尚未建立，批次更換伺服器通常無助於找出原因。待開關能正常開啟後，再繼續檢查伺服器驗證與傳輸參數。

Connectivity Test 逾時，實際連線也失敗

先確認裝置本身能正常使用目前的網路，再核對伺服器位址、連接埠、密碼或 UUID、TLS 與傳輸設定。輸入內容中多出一個字元，就可能導致驗證或交握失敗。請逐項比對服務商提供的原始資料，不要只看伺服器名稱。可在 Wi-Fi 與行動網路之間交叉測試；若結果只隨本機網路改變，應進一步檢查該網路的存取條件，而非立刻重寫整份設定。

測試有回應，但部分服務異常

請將「伺服器測試可連通」與「目標服務可使用」分開判斷。先確認 Global Routing，再檢查相關請求的規則結果及 DNS 狀況。若 Proxy 下正常、Config 下失敗，優先核對目前的設定檔、規則順序與策略指向；若兩種模式下都失敗，再檢查目標服務狀態、伺服器出口條件與協定參數。不要將所有局部故障都歸因於延遲過高。

更新訂閱或切換網路後發生異常

更新後先確認所選伺服器是否仍存在、參數是否有變動，以及群組中是否新增名稱相近的項目。切換網路後，請重新測試同一台伺服器，不要沿用舊網路的測試數值做判斷。暫停反覆更新與批次切換，固定一組條件觀察一次完整請求，會更容易分辨問題來自連線資料變更或本機環境變化。

完成基本連線後，可繼續閱讀節點管理手冊，了解更新訂閱、整理多個訂閱、刪除伺服器與備份等操作；遇到不熟悉的協定或規則關鍵字，請先查閱術語手冊再修改參數。本教學的完成標準是：能說明自己選取的項目、請求的處理方式，並透過一次可重複的實際存取確認結果。