官方手冊 / 入門操作

Shadowrocket 使用教學

依序完成新增、選擇模式、連線、驗證與疑難排解。首次使用時,先確認一條連線正常,再調整更細部的規則與 Settings。

本頁是 Shadowrocket 官方手冊的一部分,本網站即為官方網站。以下以 App 內的英文介面用語說明操作,不以按鈕顏色或固定座標判斷。iPad 橫向使用時,清單與詳細資訊可能分欄顯示,操作順序仍相同;官方截圖可用來對照介面名稱,實際版面請以裝置目前顯示為準。

準備資料時,先確認取得的是訂閱連結、單一伺服器分享資料,還是設定檔。訂閱用於取得伺服器清單;Config 設定檔則用來儲存規則等設定,不能只因為「都是一個連結」就互相替代。若資料用途不明,請先向自己的服務提供者確認,不要反覆嘗試不同入口。

步驟 01 / 儲存連線資料

Add Server 新增與匯入訂閱

開啟 Shadowrocket,進入 Home。在 SERVER 區域找到 Add Server,開啟新增頁面。首先確認 Type,因為這會決定接下來要填寫哪些欄位。若已有訂閱連結,請依訂閱方式匯入;若只有一台伺服器的參數,則依對應協定手動填寫。首次操作選擇其中一種方式即可,不必重複新增相同資料。

已有訂閱連結:選擇 Subscribe

在 Add Server 中開啟 Type,選擇 Subscribe,返回新增頁面後,將自己的訂閱連結填入 URL 欄位。貼上後確認連結首尾完整,尤其留意從通訊軟體複製時是否帶入空格、換行或說明文字。保留原連結中的參數,不要自行刪改用於識別訂閱的部分,再使用頁面上的儲存功能返回 Home。

匯入時需要透過網路讀取訂閱內容。讀取完成後,請確認 Home 的 SERVER 中是否出現相應的群組或伺服器項目。若只看到訂閱名稱,卻沒有可選項目,請先確認讀取是否成功;儲存地址不代表已取得伺服器清單。訂閱內容更新後,使用該訂閱項目提供的更新功能重新讀取,再確認清單是否有變化。

已有伺服器參數:逐項填寫

手動新增時,Type 必須與服務提供者提供的協定相符,再填入 Host 和 Port。Host 通常填寫伺服器網域名稱或 IP 位址,不要額外加上網頁路徑;Port 填寫對應的連接埠。Password、Method 及其他驗證欄位會依 Type 而異。截圖只展示其中一種欄位組合,不能據此推斷每種協定都需要相同資料。

請逐項對照自己的資料,不要因名稱相似就猜測欄位值,也不要把訂閱連結貼到 Host 欄位。若手邊有 QR Code,可使用 Scan QR Code 讀取後核對欄位;Import from Cloud JSON 是另一種資料匯入方式,只有在資料明確符合該格式時才使用。匯入後仍須確認 Type、位址與驗證資料,不要只確認項目是否出現。

儲存後返回 Home,點選這次要測試的伺服器項目。若訂閱群組中有多筆項目,請確認目前選中的是哪一筆,後續測試才有明確的對象。訂閱網址與驗證資料可能包含存取憑證,請勿公開貼在求助文字或截圖中。想了解訂閱與設定檔的差異,可繼續參閱術語表;目前先保留一筆資料完整、來源明確的項目,再進入模式選擇。

Shadowrocket Add Server 官方截圖,顯示 Type、Host、Port、Password、Method 及掃描 QR Code 的入口
Add Server:先確認 Type,再填寫對應欄位。截圖中的欄位組合不代表所有協定。

步驟 02 / 確認流量去向

Global Routing 三種模式

儲存伺服器項目後,返回 Home 並開啟 Global Routing。這裡選擇的是流量處理方式,不是更換伺服器,也不是連線開關。三種模式分別是設定檔(Config)、代理(Proxy)與直連(Direct)。先確認這次要驗證的內容,再選擇模式,避免把切換模式當成連線失敗時的隨機嘗試。

模式處理方式操作重點
設定檔(Config)依目前使用的設定檔與規則決定流量去向。先確認目前使用的設定檔,再檢查 Rule 與最終比對項目。
代理(Proxy)以代理方式處理流量,適合集中檢查所選伺服器。確認已選取伺服器;單次測試無法概括所有 App 的行為。
直連(Direct)直接連線,不經所選代理伺服器轉送。可用來確認基本網路狀況,但不能驗證代理伺服器是否可用。

使用 Config 前先確認設定檔

