Shadowrocket 官網 · 官方手冊

Shadowrocket 使用教學

新增伺服器、選擇 Global Routing、連線與驗證。依照可重複檢查的操作順序,完成首次使用。

本頁只說明首次使用所需的操作路徑。截圖用於對照介面位置;裝置上的項目排列可能隨系統及應用程式介面調整,請以實際顯示為準。設定項目的詳細說明請參閱Settings 設定詳解。

01 / ADD SERVER · SUBSCRIBE

新增伺服器或匯入現有訂閱

先開啟 Shadowrocket 的 Home,找到 SERVER 群組中的 Add Server。接下來要選擇哪種方式,取決於手邊資料的形式:一組位址、連接埠和驗證欄位適合手動新增;能取得伺服器清單的完整訂閱連結則使用 Subscribe。兩種方式不必同時操作,也不要把訂閱連結直接填入單一伺服器的 Host 欄位。

使用 Add Server 手動填寫

進入 Add Server 後,先開啟 Type,依自己的伺服器資料選擇協定,再填寫該協定所需欄位。Type 會決定後續顯示的輸入項目,因此不要先照著截圖填完再更改協定。圖中的 Host、Port、Password、Method 是欄位位置參考,並非所有協定都使用相同欄位;若資料中記載其他驗證或傳輸參數,請以相應 Type 下的實際欄位為準。

Host 填入伺服器位址,不要附加瀏覽器網址中的路徑;Port 依資料填入連接埠。Password、Method 等項目應逐一核對,特別留意複製時帶入的空格、換行與字母大小寫。如果資料另有 TLS、Server Name 或傳輸設定,也要展開相應選項核對,不能只因位址和連接埠相同就認為設定完整。不要自行猜測加密方式或省略驗證內容。

填寫後使用頁面上的儲存功能,回到 Home 查看 SERVER 群組。看到一筆記錄只代表資料已儲存,不代表伺服器可以連線。先檢查它是否與預期的名稱、位址相符,再選取該筆記錄,為後續測試指定明確的對象。

使用 Subscribe 匯入連結

如果已有訂閱連結,請在 Add Server 的 Type 中選擇 Subscribe,依介面提示填入完整連結,再儲存並等待清單載入完成。此處需要的是自己的訂閱網址,而不是服務帳戶的登入頁面。貼上後檢查連結首尾,確認沒有連同說明文字、引號或聊天訊息中的換行一起帶入。訂閱網址可能包含存取憑證,請勿將完整內容貼到公開討論區或截圖中。

回到 Home 後,查看訂閱群組是否出現預期的伺服器項目。如果只出現群組名稱卻沒有項目,先確認重新整理是否完成,再檢查連結有效性與目前網路能否存取訂閱網址;重複建立相同群組通常無法解決載入失敗。Subscribe 更新的是伺服器資料,不代表規則檔也已匯入。

已有 QR Code 時,可使用 Scan QR Code,並在儲存前核對辨識出的類型和欄位;Import from Cloud JSON 則適用於相應格式的資料,並非任意網頁連結的通用匯入入口。完成其中一種新增方式後,繼續下一步選擇流量處理模式,不必逐一嘗試其他匯入入口。

Shadowrocket 的 Add Server 頁面,顯示 Type、Host、Port、Password、Method,以及 Scan QR Code 和 Import from Cloud JSON 入口
對照 Add Server:先選擇 Type,再填入對應欄位。截圖中的欄位組合不適用於所有協定。
02 / GLOBAL ROUTING · CONFIG

選擇 Global Routing 模式

伺服器已顯示在 Home 後,開啟 Global Routing,明確選擇這次要如何處理流量。這裡的三種模式是設定(Config)、代理(Proxy)、直連(Direct)。選取伺服器與選取模式是兩項不同操作:前者決定代理目標,後者影響請求如何決定去向。排查問題前請先記住目前的選擇,否則切換模式就可能改變測試條件。

設定(Config):依目前規則處理

日常依規則分流時使用設定(Config)。進入 Config,確認目前使用的設定檔,再查看其中的 Rule。規則會決定符合條件的項目及相應處理方式;例如某個網域應走 PROXY,或交由 DIRECT 處理。訂閱清單中有伺服器,不代表已有適合自己用途的規則,也不代表剛匯入的檔案已成為目前設定。

右側官方截圖展示的是設定編輯頁面:General、Rule、Hosts、URL Rewrite、HTTPS Decryption 分別整理不同內容,Add Rule 用於新增規則。首次使用不需要逐段修改,也不需要為了連線而啟用所有功能。先辨認設定檔及 Rule 的位置;若準備編輯,請先儲存一份原始設定,避免覆蓋原本可用的內容。

