官方手冊 / Home → Global Routing → Connectivity Test

Shadowrocket 使用教學

匯入訂閱、選擇模式並首次連線。依照以下五個步驟完成基本確認,再處理規則或網路差異。

保留原有參數,先確認一項連線可正常運作。操作期間不要同時更換伺服器、模式與 Config,否則難以判斷是哪項變更影響結果。

01 / Add Server · Subscribe

新增伺服器與匯入訂閱

先確認手上的資料是訂閱連結,還是個別伺服器參數;兩種方式擇一即可,不必重複新增。

透過 Subscribe 匯入

開啟 Shadowrocket,進入 Home,點選 Add Server。在新增頁面先點選 Type,選擇 Subscribe,再返回填寫頁面。將向服務供應商取得的完整訂閱連結貼到 URL 欄位,確認開頭、結尾及查詢參數完整無誤後儲存。請勿將服務供應商的說明頁網址誤填為訂閱連結,也不要在複製時一併貼上說明文字、引號或換行。

儲存後返回 Home,等待訂閱內容載入完成。看到訂閱群組及其中的伺服器項目,才表示清單內容已匯入用戶端;只有群組名稱,還不足以確認匯入完整。展開對應群組,確認其中有可選取的項目,再選取一項作為本次測試對象。初次確認時,保留一個明確的來源即可,避免重複匯入相同連結後難以辨識。

如果清單是空的,先確認裝置原本可以連上網路,再檢查連結是否完整且仍有效。更新訂閱只會重新取得來源中的內容,不會替你補上已失效的服務權限。如需確認連結狀態,請向服務供應商查詢;不要反覆新增相同訂閱嘗試修復。

透過 Add Server 手動填寫

如果手上的是 Host、Port、驗證資訊等個別參數,請在 Home 點選 Add Server,先將 Type 設為資料中明確標示的協定,再逐項填寫。Host 填伺服器網域或位址,Port 填連線埠;是否顯示 Password、Method 等欄位,取決於所選的 Type。官方截圖僅展示其中一種欄位組合,不代表所有協定都使用相同的驗證方式。

請逐項對照原始資料,尤其留意驗證值的大小寫、連接埠數字,以及複製時可能帶入的前後空格。TLS、傳輸方式或其他附加欄位,請依現有資料填寫,不要只憑協定名稱猜測。欄位意義不明時,請先查閱術語表;想了解協定參數之間的關係,可接著閱讀協定手冊。本頁只說明首次連線所需的確認事項。

如果已有對應的 QR Code,可在 Add Server 使用 Scan QR Code;Import from Cloud JSON 則適用於相應格式的資料,不是通用的訂閱輸入欄位。儲存後返回 Home,確認新項目已新增並選取。此時只完成資料輸入,尚未建立連線;下一步請選擇 Global Routing。

Shadowrocket Add Server 官方截圖,顯示 Type、Host、Port、Password、Method 及匯入入口
Add Server:先選擇 Type,再依現有資料填寫欄位。不同 Type 的必填項目可能不同。

02 / Global Routing · Config

選擇 Global Routing

模式會決定連線的處理方式。清單中選取了伺服器,不代表所有請求都會使用它。

了解三種模式

在 Home 點選 Global Routing,依本次操作目的選擇 Config、Proxy 或 Direct。Config 會依目前啟用的設定檔判斷連線策略,適合已有明確分流規則時使用;Proxy 會讓通常由此模式接管的連線經由代理路徑,可用來排除規則因素;Direct 則直接連線至目標,不適合用來判斷代理伺服器是否正常運作。

首次測試伺服器時,如果尚未確認 Config 內容,可暫時選擇 Proxy,先測試伺服器路徑;完成後再依實際需求切回 Config。這只是縮小排查範圍的方法,不表示 Proxy 適合所有日常使用情境。測試前後請記下原本的選項,以免忘記還原,誤以為規則失效。

使用 Config 前先確認檔案

準備使用 Config 時,請進入 Config,先確認目前啟用的是哪個檔案,再開啟該檔案查看內容。訂閱通常提供伺服器清單,Config 則管理規則等設定;訂閱更新成功,不代表目前的 Config 已被取代,也不代表某個遠端設定已啟用。檔案出現在清單中,與檔案正在生效,是兩件需要分別確認的事。