若已有用途明確的設定檔,請進入 Config,確認目前使用的是哪一份檔案,再查看其中的 General、Rule 等內容。在編輯頁看到檔案,不一定代表它已設為目前使用的設定;返回清單後請確認使用狀態。初次使用時不建議一邊匯入伺服器、一邊大量修改規則,否則連線異常時很難判斷問題出在哪一層。

Rule 的規則順序會影響比對結果,最終比對項目則決定前面未比對請求的去向。以下僅為規則語法範例:示範網域走 PROXY,其餘由 FINAL 指向 DIRECT。請勿直接將這兩行當成適用於所有用途的完整設定,也不必為了完成本教學而替換自己的設定檔。

DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT

若目前只是要確認新增的伺服器能否運作,可先選擇代理(Proxy)進行一次範圍明確的測試;驗證後再切回所需的設定檔(Config),確認分流結果符合預期。若選擇直連(Direct),網頁能開啟只能表示目前條件下可直接連線,不能證明剛新增的伺服器有效。

截圖中的 Hosts、URL Rewrite 和 HTTPS Decryption 屬於進階設定,並非首次連線的必要步驟。本次先保留現有值,不要啟用尚未了解的設定。規則關鍵字的說明請參閱術語表,設定與 DNS 的系統說明請參閱設定參考。選好模式後返回 Home,接著開啟連線。

Shadowrocket Config 官方截圖,顯示 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 和 Add Rule
Config:對照目前設定檔中的 Rule。Global Routing 的模式入口位於 Home,不在此編輯頁面。

步驟 03 / 建立連線

Home 連線開關與系統授權

返回 Home,先確認三項資訊:SERVER 中是否選取了本次要使用的伺服器、Global Routing 是否為剛才選定的模式,以及頂端是否仍顯示 Not Connected。伺服器項目、模式選擇與連線開關狀態是三個不同條件,任何一項都不能取代其他兩項。

確認後開啟頂端的連線開關。首次連線時,系統可能會提示新增 VPN 設定。請閱讀提示,確認要求來自 Shadowrocket,再依系統流程決定是否允許,並完成裝置要求的身分驗證。此授權用於建立系統網路連線設定,不代表訂閱已成功匯入,也不表示遠端伺服器已可使用。

若取消系統授權,返回 App 後可能無法建立連線。此時請重新發起連線並確認系統提示,不要急著刪除已正確儲存的伺服器資料。若裝置受到管理政策限制,系統可能不允許新增或啟用相關設定;請先確認裝置限制,單靠修改用戶端欄位無法解決。

完成授權後返回 Home,確認頂端狀態已不再顯示 Not Connected,且開關維持開啟。若開關立即回到關閉狀態,請記下是否出現提示;若看起來已連線,請繼續驗證實際請求。不要只憑狀態列圖示或開關顏色判斷所有網站都能存取,連線狀態與請求成功之間還涉及伺服器、DNS 與規則等環節。

測試期間暫時不要同時調整 On Demand。它可能依據已儲存的條件影響連線行為,讓初次操作時開關狀態的變化難以判斷。若手動關閉後又自動重新連線,請先檢查是否設定了 On Demand,而非反覆切換開關。完成基本測試後,可參閱Settings 設定參考,了解條件觸發與系統行為。

若要結束這次連線,返回 Home 關閉頂端開關,並確認狀態已恢復。關閉連線不會自動刪除已儲存的訂閱、伺服器項目或設定檔;下次確認目前選取項目後仍可繼續使用。現在請先保持連線,進行實際驗證。

Shadowrocket Home 官方截圖,顯示 Not Connected 開關、Global Routing、Connectivity Test、SERVER 和 Add Server
Home:依序確認目前伺服器、Global Routing 與頂端連線狀態,再執行 Connectivity Test。

步驟 04 / 檢查實際請求

Connectivity Test 與連線驗證

分兩個階段驗證:先查看 App 內的測試結果,再測試實際網站或 App 請求。在 Home 執行 Connectivity Test,等待結果顯示,並留意測試使用的伺服器及目前的 Test Method。測試方法不同,結果代表的層面也不同;測試值有回應,不代表驗證、網域解析與目標服務都正常。

接著開啟瀏覽器,前往一個平時使用且網址明確的網站,再試試另一個不同網域的頁面。必要時重新載入,避免只看到先前快取的內容。記錄是所有頁面都失敗,還是只有特定頁面失敗;是持續等待,還是立即出現錯誤。這些現象比籠統地說「不能用」更有助於找出問題。

