跳至教學正文
官方手冊 · 首次連線

Shadowrocket 使用教學
訂閱匯入與連線設定

依照「匯入 → 模式 → 連線 → 驗證 → 排查」的順序操作。先完成一次可供檢查的連線,再調整規則與自動連線條件。

開始前:請先安裝 Shadowrocket,並備妥自己的訂閱連結或伺服器資訊。本網站不提供、不銷售、不推薦節點或訂閱。本教學以 iPhone / iPad 介面為例,截圖用於對照介面位置,實際畫面以裝置上的應用程式為準。

iPhone / iPad 版從 App Store 取得,$2.99 一次性付費;Mac(Apple 晶片與 Intel)、Windows、Android、Linux 版免費,可從本站下載頁取得。用戶端一次性買斷 ≠ 線路方案。尚未完成安裝時,請先查看下載與安裝放行說明;iPhone / iPad 系統需求以 App Store 頁面標示為準。

  • 操作介面 Home / Config / Settings
  • 準備資料 現有訂閱或伺服器參數
  • 操作原則 每次只調整一個變數

Add Server:新增伺服器與匯入訂閱

開啟 Shadowrocket 後,先停留在 Home,暫時不要開啟頂端連線開關。在下方 SERVER 區域查看是否已有項目:若已有項目,先確認它來自哪份資料;若清單為空,再依手邊資料選擇手動新增或匯入訂閱。選擇適合的其中一種方式即可,不必重複新增同一份資料。

手動填寫單一伺服器

在 Home 點按 Add Server,進入新增頁面。先開啟 Type,選擇與現有伺服器資料相符的協定類型。Type 會影響後續顯示的欄位,因此不要先填完所有內容再更換類型,也不要根據伺服器名稱猜測協定。

接著填寫 Host 和 Port。Host 填入伺服器位址,Port 填入連接埠;不要將包含協定前綴、路徑和查詢參數的完整訂閱連結填入 Host。若目前的 Type 顯示 Password、Method 等欄位,請依原始資料逐項填寫,並注意大小寫及前後空格。不同協定的驗證欄位並不相同,截圖中的欄位並非所有 Type 都必須填寫的通用清單。

確認後使用頁面上的儲存操作,返回 Home。確認 SERVER 中出現剛新增的項目,再點按該項目使其成為目前選取項目。若儲存後找不到項目,先檢查是否確實完成儲存,不要立刻重複填寫一次。

使用現有訂閱連結

同樣從 Add Server 進入,在 Type 中選擇 Subscribe,將自己現有的完整訂閱連結貼到對應的 URL 輸入欄位。貼上後從頭到尾檢查一次,特別留意通訊軟體附帶的說明文字、換行、引號和結尾標點;不得擅自刪除連結中的驗證參數。

儲存並等待匯入完成後,返回 Home 查看相應的分組及項目。訂閱管理的是一組伺服器資料,並不等同於 Config 中的規則設定檔。清單出現項目,只代表匯入階段已有結果,還需要繼續選擇模式並驗證連線。之後需要更新資料時,請在對應訂閱的管理操作中執行更新,避免將同一連結反覆新增為多個分組。

Shadowrocket Add Server 頁面,可確認 Type、Host、Port、Password 和 Method 欄位
Add Server:先確認 Type,再填寫該類型所需欄位。Scan QR Code 與 Import from Cloud JSON 是不同的匯入入口。

已有相應 QR code 時,可以使用 Scan QR Code 並檢查辨識結果;Import from Cloud JSON 僅適用於相應格式的資料,不能取代任意訂閱連結的匯入入口。無論使用哪種匯入方式,都應先確認資料類型,再選擇入口。截圖不能作為伺服器位址、帳號或密碼的來源。

本步完成標準:Home 的 SERVER 中已有與資料相符的項目,並能選取一部伺服器。若顯示解析失敗或清單為空,請先查看步驟 05 的匯入排查,不要透過更換 Global Routing 處理連結格式問題。

Global Routing:選擇 Config、Proxy 或 Direct

新增伺服器後,返回 Home,點按 Global Routing。這裡決定用戶端如何處理接管的流量,不負責修正伺服器參數,也不會替你建立規則檔案。三種模式分別是設定(Config)、代理(Proxy)、直連(Direct);先了解目前的選擇,再進行連線測試,才能解讀測試結果。

日常依規則使用:設定(Config)

設定(Config) 會依照目前設定檔中的規則處理請求。進入底部的 Config,確認目前使用哪份設定,再開啟查看內容。在設定編輯頁可看到 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 等區段;這些區段各有用途,首次連線不需要逐項修改。