官方截圖展示 Config 編輯頁面中的 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 等區段。初次使用時,請優先查看 Rule;建立一般連線不需要逐一修改其他區段。開啟檔案查看內容,不代表目前使用的檔案會自動切換;編輯後也應返回清單,確認儲存結果及啟用狀態。

Rule 中的規則通常由上而下比對,第一個符合的項目會決定策略;若前面的規則都未符合,則由 FINAL 作為預設處理。PROXY、DIRECT、REJECT 是策略關鍵字,與 Global Routing 中的 Proxy、Direct 並非同一層設定。前者代表規則結果,後者代表整體模式;大小寫及使用位置都應依介面與設定原文區分。

確認模式後返回 Home。想了解三種模式與規則如何搭配,請參閱代理模式說明;只想查詢某個關鍵字,查看術語表即可,首次連線不必先了解所有設定細節。

Shadowrocket Config 官方截圖,顯示 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 及 Add Rule
Config:區段編輯與 Global Routing 屬於不同層級。使用規則前,請先確認目前啟用的檔案。

03 / Home · VPN

開啟連線開關並完成授權

連線前依序確認伺服器、模式及裝置原始網路,再處理系統顯示的 VPN 設定提示。

在 Home 啟動連線

返回 Home,先確認 SERVER 群組中選取的項目,再查看 Global Routing 是否仍為剛才選定的模式。確認 Wi-Fi 或行動網路本身可正常使用後,開啟頁面頂端的連線開關。官方截圖中的 Not Connected 是未連線狀態示例;實際操作時請觀察開關與狀態文字的變化,不要把截圖中的文字當成已成功連線的提示。

首次建立連線時,系統可能會要求允許新增 VPN 設定。閱讀提示,確認這是剛才在 Shadowrocket 中主動發起的操作,再繼續並依裝置要求完成驗證。此步驟允許用戶端透過系統網路延伸功能處理連線,不會產生伺服器資訊,也不能取代上一節的訂閱匯入。

完成系統確認後返回 Home,等待狀態穩定。如果先前取消授權,開關可能會回到關閉狀態;可再次主動啟動連線並處理系統提示。如果裝置受管理而無法新增 VPN 設定,請先確認裝置管理限制,不要將無法授權誤判為伺服器參數錯誤。

連線後先維持設定不變

開關開啟並顯示已連線狀態,只能表示本機連線流程已進行到相應階段,不能單憑此狀態證明所選伺服器可連線至每個目標。先維持目前的伺服器與 Global Routing 設定不變,依下一節進行測試;不要看到狀態變化就接連切換多個項目,否則後續記錄難以對應相同條件。

如果系統中還有其他正在運作的 VPN 設定,請先確認目前實際生效的是哪一項;必要時先停止其他連線再測試。首次手動確認期間,也請留意 On Demand 是否會依既有條件重新啟動連線。暫時調整前先記下原設定,完成後再還原。

iPad 的操作順序與 iPhone 相同,部分頁面的顯示寬度可能不同。無論使用哪種裝置,都請以實際看到的 Home、Global Routing 及系統授權提示為準。測試結束時,返回 Home 關閉連線開關,並確認狀態已更新。

Shadowrocket Home 官方截圖,顯示 Not Connected 開關、Global Routing、Connectivity Test、SERVER 及 Add Server
Home:先選取伺服器與 Global Routing,再操作頂端開關;連線後繼續確認實際連線情形。

04 / Connectivity Test

確認連線與規則是否生效

分別確認「測試有結果」、「目標可連線」及「分流符合預期」,不要只看單一狀態。

先測試伺服器,再連線至目標

在 Home 使用 Connectivity Test,查看目前所選項目的測試結果。不清楚測試採用的方式時,先到 Settings 確認 Test Method。不同測試方法檢查的對象與路徑可能不同,因此某次測試有結果,不代表所有網頁、App 或 UDP 連線都可正常使用;同樣地,單次逾時也應搭配實際連線情形判斷。

接著開啟原本需要使用的網頁或 App,執行一次簡單且可重複的操作,例如重新載入同一個頁面。盡量發出新的請求,避免將先前已快取的內容當成本次連線成功。記下測試時使用的網路、伺服器及模式;若後續遇到問題,就能在相同條件下重現,而不必憑印象比較。

在 Config 模式下檢查策略

使用 Config 時,目標可正常連線還不夠,還需要確認流量是否採用預期策略。查看可用的連線記錄,尋找剛才連線目標的網域或位址,再確認命中的規則與處理策略。預期經由代理的連線若顯示 DIRECT,請先檢查規則順序、目前的 Config 及 FINAL,不要立刻修改伺服器驗證資訊。