使用設定檔(Config)時,網頁成功開啟仍不足以證明流量經過代理;請求可能比對到 DIRECT。請搭配 App 中可查看的連線記錄或日誌,確認本次請求的網域、比對到的規則與處理去向是否符合目前設定。記錄入口與顯示內容可能會隨 App 介面調整,請以裝置實際顯示為準,不要把總流量變化當成特定規則已比對的證據。

若要比較代理(Proxy)與設定檔(Config),只更改這一項,維持伺服器、網路與目標頁面不變,再重新發出請求。Proxy 正常但 Config 異常時,優先檢查目前設定檔、規則與 DNS;兩者都異常時,再檢查伺服器與基本網路。對照測試結束後,將 Global Routing 恢復為原本需要的模式。

完成驗證的標準是:知道目前選取哪台伺服器、使用哪種模式、實際請求能否完成,以及 Config 模式下的流量去向是否符合預期。一次成功不代表所有目標都會成功,也不要為了追求特定測試數值而連續更換設定。若結果穩定且符合用途,基本操作即可完成;若仍失敗,請依下一節逐項檢查。

步驟 05 / 由外而內檢查

Settings 與常見失敗原因

連線失敗時,先保留目前資料,不要一次刪除訂閱、替換設定檔並重設 Settings。依序檢查基本網路、伺服器、模式、DNS 與規則,每完成一項就用上一節選定的目標請求重新測試。以下順序用來縮小問題範圍,不代表所有問題都能靠某一項固定設定解決。

先確認基本網路與伺服器資料

關閉連線,確認裝置目前的網路能否正常開啟日常使用的網頁。若基本網路本身無法使用,請先處理 Wi-Fi、行動網路,或目前網路需要完成的連線步驟。網路恢復後,再開啟 Shadowrocket 測試同一台伺服器,避免把切換網路造成的變化誤認為協定欄位的效果。

若訂閱讀取失敗,先確認連結是否完整、是否仍有效,以及目前網路能否讀取該網址;若清單已出現但連線失敗,請檢查所選伺服器的 Host、Port、Type 與驗證欄位。成功讀取訂閱只代表取得資料,不代表其中每台伺服器都能連線。服務狀態或資料是否有效,請向自己的服務提供者確認;本網站不提供替代連線資料。

接著區分模式、DNS 與規則問題

確認 Global Routing 沒有停留在直連(Direct)。若代理(Proxy)可用,但設定檔(Config)無法使用,請返回 Config 確認目前使用的檔案,並檢查目標是否已被前面的規則比對,以及 FINAL 指向何處。修改前請保留原設定檔,先找出造成差異的項目,不要以來源不明的內容取代整份規則。

若出現網域解析錯誤,請檢查是否修改過 DNS,以及設定是否符合目前的網路環境。排查時不要任意指定未確認的 DNS 位址,也不要關閉憑證驗證來掩蓋其他問題。DNS 與連線路徑會互相影響,詳細參數與疑難排解範圍請參閱設定參考;本頁只需先判斷問題發生在哪一層。

最後檢查 Settings 與診斷資訊

進入 Settings 找到 Test Method,先了解目前使用的測試方法,再解讀 Connectivity Test 結果。測試沒有回應可能與測試方法有關,仍應搭配實際請求判斷。若需進一步定位問題,可查看 Diagnostics,並依錯誤發生時間尋找相關資訊。Proxy、TCP、UDP 等項目屬於特定行為設定,不是連線前必須全部調整的「開關」。

若連線會自動開啟或關閉,請檢查 On Demand;若只有 Today Widget 狀態與預期不符,先返回 Home 確認實際連線,再檢查顯示問題。一次處理一種現象,不要把小工具顯示、遠端連線與規則比對混為同一項故障。還原已修改的單項設定後,再重做相同測試。

整理問題時,請寫明裝置目前的網路、匯入方式、Global Routing、失敗目標與提示內容。分享診斷資訊前,請遮蔽完整訂閱網址、Password、驗證識別資料及其他隱私欄位,只保留定位問題所需的錯誤資訊。不要公開整份原始設定檔。不熟悉協定名稱與規則關鍵字時,請先查看術語表,再決定是否繼續調整。

排查完成後,恢復已驗證可用的伺服器與模式,保留有效設定,並關閉不再需要的診斷記錄。基本連線穩定後,再逐項了解 DNS、On Demand 與設定檔管理;詳細操作請參閱Settings 設定項目參考,首次連線時不必全部完成。

Shadowrocket Settings 官方截圖,顯示 Language、Test Method、Today Widget、On Demand、Diagnostics、Proxy、TCP 和 UDP
Settings:疑難排解時依現象檢查 Test Method、On Demand 或 Diagnostics,不要一次修改多項設定。