Connectivity Test
觀察目前測試方式的可連線狀況，不要由單一結果推論所有請求都可用。
OFFICIAL MANUAL / GETTING STARTED
Shadowrocket 使用教學
匯入設定與初次連線
依新增、模式、連線、驗證、排錯的順序操作。先讓一份現有設定完成實際請求，再逐步調整規則與設定。
STEP 01 / ADD SERVER
新增伺服器或匯入現有訂閱
先確認資料屬於單一伺服器參數還是訂閱連結。兩者使用不同入口，不可將完整訂閱連結填入 Host。
手動填寫：Home → Add Server
在 Home 的 SERVER 分組中找到 Add Server，進入伺服器編輯頁面。先點選 Type，選擇與現有資料相符的協定，再填寫 Host、Port 及對應的認證欄位。Type 會決定後續顯示哪些輸入欄位，因此應先選協定再核對參數；不要先填完所有資料，最後才切換 Type。
以 Shadowsocks 為例，Host 填入伺服器網域名稱或 IP，Port 填入連接埠號碼，Password 和 Method 分別對應現有資料中的密碼與加密方式。Host 不是網頁網址，不應附上網頁路徑；Port 也不要連同冒號一起貼上。若資料使用 Trojan、VMess、VLESS 或其他協定，請切換至相應的 Type，再依欄位填寫，不可照搬 Shadowsocks 的欄位組合。
填寫完成後，逐項檢查前後空格、大小寫與數字，再儲存並返回 Home。看到新項目只代表資料已儲存，並不能證明伺服器可連線。請先確認項目的協定、位址與連接埠，再選取準備使用的項目。若不清楚協定欄位的意義，可先查閱術語手冊；不確定的值請向自己的服務供應商確認，不要憑經驗填寫。
批次匯入：Subscribe 與現有連結
已有訂閱連結時，請在 Config 頁面尋找 Subscribe 入口，貼上完整連結並確認匯入；不同介面配置下，入口位置可能略有不同，請以 App 內實際標籤為準。保留連結原有的路徑與查詢參數，不要刪除看似多餘的字元。訂閱連結可能包含認證資料，請只貼入對應欄位，不要張貼於公開留言或截圖中。
匯入後請等候請求完成，再返回 Home 檢查 SERVER 分組是否出現預期項目。若列表空白，先查看是否有匯入或網路錯誤，不要連續建立多筆相同訂閱。匯入訂閱是為了取得伺服器列表；Config 設定檔則可能也包含 Rule 等內容。列表已出現不代表分流規則也已設定完成，下一步仍須另外確認 Global Routing。
若現有資料是伺服器 QR Code，可使用 Scan QR Code 掃描並確認辨識結果；剪貼簿中受支援的連結則依 App 提示匯入。Import from Cloud JSON 是另一個匯入入口，只有資料格式符合該入口要求時才使用。不必操作所有入口，選擇符合手邊資料的一種即可。
STEP 02 / GLOBAL ROUTING
選擇 Global Routing 三種模式
返回 Home，開啟 Global Routing。這裡決定請求採用哪種處理方式，不是伺服器協定選擇器。
在 Global Routing 中選擇設定(Config)、代理(Proxy)或直連(Direct)，確認後返回 Home，核對目前顯示的選項。初次使用時，請先明確訂定驗證目標：需要依規則區分請求時，使用 Config；想暫時確認所選代理伺服器能否處理請求時，可用 Proxy 作為對照；只檢查本機網路的基本連線時，可用 Direct。三種模式不是要逐一開啟的開關，只需選擇目前需要的一種。
| 模式 | 處理依據 | 使用前檢查 |
|---|---|---|
| 設定(Config) | 依目前設定的規則與策略處理請求 | 設定檔是否已選取，策略引用是否有效 |
| 代理(Proxy) | 以代理方式處理請求，方便檢查所選伺服器 | 目前伺服器是否正確，實際請求是否成功 |
| 直連(Direct) | 以直連方式處理請求 | 本機網路本身是否可用 |
使用 Config 前確認 Rule
進入 Config，確認準備使用的設定檔，再開啟其編輯內容。官方截圖中的 General、Rule、Hosts、URL Rewrite 與 HTTPS Decryption 是設定檔的不同區段；初次使用只需先查看 Rule，不必為了完成連線而逐一修改其他區段。截圖顯示的是設定檔編輯頁面，不是 Home 中的 Global Routing 選擇頁；兩者名稱相關，但用途不同。
在 Rule 中檢查規則順序與目標策略。規則通常依序比對，前面的規則命中後，後續規則不一定會繼續處理該請求。DOMAIN-SUFFIX 用於比對網域後綴，GEOIP 用於依 IP 地理資訊比對，FINAL 則在前面的規則都未命中時作為最後處理方式。不要為了測試任意刪除 FINAL，也不要直接將不明的策略名稱複製到設定中。
例如 DOMAIN-SUFFIX,example.com,PROXY 是規則語法範例，不是可直接用來連線的伺服器資料。實際使用前，必須確認 PROXY 對應到目前設定中的有效策略或選項；規則中的文字不會自動建立伺服器。若不熟悉規則語法，請先保留現有設定；詳細比對邏輯請參閱Global Routing 與分流規則說明。
本步驟結束時，應能在 Home 清楚確認目前的 Global Routing。若剛才使用 Proxy 作為臨時對照，驗證後請依原計畫切回 Config，並重新確認實際請求；不要忘了測試目的，將對照用的模式長期留作預設。
STEP 03 / CONNECT
開啟 Home 頂端開關
先確認伺服器與模式，再開啟連線。初次使用還須完成系統授權；停留在系統提示視窗不代表已建立連線。
返回 Home，確認 SERVER 中選取的項目與準備測試的伺服器相符，再確認 Global Routing 是否維持上一步選定的模式。確認無誤後，開啟頂端開關。未連線時會顯示 Not Connected；開啟後請留意頂端狀態與系統提示，等待用戶端完成連線狀態轉換。在狀態穩定前，不要反覆切換伺服器與開關。
初次操作時，系統可能會提示允許 Shadowrocket 新增 VPN 設定。請確認操作是由剛開啟的 Shadowrocket 發起，再依系統提示允許，並使用裝置要求的驗證方式完成授權。此設定用於讓系統將相關網路請求交由用戶端處理，本身不包含可用伺服器，也不能取代訂閱匯入。若拒絕或取消，本次連線可能無法繼續；請重新發起連線並完成授權。
完成授權後返回 App，查看頂端是否仍顯示連線狀態。若開關立即回到關閉狀態，先確認是否已完成授權，再確認所選項目存在且參數已儲存。此時不要反覆修改 DNS、Rule 或其他進階設定，否則即使之後成功連線，也難以判斷是哪項變更造成影響。
連線時請留意裝置上是否還有其他正在執行的 VPN 連線。需要切換時，先停止目前連線，再回到 Shadowrocket 建立本次測試連線，避免將連線被取代的現象誤判為參數錯誤。App 回到前景後，仍應重新確認狀態，不要只依賴先前出現過的系統標示。
連線狀態持續開啟，代表系統網路設定已進入運作狀態，但不能只憑這點認定所有目標都能存取，也不能確認所有請求都經由所選伺服器。接下來必須執行 Connectivity Test 並實際開啟頁面，分別驗證測試目標與實際使用情境。
STEP 04 / CONNECTIVITY TEST
驗證測試結果與實際請求
先執行測試，再開啟實際需要瀏覽的頁面，最後確認策略。每個步驟各自回答一個問題，需綜合判斷結果。
實際頁面瀏覽
重新發出需要驗證的請求，不要只憑已快取的頁面內容判斷連線成功。
Data 與請求記錄
搭配流量變化及可用記錄，確認請求已出現，並核對處理策略是否符合預期。
在 Home 點選 Connectivity Test，等待測試完成，記錄成功、逾時或其他錯誤。測試結果與 Settings 中的 Test Method 及測試目標有關，不要將單次逾時直接視為所有連線都失敗。也不要只比較結果數字大小來判斷設定是否正確；先確認測試是否完成，再查看實際請求能否收到回應。
保持連線開啟，開啟需要瀏覽的頁面或 App，重新發出一次請求。頁面完整載入、登入流程完成或 App 取得新內容，比只看到舊頁面更能反映實際存取狀況。若頁面可能來自快取，可重新整理或使用新的瀏覽工作階段再試；驗證期間不要同時更換伺服器、網路與模式，否則無法重現前後差異。
接著返回 Shadowrocket，查看 Data 中的流量變化；若目前介面提供請求記錄，請依剛才的目標網域或時間尋找對應請求。流量增加只能代表有網路活動，不能單獨證明目標經由代理；還須核對 Global Routing、命中規則及最終策略。使用 Config 時，部分請求依規則直連可能正是預期結果。
若 Proxy 模式下實際請求成功，切回 Config 後卻失敗，應優先檢查規則、策略引用及相關解析行為，不必立即重建整個伺服器項目。反之，若所有模式下本機網路基本連線都異常，請先處理裝置網路。記錄「使用哪種網路、選取哪個伺服器、目前是哪種模式、哪個請求失敗」，即可為下一步提供明確的排查起點。
STEP 05 / DIAGNOSTICS
依失敗階段逐項排查
先判斷問題發生在匯入、授權、連線還是存取階段。每次只調整一項，重新測試後再決定是否保留。
匯入後沒有項目：確認連結與回應內容
返回 Subscribe，檢查連結是否完整複製，特別留意末尾參數、換行與多餘空格。先確認裝置網路可用，再透過原入口更新一次，並查看具體錯誤。訂閱更新成功不代表列表內容可用；若回傳內容不符合入口要求，或自己的服務已失效，請向自己的服務供應商確認資料。不要將連結改成猜測的位址，也不要連續匯入相同內容來掩蓋原始錯誤。
開關無法保持開啟：先確認系統授權
返回 Home 再次開啟連線，查看是否仍有待確認的系統提示視窗。必要時進入裝置的系統設定，確認 Shadowrocket 對應的 VPN 設定是否存在，並檢查目前連線是否被其他 VPN 取代。先處理授權與連線狀態，再檢查伺服器回應；系統連線尚未建立時，修改 Rule 通常無法解決這一層的問題。
連線已開啟但請求失敗：重新確認參數
在 SERVER 中開啟目前項目的編輯頁面，核對 Type、Host、Port 與認證資料，並確認選取的不是另一筆名稱相近的記錄。若使用依賴 TLS 的協定，也需依原始資料檢查 SNI、憑證驗證及相關傳輸設定。裝置日期與時間異常也可能影響 TLS 驗證。遇到憑證錯誤時，先確認網域、時間與伺服器資料，不要將降低驗證要求當作一般修復方式。
只有部分目標失敗：比對模式與 DNS
先記下原本的 Global Routing，暫時切換至 Proxy，重新測試同一目標，再恢復原模式。若只有 Config 出現問題，優先確認 Rule 的命中順序、策略名稱及目前選取的設定檔是否正確。若網域解析異常，請檢查現有 DNS 設定，先還原最近自行修改的項目，再重新測試。DNS 只影響部分解析路徑，並非所有連線錯誤的通用解法；相關概念請參閱DNS 與網路術語。
使用 Settings 留下可重現的觀察結果
進入 Settings 查看 Test Method，確認兩次 Connectivity Test 是否使用相同測試方式。需要進一步觀察時，使用 Diagnostics 中目前可用的診斷功能，記下錯誤發生時間、錯誤文字與操作順序。On Demand 用於依條件觸發連線；初次手動驗證期間，若已設定此功能，請留意它是否自動變更連線，以免將自動行為誤認為手動操作的結果。
需要向自己的服務供應商回報時，請說明協定類型、失敗階段、網路環境及已完成的單項比對。傳送截圖或記錄前，請遮蔽訂閱連結、Password、認證參數及金鑰等敏感資料。不要為了排錯公開完整設定；通常先提供錯誤文字與重現步驟，就能縮小問題範圍。
完成排查後，恢復預定使用的 Global Routing，再進行一次實際請求驗證。確認新設定有效後，再儲存必要的設定備份，並定期透過原入口更新現有訂閱。App 更新請透過 App Store 進行；重新安裝 App 不代表伺服器與規則資料也會還原。需要有系統地排查問題時，請繼續閱讀使用手冊中的連線排查章節。