如果較寬泛的規則排在前面,後方更具體的規則可能沒有機會比對。長時間保持的連線,在修改規則後也可能需要重新送出請求,才能觀察到變化。請先確認記錄對應的是新請求,再判斷變更是否生效;不要只因舊頁面仍然開啟就下結論。

取得可重現的測試結果

  1. 確認 Home 開關與狀態符合預期,且所選伺服器未變更。
  2. 搭配 Test Method 解讀 Connectivity Test,不要只比較單一數值。
  3. 連線至實際目標;使用 Config 時,再確認該請求採用的策略與規則。

完成這三項確認後,才算建立了可供檢查的基本連線。Data 中的流量變化可作為輔助資訊,但背景請求也會產生流量,不能以統計數字增加取代對特定目標的確認。如果只有一個 App 無法使用,其他目標都正常,請優先檢查該目標的規則與連線記錄。

如果剛才為了測試而使用 Proxy,現在可切回預期的 Config,重新送出相同目標的請求,再檢查一次。切回後也符合預期,才表示日常使用設定已確認完成。更多規則說明請參閱協定手冊及術語表;接著請處理尚未通過的環節。

05 / Settings · Diagnostics

依失敗環節逐步排查

從最先失敗的步驟開始,每次只變更一項設定。先記錄狀況,再調整選項。

匯入內容為空或連線立即失敗

匯入訂閱後內容為空,請回到第一步檢查連結及更新結果,確認裝置原始網路正常,並向服務供應商確認訂閱狀態。伺服器清單已出現但連線失敗時,請逐項核對 Type、Host、Port 及驗證欄位;若使用網域名稱,也請留意是否有網域解析失敗的記錄。匯入成功與伺服器可用是兩項不同的判斷,請分開處理。

開關無法維持開啟時,先確認系統 VPN 授權是否完成、裝置是否有限制,或是否受到其他連線設定干擾。如果本機連線狀態正常,但 Connectivity Test 與實際連線都失敗,再檢查伺服器參數及網路狀況。先中斷連線以確認原始網路,再重新連線測試,有助於判斷問題是否只出現在代理路徑。

測試通過,但目標仍無法開啟

前往 Settings 確認 Test Method,釐清測試結果實際代表什麼。測試方法不一定涵蓋目標使用的傳輸方式;網頁無法載入、App 登入失敗或部分功能異常,可能涉及不同請求。請固定一個目標和伺服器進行測試,不要為了取得特定測試數值而同時修改 TCP、UDP 等多項設定。

記下原本的模式後,可短暫比較 Proxy 與 Config。如果同一個目標在 Proxy 下正常、在 Config 下失敗,請優先檢查目前的 Config、命中規則及策略;如果兩種模式都失敗,再檢查參數、伺服器狀態及目前網路。測試結束後,請還原原本需要的模式;Direct 的結果也不能取代代理路徑測試。

檢查 On Demand 與 Diagnostics

Settings 中的 On Demand 可能依既有條件啟動連線。如果手動關閉後又再次連線,請先檢查此處是否設有相應條件,再判斷是否異常。初次排查時,可先記下相關條件並暫時停用,讓手動開關的結果更容易觀察;確認完成後,依實際需要還原,不要長期保留測試期間的臨時設定。

需要更多資訊時,請進入 Diagnostics,記錄出錯環節及可用的診斷資料。有效的問題描述應包含「匯入是否成功、開關是否開啟、Global Routing 選了哪個模式、哪些目標無法連線、切換網路後是否仍可重現」,而不只是「連不上」。記下時間後再重現一次,有助於從大量記錄中找到相關請求。

仍無法判斷時,請依具體狀況前往疑難排解繼續檢查;不清楚欄位含義時,請參閱術語表。本頁至此完成首次連線的基本流程:資料已匯入 Home、模式已確認、系統授權已完成、實際請求已經測試,並能指出問題發生在哪個步驟。

Shadowrocket Settings 官方截圖,顯示 Language、Test Method、Today Widget、On Demand、Diagnostics、Proxy、TCP 及 UDP
Settings:先確認 Test Method 與 On Demand,再用 Diagnostics 協助定位問題;不要一次修改多項參數。

延伸閱讀

依問題繼續閱讀

基本連線完成後,先保留一份可還原的 Config,再逐項調整日常設定。

下載 Shadowrocket