以下內容僅用於了解規則結構,不能直接取代現有的完整設定檔。它表示對 example.com 及其子網域進行後綴比對,並交由 PROXY 處理。PROXY 是否可用,仍取決於所選伺服器和相應設定。

DOMAIN-SUFFIX,example.com,PROXY

代理(Proxy)與直連(Direct):用於明確比較

代理(Proxy)會將整體處理方向切換至所選代理路徑,適合在首次連線時檢查「所選伺服器是否能處理實際請求」。這不代表任何請求都會成功,也無法修正伺服器資料錯誤。若要暫時用它進行比較,請先記下原本的模式,測試完成後再恢復;不要只為了開啟單一網站,就長期保留自己不理解的選擇。

直連(Direct)則會依直連方向處理請求,有助於比較裝置的本機網路與代理路徑。直連能存取某個頁面,只能證明該頁面在目前本機網路下可連線,不能證明代理可用。反過來,代理測試正常也不代表所有規則都正確。規則優先順序、預設處理方式與 DNS 的搭配請參閱設定詳解;本次操作只需選定一種模式,再回到 Home 連線。

Shadowrocket 的 Config 設定編輯頁面,包含 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 區段與 Add Rule
Config 編輯頁用於查看設定內容;Global Routing 的模式選擇入口位於 Home。
03 / HOME · CONNECTION

回到 Home 開啟連線開關

回到 Home,先完成連線前檢查:SERVER 中已選取準備測試的伺服器;Global Routing 與上一步的選擇相同;目前的 Wi-Fi 或行動網路本身可以正常使用。如果裝置正連線至其他 VPN,請先在系統設定中查看其狀態,避免將兩個連線之間的切換誤判為 Shadowrocket 的伺服器故障。

確認後開啟 Home 頂端的開關。首次建立連線時,iPhone / iPad 可能會跳出新增 VPN 設定的系統授權提示。請確認這是剛才主動操作 Shadowrocket 所產生的要求,再依系統提示確認,並在需要時完成裝置身分驗證。這個步驟是在裝置上建立網路延伸功能所需的設定,不是填寫伺服器 Password;請勿混淆這兩類憑證。

完成授權後回到應用程式,查看頂端狀態是否已離開 Not Connected,以及連線開關是否維持開啟。不同系統顯示 VPN 狀態的位置可能不同,請結合 Home 狀態與後續實際存取結果判斷,不要只尋找固定位置的圖示。若授權完成但連線尚未啟動,確認開關狀態後再操作一次即可。

如果開關開啟後立即關閉,先停留在目前頁面查看是否有錯誤提示,再核對系統 VPN 授權與所選設定。快速連續切換會讓記錄中混入多次連線過程,不利於判斷最初的失敗原因。此時不要急著更改 DNS 或重新新增所有伺服器;先記下「開啟後立即關閉」的情況,再於最後一步依照相應路徑檢查。

連線開關穩定開啟後,也不要立即認定設定已完成。這主要表示本機連線程序正在執行;伺服器是否可用、網域是否能解析、規則是否命中,還需要在下一步分別驗證。先維持伺服器、網路與模式不變,讓接下來的 Connectivity Test 與實際存取使用相同條件。

Shadowrocket 的 Home 頁面,頂端顯示 Not Connected 開關,下方有 Global Routing、Connectivity Test、SERVER 群組與 Add Server
Home 是連線前的檢查位置:伺服器、Global Routing 與頂端開關都應一併確認。
04 / CONNECTIVITY TEST · DATA

分別驗證測試結果與實際請求

連線後,先在 Home 使用 Connectivity Test,等待目前測試結束。應依所用測試方式解讀結果:收到回應表示相應測試目標與路徑有回應,但不代表所有網站、協定和應用程式都可正常使用。出現 timeout 也不宜立刻刪除伺服器,因為測試目標、網路對特定流量的處理方式,以及測試方法本身都可能影響結果。

接著開啟瀏覽器,重新瀏覽一個自己熟悉且允許存取的頁面。盡量開啟新頁面或重新載入,避免將快取內容誤認為剛完成的網路存取。如果網頁有圖片、文字與後續載入內容,可以觀察它們是否都正常顯示;只看到頁面標題不足以確認整個請求流程正常。驗證時不要同時重新整理訂閱、切換伺服器和修改設定,否則很難判斷結果對應哪一項變更。

需要確認路由時,可查看 Data 或目前介面提供的連線記錄,留意這次請求的目標及處理方向。計數增加只能表示有流量經過,不能單獨證明流量經過預期的 PROXY。如果記錄中能查看相應規則與策略,應一併確認目標網域、命中條件和最終處理方式;若沒有相關記錄,先確認瀏覽器確實送出了新請求。

