Shadowrocket 快速上手
新增既有設定 → 選擇路由模式 → 開啟連線 → 驗證結果 → 排查問題。
首次設定時,先完成一條可驗證的連線,不必一次調整所有選項。先辨別手上的資料是單一伺服器資訊還是訂閱連結:前者列出連線所需的位址、連接埠和認證資料;後者則用來取得伺服器清單。設定檔主要決定請求如何分流,這三類資料不要混填在同一個欄位。每完成一步就返回 Home 確認結果,再進行下一步。
01 · Add Server / Subscribe:新增既有資料
先依資料類型選擇入口,儲存後確認 Home 中已出現伺服器。開啟 Home,在 SERVER 分組附近點選 Add Server,進入伺服器編輯頁面。若手上是完整的伺服器資料,先選擇 Type,再填寫相應欄位;若是訂閱連結,則在 Type 中選擇 Subscribe,輸入完整網址後儲存。不要把訂閱網址當成單一伺服器的 Host。
手動輸入時,Type 必須與既有資料中的協定相符。Shadowsocks、VMess、VLESS、Trojan 等協定所需的認證欄位各不相同,不能只因伺服器位址相同就互換類型。截圖顯示的編輯頁面包含 Type、Host、Port、Password、Method;切換 Type 後欄位可能有所不同,請依目前協定的資料逐項填寫。
Host 是伺服器位址,Port 是連接埠。認證資料必須完整保留,複製時請檢查前後空格與換行。Method 等參數應與既有伺服器設定一致,不要隨意選擇來測試連線。TLS、伺服器名稱或傳輸設定也請以既有資料為準;不清楚欄位意義時,可先查閱概念速查,再回到此步驟繼續。
若已有 QR Code,可使用 Scan QR Code 匯入,並確認辨識後的欄位。Import from Cloud JSON 是另一種資料匯入入口,與 Subscribe 不同;只有手上已有相應格式的資料時才使用。無論選擇哪種方式,儲存前都應確認伺服器類型、位址與認證欄位,不要只憑熟悉的名稱判斷。
儲存訂閱後,確認清單內容,不要只看名稱
匯入 Subscribe 時,請複製完整訂閱連結,包括網址結尾的查詢參數。部分連結包含用來識別帳戶的資訊,刪除參數可能導致回傳內容不同或無法取得。本文不會展示實際訂閱網址;操作時請使用自己的連結,並避免將它放進公開截圖、聊天記錄或問題描述。儲存後等候 App 取得內容,再返回 Home 確認伺服器項目是否出現。
若只看到訂閱分組,沒有可選的伺服器,先檢查取得或更新結果,不要立即開啟連線。確認網址仍有效、複製完整,且目前網路可以連線;需要更新時,使用該訂閱的更新功能。更新後也要再次檢查清單,因為伺服器名稱、順序或內容可能有所變動。接著在 SERVER 清單中選取要使用的伺服器,確認選取標記,不要預設第一個項目就是目前使用的伺服器。
完成此步驟後,應能明確確認兩件事:清單中是否已有可用的伺服器資料,以及目前選取的是哪一個。成功取得訂閱只代表清單內容已匯入,不代表其中每一條連線都可用。確認這兩點後再設定路由模式,避免將匯入問題誤判為規則問題。
02 · Global Routing:選擇請求處理方式
先確認模式,再判斷是否需要檢查規則。返回 Home,點選 Global Routing 查看目前選項。三種模式分別是 Config、Proxy 和 Direct。這項設定控制請求的處理方式,不會替你填入伺服器位址,也不會變更既有服務的認證資料。
Config 依目前設定檔中的規則處理請求。若要讓不同目標採用不同策略,請先確認已選取正確的設定檔,再使用此模式。Proxy 適合暫時檢查請求經目前代理處理的情況,但不能取代對設定規則的驗證。Direct 用於直接連線;選取後,不應預期請求會以代理模式處理。
準備使用 Config 時,點選底部的 Config,找到目前使用的設定檔。進入檔案編輯頁面檢查 Rule;官方截圖也顯示 General、Hosts、URL Rewrite 與 HTTPS Decryption 等入口。初次使用只要確認目前使用的檔案及規則是否符合預期,不必為了完成連線而修改所有區段。
規則會依順序比對,第一條符合的規則會決定策略。DOMAIN 與 DOMAIN-SUFFIX 的比對範圍不同,FINAL 通常放在最後作為預設規則。PROXY、DIRECT、REJECT 是規則策略關鍵字;PROXY 與 Global Routing 中的 Proxy 屬於不同層級的設定。看到相似名稱時,先確認自己是在編輯規則,還是在切換全域模式。
用一小段規則了解 Config
以下是語法範例,不是要你用它取代現有完整設定。第一條規則讓 example.com 及其子網域符合 PROXY;第二條則讓其他未符合規則的請求使用 DIRECT。範例網域僅用於說明寫法,不能據此判斷實際目標的連線結果,也不包含任何伺服器認證資料。
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT
若將預設規則放在前面,後續規則可能就沒有機會比對。檢查實際設定時,除了規則內容,也要確認它在清單中的位置。首次驗證可先保留既有設定,並記下 Global Routing 的選項;若出現「連線已建立,但特定目標的連線方式不符預期」,再回到這一層檢查。複雜規則、策略與設定區段的詳細說明,請參閱規則與設定欄位參考;本教學只說明基本模式確認。
完成此步驟後,應知道目前使用的是 Config、Proxy 還是 Direct;若使用 Config,也要知道目前檔案的名稱。返回 Home 後再次查看 Global Routing 顯示的模式,確認選擇已生效,再進行連線。
03 · Home:授權並開啟連線
連線前,請同時確認伺服器選擇與 Global Routing 模式。返回 Home,確認 SERVER 清單中已選取預期的伺服器,且 Global Routing 顯示剛才選定的模式。頂端的 Not Connected 表示目前尚未建立 App 連線;點選旁邊的開關,開始連線流程。
首次連線時,系統可能會要求允許新增 VPN 設定。確認提示來自目前操作的 Shadowrocket 後,依系統提示允許,並完成裝置要求的身分驗證。此授權用於在系統中建立連線所需的設定,不代表訂閱已成功取得,也不能證明伺服器已通過認證。
若剛才取消了系統提示,返回 App 再次嘗試連線,並檢查系統 VPN 設定中的相關狀態。尚未確認授權是否完成前,不要反覆更換伺服器。系統授權與伺服器認證是兩個不同的檢查項目:前者由裝置管理,後者取決於匯入欄位與既有伺服器狀態。
完成授權後返回 Home,確認頂端連線狀態與開關是否維持開啟。若開關立即關閉、狀態持續顯示未連線,或出現錯誤提示,先記下提示的確切文字,再前往本文的疑難排解步驟。不要只憑系統狀態列圖示判斷遠端服務是否正常;圖示、App 連線狀態與請求是否成功,是三件不同的事。
若裝置上已有其他 VPN 設定,請先確認目前實際啟用的設定,避免測試時切換到非預期的連線。首次驗證也不建議同時調整 On Demand:按需條件可能改變連線行為,讓你難以分辨結果是由手動開關還是條件觸發所致。先完成一次明確的手動連線,確認連線可用後,再視需要設定 On Demand。
連線狀態穩定後,不必立即變更設定。維持同一台伺服器與相同的 Global Routing 模式,接著進行驗證。如此一來,若下一步出現差異,才能判斷問題出在測試方式、目標比對或伺服器本身,而不是多項設定同時變動所造成的混淆。
04 · Connectivity Test:驗證連線與分流
[Rule]請搭配實際連線狀況一起判讀測試結果。在 Home 點選 Connectivity Test,等待結果顯示。可在 Settings 的 Test Method 查看測試方式;不同方法檢查的環節各異,單次結果不能證明所有網站、協定和 App 都能正常使用。測試未通過時,也應先確認所用方法與測試條件,再判斷伺服器是否有問題。
伺服器可連線、App 已建立連線,以及目標請求依預期策略處理,是三件需要分別確認的事。即使清單測試有回應,認證資料或後續傳輸仍可能不正確;即使頂端開關維持開啟,某個目標也可能被規則分配到 DIRECT 或 REJECT。驗證時先記下伺服器名稱、Global Routing 與目前設定檔,並建立可重複的檢查條件。
接著開啟瀏覽器或準備使用的 App,造訪自己熟悉且有權存取的目標,確認頁面是否完整載入,而不只是首頁畫面出現。使用 Config 時,再分別測試一個預期走 DIRECT 的目標,以及一個預期走 PROXY 的目標。若 App 能查看相關連線記錄,請確認目標、符合的規則與最終策略;只看頁面是否開啟,無法可靠判斷請求的處理方式。
若實際結果不符預期,返回 Config 檢查目標對應的規則及其之前的規則。網域後綴、完整網域與 IP 位址的比對條件各不相同;頁面也可能載入其他資源網域,因此若主頁面能開啟但部分資源載入失敗,應檢查實際失敗的請求,而非只看網址列中的網域。如不確定規則寫法,請參閱DOMAIN-SUFFIX 概念說明與設定欄位參考。
要縮小問題範圍,可以先記下原設定,再暫時切換至 Proxy,重測同一個目標。若 Proxy 可用但 Config 結果不符預期,請優先檢查目前設定檔與規則比對順序;若兩者都失敗,則重新確認伺服器資料與連線狀態。這只是縮小排查範圍的方法,不表示要長期維持某個模式。檢查完成後,請恢復實際需要的模式並再次驗證。
完成此步驟後,至少應確認一項實際請求已完成,並了解目前模式是否符合用途。若只有測試結果,尚未實際造訪目標,驗證就還未完成。既有設定運作正常時,保留目前結果供日後比對;若問題仍未解決,請記下具體症狀後進行下一步。
05 · Settings / Diagnostics:依問題環節排查
先檢查基本網路與匯入資料,最後再查複雜設定。返回 Home 關閉連線,使用同一台裝置確認基本網路能正常連線。若基本網路本身異常,請先處理網路問題,再測試 Shadowrocket。切換 Wi-Fi 與行動網路有助於判斷問題是否與目前網路有關,但請保持伺服器與模式不變,避免同時改變多個變數。
訂閱無法取得或清單為空時,請檢查完整訂閱網址、有效狀態與更新結果。若伺服器已匯入但無法連線,請開啟該項目的編輯頁面,對照原始資料檢查 Type、Host、Port、認證欄位及相關傳輸設定。大小寫、遺漏參數或多出的空格都值得逐項確認;不要試圖修改規則來補救認證欄位錯誤。
若開關無法維持開啟,請確認系統 VPN 授權已完成,並仔細閱讀 App 顯示的錯誤訊息。若連線已建立但目標連線異常,請檢查 Global Routing、目前選取的伺服器與 Config 檔案。特別留意測試後是否仍停留在 Direct,或更新設定後目前使用的檔案是否已變更。確認這些基本項目無誤後,再檢查更細部的設定。
開啟 Settings,找到 Test Method 和 Diagnostics 等項目。Test Method 用來了解或調整測試方式;Diagnostics 可供查看診斷資訊。Settings 中還有 On Demand、Proxy、TCP、UDP 等項目,初次排查時不必逐一切換。只修改與目前症狀相關的設定,並記下原本的值,以便測試後還原。
依症狀選擇下一項檢查
| 觀察到的情況 | 優先檢查 | 下一步 |
|---|---|---|
| Subscribe 儲存後沒有伺服器 | 完整網址、有效狀態、取得結果 | 確認資料後重新更新,再檢查 SERVER 清單 |
| 連線開關立即關閉 | 系統 VPN 授權、錯誤提示 | 確認授權已完成,再核對伺服器欄位 |
| Connectivity Test 失敗 | Test Method、基本網路、伺服器狀態 | 維持其他條件不變,搭配實際連線再次測試 |
| Proxy 可用,但 Config 結果異常 | 目前檔案、Rule 順序、符合的策略 | 確認目標規則之前是否已有其他規則符合 |
| 只有部分請求失敗 | 實際失敗的目標、協定需求、連線記錄 | 依請求逐項排查,不要直接重設所有設定 |
若要進一步確認既有服務狀態,請整理症狀、發生條件及已完成的檢查,再向原服務提供者確認。問題描述可包含使用的協定、目前的 Global Routing、測試方式與錯誤訊息,但不要提供完整訂閱連結、密碼或其他認證資料。分享 Diagnostics 輸出或截圖前,也請確認沒有敏感資訊,只保留必要的錯誤訊息。
完成基本排查後,若問題明確出在規則比對或設定欄位,請前往規則與設定欄位參考繼續檢查;若只是不了解術語,則可使用概念速查補足相關知識。快速上手的完成標準不是調整了多少選項,而是能說明目前匯入的資料、選擇的模式、連線是否建立,以及實際請求是否依預期處理。