先著重查看 Rule:規則通常依序比對,命中後的策略可能是 PROXY、DIRECT 或 REJECT。例如,以下一行表示對相應網域後綴使用 PROXY。這只是語法示意,並非完整可用的設定,也不提供任何伺服器資料。

DOMAIN-SUFFIX,example.com,PROXY

如果已有完整的規則設定,應先確認已選用該檔案,再返回 Home 將 Global Routing 設為設定(Config)。僅匯入訂閱,不代表規則檔案也已替換。不要因為編輯頁出現 Add Rule 就連續新增重複規則;先確認原有規則是否已涵蓋目標請求。

臨時對照:代理(Proxy)與直連(Direct)

代理(Proxy) 用於以全域代理模式進行對照,適合檢查問題是否與規則選擇有關,但仍須仰賴目前的伺服器及相應參數可用。這無法保證一定能瀏覽特定目標,也不會修正密碼、連接埠或 TLS 欄位。

直連(Direct) 用於以直接連線方式進行對照。若目標在此模式下可以開啟,只能表示該目標在目前網路的直接連線結果,不能據此判斷代理伺服器正常。完成對照後,返回 Global Routing 恢復原先準備使用的設定(Config),避免將臨時測試狀態當作日常設定。

Shadowrocket Config 設定編輯頁面,顯示 General、Rule、Hosts 等區段及 Add Rule 入口
Config:確認目前設定中的 Rule;Global Routing 則從 Home 進入選擇。

首次驗證不需要啟用 HTTPS Decryption,也不需要為此安裝憑證。先保留現有設定中的必要選項,並分開判斷「伺服器是否可用」和「規則是否命中」。若要進一步了解不同協定欄位及設計取捨,請查看協定詳解,不要只為了測試就切換成與伺服器不相符的 Type。

Home:開啟頂端連線開關

選擇模式後返回 Home,再檢查一次 SERVER 中目前選取的項目。訂閱中有多個項目時,匯入完成與選取伺服器是兩回事;應明確確認這次測試使用哪一個,避免混淆不同項目的結果。

點按 Home 頂端的連線開關。首次連線時,iPhone / iPad 可能會顯示新增 VPN 設定的系統提示。確認提示來自 Shadowrocket 後,依照系統流程允許;若系統要求裝置驗證,完成後返回用戶端。這裡授予的是裝置上的網路設定權限,不代表已購買或啟用任何線路服務。

返回 Home,查看頂端狀態是否仍為 Not Connected。若開關開啟後立即關閉,或系統授權尚未完成,應先處理權限與連線建立問題;不要將這種情況視為特定網站的規則比對失敗。已允許過設定的裝置,不一定每次都會出現相同提示。

若裝置也啟用了其他會接管網路的 VPN 設定,測試時應先確認目前實際使用的是哪一個。受組織管理的裝置也可能限制 VPN 設定;這類限制需要由裝置管理方確認,不應反覆刪除設定來嘗試繞過。

連線狀態改變後,繼續下一步驗證實際請求。系統顯示 VPN 狀態或用戶端開關維持開啟,只能證明相應設定正在執行,無法單獨證明遠端驗證成功、DNS 正常或每條規則都符合預期。

Shadowrocket Home 頁面,頂端為 Not Connected 開關,下方有 Global Routing、Connectivity Test 和 SERVER 分組
Home:確認 SERVER 選取項目、Global Routing 與頂端連線狀態,再執行 Connectivity Test。

本步完成標準:系統授權流程已完成,Home 不再停留於 Not Connected。若狀態正常但頁面無法開啟,請維持目前伺服器不變,進入下一步收集具體結果。

Connectivity Test:確認是否如預期生效

在 Home 點按 Connectivity Test,等待本次檢測結束。檢測結果與所用測試方法、測試目標及目前網路有關,因此應將結果視為線索,而不是把一次成功理解為所有應用程式都能正常使用。先記錄測試是否完成、是否逾時,再觀察實際使用情況。

  1. 開啟實際需要瀏覽的頁面。使用瀏覽器發出新的請求,避免只查看已快取的頁面。如果只有某個頁面失敗,先確認該目標本身是否可用,不要立刻重設整個用戶端。
  2. 確認測試時的 Global Routing。在設定(Config) 下,請求可能依規則走 DIRECT;頁面能開啟,不一定代表使用了 PROXY。代理(Proxy) 與直連(Direct) 的對照結果也要分別記錄。
  3. 搭配請求記錄查看處理路徑。在應用程式可用的請求記錄中尋找剛才瀏覽的網域,確認命中的規則與策略。記錄需要由新請求產生;沒有記錄時,先確認連線仍開啟,且請求確實重新發出。
  4. 恢復日常狀態後再測一次。若為了排查而暫時切換模式,請恢復設定(Config),再對同一目標重新測試,確認問題是否隨模式改變。