觀察到的情況下一項檢查
開關維持開啟,頁面正常載入確認 Global Routing 符合實際需求,再測試日常使用的應用程式。
Connectivity Test 有回應,頁面無法開啟查看網域解析、規則去向與瀏覽器錯誤,不要急著重複匯入。
只有 Config 模式下失敗對照目前的設定檔與 Rule,確認規則沒有將請求導向其他路徑。
切換本機網路後結果改變記錄 Wi-Fi 與行動網路的差異,再檢查協定所需的傳輸是否可用。

比較測試時一次只改變一項條件。例如先固定伺服器,比較設定(Config)與代理(Proxy);如果只有 Config 失敗,優先檢查規則,而不是重新填寫 Password。再例如固定模式,比較 Wi-Fi 與行動網路;如果只有其中一種網路失敗,先記錄網路差異。測試結束後恢復日常使用的模式,並再次瀏覽確認,避免將暫時的排查狀態保留為長期設定。

05 / SETTINGS · DIAGNOSTICS

依失敗情況檢查設定

如果驗證未通過,先將問題分類:資料未成功匯入、伺服器測試逾時、開關已開啟但網頁無法載入,或執行一段時間後中斷。這四種情況的檢查起點各不相同。保留目前顯示的錯誤與剛才執行的操作,比重設所有選項更有助於找出原因;也不要把所有失敗都歸因於 DNS。

匯入未成功:先檢查原始資料

手動新增後沒有預期項目,請回到 Add Server 檢查是否已儲存、Type 是否正確,以及必填欄位是否完整。Subscribe 沒有載入伺服器時,確認貼上的是完整訂閱網址,且目前網路可以存取該網址;訂閱是否有效,應依自己的服務資料或服務商說明確認。不要在公開頁面提交連結要求代為測試,因為其中可能包含可存取服務的驗證資訊。

測試逾時:先核對參數與時間

伺服器持續 timeout 時,依序核對 Host、Port、Type、驗證欄位與傳輸參數。如果使用 TLS,也要留意 Server Name 等欄位是否與原始資料一致,並檢查裝置系統時間是否正確。時間偏差可能影響憑證相關驗證,但修正時間不保證其他錯誤也會消失。某些傳輸方式依賴 UDP,網路環境差異也可能改變測試結果;不要任意關閉驗證來掩蓋參數問題。

Settings 中的 Test Method 會影響測試方式。先確認目前使用的方式,再解讀測試結果;不要為了讓清單顯示數值而不斷切換。如果伺服器本身與測試目標的可達性不同,可能出現測試結果與網頁使用體驗不一致的情況,此時應依實際請求和錯誤記錄繼續判斷。

開關已開啟但網頁失敗:分別檢查 DNS 與規則

先回到 Home 確認 Global Routing,再核對 Config 中目前使用的檔案。若代理(Proxy)可以存取、設定(Config)不行,優先查看規則去向;若兩種模式都失敗,但測試仍有回應,再檢查 DNS 解析相關記錄和瀏覽器錯誤。調整 DNS 前先記錄原值,每次只修改一項,重新測試後再決定是否保留。不要將網路上看到的一組位址填入所有 DNS 選項。

自動連線或中斷:檢查 On Demand 與系統狀態

遇到手動關閉後又連線、切換網路後狀態改變等情況,請開啟 Settings 查看 On Demand,確認是否有依網路條件觸發連線的設定。先了解目前條件,再決定是否暫時停用以進行比較;首次連線不需要主動啟用此功能。也應查看系統 VPN 狀態,確認沒有其他連線管理設定介入切換。

需要進一步找出原因時,使用 Settings 中的 Diagnostics,針對一次失敗操作收集必要資訊。分享記錄前請移除訂閱網址、伺服器驗證欄位及其他個人資訊,只保留錯誤類型與重現步驟。Today Widget、Proxy、TCP、UDP 等設定各有用途,不應將它們全部調整作為通用修復方式;詳細說明請參閱Settings 設定詳解,也可到疑難排解繼續查找具體問題。

Shadowrocket 的 Settings 頁面,顯示 Language、Test Method、Today Widget、On Demand、Diagnostics、Proxy、TCP 和 UDP 設定入口
Settings 用於依照情況檢查設定。首次使用不必逐項修改,更不要同時更動多個網路選項。

完成本頁後,應能清楚說明三項結果:Home 目前選取哪一台伺服器、Global Routing 使用哪種模式,以及實際頁面是否透過預期路徑載入。後續新增規則或調整設定時,保留這組可用狀態作為比較基準。