OFFICIAL MANUAL / GETTING STARTED
Shadowrocket 使用指南
依序完成新增、選擇模式、連線、驗證與排錯。本指南以 iPhone / iPad 介面為例,先建立一次可供檢查的連線,再調整規則與 Settings。
截圖用於辨識介面與欄位,不代表必須逐項照抄。實際欄位會隨所選 Type 和應用程式介面而異,所有連線參數請以你已有的伺服器資料為準。
STEP 01 / ADD SERVER
新增伺服器或匯入既有訂閱
先確認取得的是訂閱連結、單一伺服器連結,還是需要逐項填寫的伺服器參數。
手動填寫:Home → Add Server
開啟 Shadowrocket,在 Home 頁面下方的 SERVER 分組找到 Add Server。進入後先點選 Type,選擇服務商資料中載明的協定,再填寫其他欄位。Type 會決定後續表單內容,因此不要先填完密碼再任意更換協定,也不要只憑連接埠號碼推測協定。
以截圖中的欄位為例,Host 填入伺服器網域或 IP 位址,Port 填入伺服器連接埠,Password 填入對應密碼,Method 依提供的加密方式選擇。Host 不是網頁網址列,不要將含有路徑的訂閱連結填入其中。其他 Type 可能顯示不同的驗證或傳輸欄位,請逐項核對,不要將某種協定的驗證資訊用於另一種協定。
填寫完成後儲存,返回 Home,確認 SERVER 下方出現剛新增的項目。項目存在只表示資料已儲存,不代表伺服器可用。先確認顯示的名稱和位址符合預期,稍後再透過 Connectivity Test 和實際瀏覽進行驗證;若輸入時多了空格或換行,請先返回編輯頁修正。
批次匯入:Subscribe
若已有訂閱連結,請進入 Config 頁面尋找 Subscribe 入口,依照介面提示貼上完整連結並儲存或更新。訂閱連結用於取得一組伺服器資訊,單一伺服器連結則只描述一個連線,兩者用途不同。匯入後返回 Home 查看伺服器清單,確認項目已出現,再選擇這次要使用的伺服器。
訂閱網址通常帶有身分參數,請完整複製,但不要在公開截圖或求助內容中顯示。匯入失敗時,先確認剪貼簿中只有連結本身,沒有前後說明、引號或換行;再確認服務商是否要求先在其帳戶頁面啟用訂閱。更新不會自動修復帳戶狀態,也不會變更服務商端的伺服器參數。
若已有 QR Code,可在 Add Server 頁面使用 Scan QR Code,授權相機後掃描自己已有的資料。Import from Cloud JSON 適用於相應的 JSON 資料來源,不是通用的訂閱輸入欄位。不要將任意網頁網址反覆輸入不同入口;若不確定格式,請先核對資料說明,再參考訂閱匯入的四種入口。
完成這一段後,Home 應已有可選擇的伺服器。下一步先決定流量如何處理,不必立刻修改 DNS 或其他進階設定;新增成功和選對 Global Routing 是兩件不同的事。
STEP 02 / GLOBAL ROUTING
選擇 Global Routing 模式
伺服器決定連線使用哪份資料,Global Routing 則決定請求的處理方式。
返回 Home,點選 Global Routing,依目前需求選擇設定檔(Config)、代理(Proxy)或直連(Direct)。這三種模式不是連線品質等級,也不代表不同協定。首次使用時請先確認選項,再開啟連線;否則即使伺服器資料正確,也可能因目前模式與預期不同而誤判結果。
日常分流:設定檔(Config)
設定檔(Config)會依照目前啟用設定檔中的規則處理請求。需要代理的目標應命中相應策略,需要本機直接連線的目標則可命中 DIRECT。進入 Config,確認實際選取的設定檔;若開啟設定檔編輯頁,會看到 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 等區段。這裡顯示的是設定檔內容,不是伺服器訂閱清單。
這一步只需確認設定檔已啟用,並了解 Rule 負責規則比對。規則通常依由上而下的順序判斷,先命中者先執行,FINAL 負責處理先前都未命中的請求。不要為了完成首次連線就同時啟用 URL Rewrite 或 HTTPS Decryption,也不要把 Add Rule 當成新增伺服器的入口。關鍵字說明請參閱術語表,具體設定請查閱選項手冊。
暫時比較:代理(Proxy)與直連(Direct)
代理(Proxy)適合用來暫時檢查代理路徑是否能完成連線,但不應理解為每個應用程式、每種系統流量都會以相同方式處理。直連(Direct)可用來檢查本機網路連線情況,也不能據此驗證代理伺服器是否正常。這兩種模式主要用來確認目前的測試路徑,排錯時不建議連續切換後忘記恢復。
例如,某個目標在代理(Proxy)下可以瀏覽,在設定檔(Config)下卻失敗,應優先檢查該目標命中的規則與策略,而不是立刻重建伺服器。比較結束後恢復設定檔(Config),再次確認使用的是預期設定檔。接著返回 Home,保留剛選好的伺服器和模式,準備開啟頂端的連線開關。
STEP 03 / CONNECT
開啟連線並確認 VPN 權限
先選擇伺服器,再開啟頂端開關;通過系統權限確認後,還要檢查應用程式中的實際狀態。
在 Home 的 SERVER 分組點選要使用的伺服器,確認選取標記位於正確項目上。若有多個訂閱分組,請特別留意同名項目來自哪個分組。接著確認 Global Routing 仍是剛才選擇的模式,再開啟頂端位於 Not Connected 區域的連線開關。
首次連線時,iPhone / iPad 可能會顯示新增 VPN 設定的系統提示。確認這是剛才在 Shadowrocket 中主動發起的操作後,點選允許,並依照系統要求完成裝置驗證。這個步驟是讓系統建立應用程式使用的 VPN 設定,不會替你填寫伺服器資料,也不代表服務商提供的資料已驗證成功。
完成授權後返回 Home,等待狀態變更。若開關立即返回關閉,請勿快速重複點選。先確認是否仍有系統提示等待處理,再檢查系統設定中的 VPN 設定狀態。若之前誤按拒絕,可返回應用程式重新發起連線;若系統設定已刪除,也需要重新完成授權。詳細提示說明請參閱VPN 設定提示說明。
若裝置上另有正在使用的 VPN 連線,請先確認目前由哪個項目接管網路,避免將其他連線狀態誤認為 Shadowrocket 的結果。受管理的裝置也可能受到組織設定的限制,請遵循裝置管理要求,不要為了連線而刪除用途不明的管理設定。
頂端顯示連線狀態變更後,先不要修改目前設定。系統狀態列中的 VPN 標示只表示通道狀態,無法單獨證明目標網頁瀏覽成功。下一步需要一併檢查伺服器測試、實際請求和規則命中結果。
STEP 04 / CONNECTIVITY TEST
確認連線是否確實生效
測試結果、目標瀏覽與規則記錄分別回答不同問題,請分開判斷。
先測試伺服器,再瀏覽實際目標
在 Home 使用 Connectivity Test,觀察目前伺服器能否完成所選測試。測試逾時可作為進一步排查的線索,但測試成功不代表所有目標都能瀏覽:測試方式、測試目標和實際服務請求可能不同。不要只根據單一測試數值判斷服務商狀態,也不要在尚未確認測試方式前比較不同項目的結果。
保持連線,開啟瀏覽器瀏覽平常可確認內容是否正常的頁面,再瀏覽這次需要使用的目標。請盡量發出新的請求,不要只查看已載入的頁面或快取內容。若瀏覽器仍顯示舊結果,可重新載入頁面;必要時關閉該頁面後再開啟。不要同時切換模式、更換伺服器和切換 Wi-Fi,否則很難判斷是哪項改動影響結果。
在設定檔(Config)下核對命中策略
返回 Shadowrocket,查看 Data 或目前介面提供的連線記錄,找到剛才發出的目標請求,核對目標網域、命中規則及最終策略。預期使用代理卻命中 DIRECT 時,請優先檢查設定檔與規則順序;預期直連卻經由代理時,也應從目標比對條件著手,而不是刪除所有規則。
可以進行一次有控制的比較:記下目前模式和伺服器,只暫時更換 Global Routing,再重新請求相同目標。若差異穩定重現,就有了排查方向;測試後恢復原本的設定檔(Config)。網頁顯示的出口位址只能反映該次請求的路徑,無法證明裝置上的所有流量都採用相同策略。
這個階段的完成標準是:連線可以維持、目標可以正常開啟、記錄中的處理策略符合預期。確認三項都正常後,再考慮自動連線或更細緻的規則。若只有其中一項異常,請保留目前狀態進入下一步,不必重新安裝應用程式或清除所有資料。
STEP 05 / SETTINGS & DIAGNOSTICS
依失敗情況逐項排查
先檢查輸入內容與基本網路,再檢查權限、DNS 和規則;不要同時變更所有 Settings。
匯入失敗或測試逾時
匯入後沒有新增項目,請返回第一步檢查連結類型、完整性與更新結果。更新成功但伺服器測試逾時,請先中斷連線並檢查本機網路是否正常,再核對目前選取的伺服器。訂閱中出現項目,只表示取得了資料,不代表該項目對應的服務目前一定可用。
逐項檢查 Type、Host、Port、Password、Method,以及該協定需要的其他驗證和傳輸參數。留意大小寫、前後空格和複製遺漏;系統時間也應維持正確,以免影響需要時間驗證的連線。若仍有問題,請向你的服務商確認既有資料和服務狀態。完整排查順序請參閱伺服器逾時與連線失敗排查。
測試正常,但網頁無法開啟
先確認是所有網頁都失敗,還是只有特定目標失敗。若只有部分目標失敗,請在 Data 或連線記錄中查看其網域和命中策略;若已建立連線但發生解析失敗,再檢查 DNS 相關設定。不要因為伺服器測試正常就排除 DNS,也不要把任意 DNS 位址逐一替換當成固定解法。
進入 Settings,可看到 Test Method、On Demand、Diagnostics、Proxy、TCP、UDP 等設定分組。Test Method 會影響測試方式,Diagnostics 用於收集排查線索;兩者都不是用來替代伺服器參數的開關。DNS 的具體位置和欄位請以目前介面為準,初次排查應記錄原始值,只針對已觀察到的問題調整。詳情請參閱DNS 與網頁載入失敗說明。
連線後中斷,或關閉後再次連線
若開啟開關後立即關閉,請優先檢查第三步中的 VPN 權限、系統提示與目前連線記錄。若手動關閉後又自動連線,請檢查是否已設定 On Demand。排錯期間可先記錄原有條件,暫時停用自動觸發,再手動重現問題;確認原因後再決定是否恢復,避免自動連線影響測試過程。
Today Widget 用於快速操作或查看相關狀態,不是首次連線的必要條件。Proxy、TCP、UDP 等分組涉及更細部的連線行為,本指南不建議預先修改。若要了解欄位意義、預設行為與設定依據,請繼續閱讀Settings 選項手冊,不要照搬與目前協定無關的設定組合。
需要儲存診斷資訊時,只保留足以說明問題的部分,遮蔽訂閱網址、密碼和其他驗證資料。描述問題時,請包含失敗發生的步驟、是否所有目標都受影響、切換網路後是否能重現,以及最近只變更過哪項設定。這類記錄比重複匯入、反覆開關更容易協助定位問題。