例如,在設定(Config) 下,某個本機目標由 DIRECT 處理,是規則生效的一種正常結果;命中 REJECT 的請求則需要檢查規則是否符合自己的使用目的,而非直接歸因於伺服器無法連線。若代理(Proxy) 下可以瀏覽、設定(Config) 下不行,應優先檢查目前設定與規則順序。

對照測試期間,請維持同一部伺服器、同一個目標和同一種網路連線,每次只改變一個條件。先更換伺服器、再更換 Wi-Fi,同時修改 DNS,雖然可能改變現象,卻很難確認真正原因。完成驗證後,可以先關閉再重新開啟連線,確認使用的是已儲存的設定,而非尚未套用的編輯內容。

至此,若連線狀態、實際瀏覽與規則記錄能互相對應,就完成首次設定。之後再考慮自動連線與更細部的規則調整;不需要為了「設定完整」而開啟所有選項。

Settings:常見失敗情況與檢查順序

排查時先描述現象:是訂閱無法儲存、SERVER 為空、測試逾時、開關自動關閉,還是連線後只有部分請求失敗。不同現象對應不同的檢查位置。請依照下列操作順序檢查,不必刪除所有資料後從頭重來。

訂閱匯入失敗或清單為空

返回訂閱項目,確認完整 URL,確定沒有貼到 Host,也沒有將一般網頁網址當作訂閱網址。接著檢查自己現有訂閱的有效狀態,並確認目前網路可以連線至該網址。更新後若沒有傳回可辨識的內容,切換 Global Routing 無法修復遠端傳回的格式。詳細自我檢查請參閱訂閱解析失敗或清單為空說明。

項目存在,但測試失敗

先確認目前選取的項目,再進入編輯頁面檢查 Type、Host、Port 和驗證欄位。若類型需要 TLS 或其他附加參數,應依原始資料逐項比對,不要憑經驗填入。密碼、UUID、金鑰等欄位用途不同,不能互相取代。若仍然失敗,可在維持設定不變的情況下,分別使用 Wi-Fi 與行動網路測試,並記錄現象是否隨網路改變。

測試結果與實際瀏覽狀況不一致

進入 Settings 查看 Test Method。不同測試方法測量的對象不同,某種方法失敗不能直接推斷所有實際請求都失敗。先固定一種方法完成對照,再搭配瀏覽器請求和規則記錄判斷。不要只根據清單中的單一測試結果,連續切換多部伺服器。

連線後只有部分請求異常

返回 Global Routing,暫時使用代理(Proxy)進行對照。若現象只在設定(Config) 下出現,應優先確認目前選用的 Config、Rule 中較早命中的項目及最終策略。如果出現網域解析錯誤,再檢查設定中的 DNS 相關選項;不要同時修改所有欄位。查看 Proxy、TCP、UDP 相關選項時,也應先確認問題是否確實與相應的流量類型有關。

Shadowrocket Settings 頁面,顯示 Test Method、On Demand、Diagnostics 以及 Proxy、TCP、UDP 設定入口
Settings:先確認 Test Method;需要自動連線或診斷時,再查看 On Demand 與 Diagnostics。

自動重新連線與 On Demand

若手動關閉後又出現連線,請檢查 Settings 中的 On Demand。它會依照設定條件觸發連線,不負責判斷伺服器資料是否正確。首次排查時先記錄目前條件;若這些條件影響手動對照,可暫時停用後測試,結束時再依需求恢復。建議先確認手動連線正常,再設定按需連線,避免同時排查觸發條件與伺服器問題。

需要進一步定位時應記錄哪些資訊

可在 Settings 查看 Diagnostics 相關入口,記錄問題發生時使用的網路、Global Routing 模式、協定 Type、是否僅影響特定目標及具體錯誤訊息。分享診斷資訊前,請遮蔽訂閱連結中的驗證參數、密碼、金鑰和個人網路位址;完整訂閱連結本身可能具有存取權限,不應放在公開截圖中。

若原始資料已失效或遠端拒絕驗證,請聯絡自己現有服務的提供者確認狀態;重新安裝用戶端無法恢復遠端權限。需要重新操作時,返回本頁的新增與匯入步驟;協定欄位的意義與取捨則請查看協定詳解。清楚說明「在哪個步驟失敗」,比一次更改所有設定更有助於定位問題。

Shadowrocket 官方下載