[General]

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 不同;只有手上已有相應格式的資料時才使用。無論選擇哪種方式,儲存前都應確認伺服器類型、位址與認證欄位,不要只憑熟悉的名稱判斷。

Shadowrocket Add Server 頁面,顯示 Type、Host、Port、Password、Method,以及 Scan QR Code、Import from Cloud JSON 入口
Add Server:欄位會隨 Type 改變,請依既有伺服器資料填寫。

儲存訂閱後,確認清單內容,不要只看名稱

匯入 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 屬於不同層級的設定。看到相似名稱時,先確認自己是在編輯規則,還是在切換全域模式。

Shadowrocket Config 設定檔編輯頁面,顯示 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 與 Add Rule
Config:先確認目前檔案,再檢查 Rule 的內容與順序。

用一小段規則了解 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 連線狀態與請求是否成功,是三件不同的事。

Shadowrocket Home 頁面,頂端顯示 Not Connected 開關、Global Routing 的 Config 選項與 Connectivity Test,下方為 SERVER 分組和 Add Server
Home:確認伺服器與模式後,使用頂端開關建立連線。

若裝置上已有其他 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 等項目,初次排查時不必逐一切換。只修改與目前症狀相關的設定,並記下原本的值,以便測試後還原。

Shadowrocket Settings 頁面,顯示 Language、Test Method、Today Widget、On Demand、Diagnostics、Proxy、TCP 與 UDP
Settings:先確認測試方式,必要時查看 Diagnostics。

依症狀選擇下一項檢查

觀察到的情況 優先檢查 下一步
Subscribe 儲存後沒有伺服器 完整網址、有效狀態、取得結果 確認資料後重新更新,再檢查 SERVER 清單
連線開關立即關閉 系統 VPN 授權、錯誤提示 確認授權已完成,再核對伺服器欄位
Connectivity Test 失敗 Test Method、基本網路、伺服器狀態 維持其他條件不變,搭配實際連線再次測試
Proxy 可用,但 Config 結果異常 目前檔案、Rule 順序、符合的策略 確認目標規則之前是否已有其他規則符合
只有部分請求失敗 實際失敗的目標、協定需求、連線記錄 依請求逐項排查,不要直接重設所有設定

若要進一步確認既有服務狀態,請整理症狀、發生條件及已完成的檢查,再向原服務提供者確認。問題描述可包含使用的協定、目前的 Global Routing、測試方式與錯誤訊息,但不要提供完整訂閱連結、密碼或其他認證資料。分享 Diagnostics 輸出或截圖前,也請確認沒有敏感資訊,只保留必要的錯誤訊息。

完成基本排查後,若問題明確出在規則比對或設定欄位,請前往規則與設定欄位參考繼續檢查;若只是不了解術語,則可使用概念速查補足相關知識。快速上手的完成標準不是調整了多少選項,而是能說明目前匯入的資料、選擇的模式、連線是否建立,以及實際請求是否依預期處理。