快速開始/官方手冊

Shadowrocket 使用教學

新增現有資料 → 選擇模式 → 連線 → 驗證 → 疑難排解

本篇說明在 iPhone 與 iPad 上的首次操作。先完成一台伺服器的連線與驗證,再調整規則及自動連線條件;設定檔結構與規則語法另請參閱設定完整指南。

畫面截圖取自 App Store 官方素材,供辨識頁面與欄位;截圖中的清單內容不可作為填寫依據。實際操作請以裝置上的 App 介面為準,所有伺服器參數都應來自使用者現有資料。

STEP 01 / IMPORT

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

先讓 Home 顯示一台資料完整且可供選取的伺服器,再進行模式選擇。

開啟 Shadowrocket,進入 Home,找到 SERVER 群組下的 Add Server。先辨認手邊資料的類型:若只有一台伺服器的位址、連接埠及驗證參數,請手動新增;若有可更新伺服器清單的訂閱連結,請使用 Subscribe;若有單一伺服器的 QR Code,則可使用 Scan QR Code。三種資料不能只因外觀相似就使用相同入口,尤其不要把設定檔網址當成伺服器位址填入。

手動填寫現有伺服器資料

點選 Add Server 後,先設定 Type,再依該協定顯示的欄位填寫 Host、Port 及驗證資訊。官方截圖展示的是含有 Password、Method 的其中一種表單;選擇其他 Type 後,欄位可能不同。Type 應與現有資料中的協定相符,不能因為表單較簡短就改選其他類型。Host 填寫伺服器主機名稱或 IP 位址,Port 填寫連接埠;除非欄位明確要求 URL,否則不要將含路徑的完整連結貼到 Host。

若資料使用 Password、Method,請逐項核對大小寫及欄位值;若使用 VLESS、VMess 或 Trojan 等 Type,則依相應表單填寫現有識別資訊、驗證資料及傳輸參數。TLS、伺服器名稱與傳輸路徑也必須與伺服器端一致。初次操作不必自行嘗試一組「常見參數」:缺少的資料應先向自己的服務提供者確認;留白或猜測可能讓項目成功儲存,卻仍無法連線。

填寫完成後,使用頁面上的儲存功能返回 Home。確認 SERVER 中出現剛新增的項目,並為項目加上方便辨識的備註。備註只用來區分記錄,不會改變連線能力。此時先不要一次建立多個項目;以一筆已確認資料完整的記錄作為後續連線與疑難排解的基準,更容易判斷問題出在哪個步驟。

Subscribe、掃描 QR Code 與設定檔訂閱

匯入現有伺服器訂閱時,在 Add Server 的 Type 中選擇 Subscribe,依表單填入訂閱網址並儲存。貼上前請確認連結完整,沒有前後空格、換行或遺漏查詢參數。儲存或更新後,返回 Home 查看訂閱群組是否產生伺服器項目;若只有訂閱名稱而群組內容空白,還不能進行連線驗證,請先檢查連結內容及更新結果。

使用 Scan QR Code 時,只掃描使用者現有的伺服器資料;識別後仍須檢查 Type、Host 與 Port。Import from Cloud JSON 是另一種匯入方式,所需內容格式與一般訂閱連結不同,不要將任意連結反覆貼到不同入口嘗試。QR Code 與訂閱連結可能含有驗證資訊,匯入時不要公開展示,也不要當作一般截圖分享。

也請區分 Config 中的 Subscribe:它用於訂閱設定檔,以取得規則及相關設定,不等同於 Home 中匯入伺服器清單。成功取得設定檔,不代表已有可連線的伺服器。請先確認 Home 的 SERVER 中已有可選取項目,再進行下一步,選擇 Global Routing;若匯入後仍是空白,請參閱疑難排解中的訂閱與伺服器匯入說明。

Shadowrocket 的 Add Server 頁面,顯示 Type、Host、Port、Password、Method,以及 Scan QR Code 和 Import from Cloud JSON 入口
Add Server:欄位會依 Type 改變,截圖中的內容不可作為實際連線參數。

STEP 02 / ROUTING

Global Routing:選擇流量處理方式

伺服器資料決定如何建立連線,Global Routing 則決定要求採用哪條路徑。

完成匯入後返回 Home,點選 Global Routing,確認目前選擇的是設定檔(Config)、代理(Proxy)還是直連(Direct)。這三種方式不是三組伺服器,也不是三種連線品質等級。切換方式不會自動修正錯誤的連接埠或密碼;測試前請記下目前選擇,避免將不同路徑的存取結果混在一起比較。

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

設定檔(Config)依目前設定檔中的規則,決定要求採用 PROXY、DIRECT 或 REJECT 等策略。若需要規則分流,請先進入 Config,確認目前使用的設定檔,再開啟該檔案檢查內容。編輯頁面可見 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 等區段,各有不同用途;完成首次連線不需要逐一修改。

在 Rule 中,規則通常由上而下檢查;範圍明確的網域規則應排在較廣泛的規則之前,FINAL 則用來處理未符合前面規則的要求。以下片段僅說明規則順序:存取 example.com 及其子網域時使用 DIRECT,其餘要求交由 FINAL 指定的 PROXY 處理。範例網域不是伺服器位址,這也不是建議直接取代目前設定檔的完整檔案。

[Rule]
DOMAIN-SUFFIX,example.com,DIRECT
FINAL,PROXY

透過 Add Rule 新增規則前,請先確認要修改的是目前正在使用的檔案。編輯後儲存,並在 Config 確認選取狀態;只將檔案匯入清單,卻未設為目前設定檔,不一定會改變要求路徑。初次驗證只需確認可能符合的規則及策略是否符合預期。不要一次加入大量規則,也不要為了一般連線驗證啟用 HTTPS Decryption。

代理(Proxy)與直連(Direct)

代理(Proxy)會讓通常可透過代理處理的流量使用代理路徑,適合疑難排解時暫時減少規則分流的變因;系統流量與部分排除項目仍可能有各自的處理條件,不能理解為所有資料必定經過伺服器。直連(Direct)使用直連路徑,適合用來對照基本網路是否正常,但不能據此證明「代理伺服器連線成功」。使用這兩種方式都不需要另建伺服器項目。

若暫時沒有明確的分流需求,可先記下現有設定,在代理(Proxy)下驗證現有伺服器,再返回設定檔(Config)檢查規則差異。若已有確認可用的設定檔,則直接使用設定檔(Config),並在驗證步驟中觀察目標要求是否採用預期策略。每次只變更一項條件;規則類型、策略名稱與優先順序的詳細說明,請參閱規則與設定完整參考,本篇接著完成連線。

Shadowrocket 的 Config 設定檔編輯頁面,顯示 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 區段及 Add Rule 入口
Config:檢查目前設定檔中的 Rule;Global Routing 的選擇入口位於 Home。

STEP 03 / CONNECT

Home:選取伺服器並開啟連線

先確認目前的伺服器與處理方式,再進行系統授權。

返回 Home,在 SERVER 群組中點選準備使用的伺服器。依清單中的選取標記確認目前項目;開啟項目詳細資料進行編輯,與在清單中選取連線項目,是兩種不同操作。若訂閱中有多筆記錄,請先固定其中一筆進行測試;每次失敗後若同時更換伺服器、規則與網路,就很難判斷是哪項變更影響結果。

再次確認 Global Routing,接著開啟 Home 頂端的連線開關。尚未連線時會顯示 Not Connected。首次建立連線時,系統可能會提示允許 Shadowrocket 新增 VPN 設定;確認提示是由本次主動連線操作觸發後,選擇允許,並依裝置要求完成密碼或生物辨識認證。這裡的認證用於裝置授權,不是伺服器 Password,請勿在系統認證畫面輸入伺服器憑證。

若先前關閉授權提示,連線可能無法繼續。重新發起連線並查看系統提示;若仍未出現,請到裝置的系統設定檢查是否已有 VPN 設定,或裝置是否受到管理限制。受管理的裝置應遵守其管理規範,不要靠反覆修改伺服器欄位來解決授權問題。完成授權後返回 Shadowrocket,確認頂端狀態及開關是否維持連線。

開關開啟只代表連線流程已開始;即使顯示 VPN 狀態,也不表示所有目標要求都能正常存取。請先等待目前連線狀態穩定,再進行 Connectivity Test 與實際存取檢查。若開關立刻關閉,請記下提示內容及發生時間,再進入疑難排解;若能維持連線但網頁無法開啟,請保留目前項目與模式,繼續檢查要求路徑。

測試期間,避免其他 VPN 設定同時搶用目前連線,也先不要啟用複雜的 On Demand 條件。從 Wi-Fi 切換到行動數據後,原有連線可能需要重新建立,因此請記下當時使用的網路。若要主動中斷連線,返回 Home 關閉頂端開關並確認狀態已恢復;若之後自動重新連線,請檢查 Settings 中的 On Demand 條件,而非反覆刪除伺服器記錄。

Shadowrocket 的 Home 頁面,顯示頂端 Not Connected 連線開關、Global Routing、Connectivity Test、SERVER 群組及 Add Server
Home:先在 SERVER 中選取伺服器,再開啟頂端連線開關。

STEP 04 / CHECK

Connectivity Test:驗證連線與路徑

分別檢查「測試有回應」、「通道已建立」與「目標可正常存取」。

連線維持開啟後,在 Home 點選 Connectivity Test,等待測試完成。測試結果會受 Settings 中的 Test Method 影響;解讀回應或逾時前,應先確認採用的方法。某種方法得到回應,只能證明該方法對應的檢測條件成立;某種方法逾時,也不能單憑這一項就認定所有 App 流量都失敗。請勿將清單中的測試結果視為所有網頁及所有協定的保證。

接著開啟瀏覽器,造訪平時可確認正常的頁面,檢查內容是否載入,以及後續資源是否持續顯示。再返回 Shadowrocket,查看 Data 中可用的連線或流量記錄,搭配要求網域及策略判斷是否符合預期。在設定檔(Config)下,同一頁面的主網域、圖片網域及 API 網域可能符合不同規則;若頁面只載入部分內容,應找出失敗的要求,而非只看網址列中的主網域。

若在代理(Proxy)下可以存取、在設定檔(Config)下卻出現問題,請先檢查目前設定檔、規則順序及符合的策略。若兩種方式都失敗,請優先檢查伺服器參數、帳號連線權限及基本網路。在直連(Direct)下可存取的目標,可用來對照基本網路,但不能據此判斷 PROXY 路徑可用。逐項對照,比同時重建訂閱、更換規則及修改 DNS 更容易找出明確原因。

測試時請保留簡短記錄:使用 Wi-Fi 或行動數據、選取哪台伺服器、Global Routing 的方式、Connectivity Test 結果,以及實際頁面的狀況。只記錄可辨識的備註,不要記下密碼或完整訂閱連結。確認一條路徑可用後,再切換網路重做相同檢查;若只有某個網路失敗,問題範圍便可從所有設定縮小至該網路條件下的連線。

STEP 05 / DIAGNOSTICS

Settings:依失敗環節檢查

依序檢查匯入、授權、連線及要求,逐步縮小範圍,避免一次修改多項設定。

匯入後沒有可用項目

先確認裝置本身可以正常連線,再檢查使用的是伺服器訂閱還是設定檔訂閱。若 Home 中的訂閱群組是空的,請確認網址完整、是否仍在有效期限內,以及更新時是否出現提示。不要在公開討論中貼出完整訂閱連結;連結中的查詢參數可能就是存取憑證。若手動新增的記錄可以儲存卻無法連線,請重新核對 Type、Host、Port 及驗證欄位;成功儲存不代表伺服器端接受這些參數。

開關關閉,或連線維持開啟但無法存取

若開關立刻關閉,先檢查系統 VPN 授權及裝置限制,再查看 App 顯示的連線錯誤。若連線維持開啟但要求失敗,請檢查伺服器端是否可連線、帳號是否仍有連線權限,以及目前網路是否允許相關傳輸。手動新增時,TLS 名稱、傳輸方式及路徑尤其需要逐項比對現有資料;不要只檢查密碼就認定所有參數都正確。

進入 Settings,查看 Test Method 與 Diagnostics。前者會影響測試結果的解讀方式,後者用於查看診斷資訊;兩者都不是自動修復伺服器的按鈕。記下錯誤發生在建立連線前,還是送出要求後,再判斷應檢查驗證、傳輸或規則。初次疑難排解不必同時變更 Proxy、TCP、UDP 中的多項選項;維持預設值或已有明確設定,優先處理能解釋目前錯誤的項目。

規則、DNS 與 On Demand

若只有設定檔(Config)失敗,請到 Config 檢查目前檔案,找出目標網域對應的規則及 FINAL 策略。若前面已有範圍較廣的規則,後面的明確規則可能無法符合。DNS 方面,先確認裝置網路本身可用,再核對 General 中的解析設定;網域解析失敗與伺服器驗證失敗是不同問題。不要只為處理單一目標,就一次變更所有網域規則或解析設定。

On Demand 用來依設定條件觸發連線,不代表「任何情況下都會一直保持連線」。初次驗證應先手動連線,確認伺服器及規則可用後,再視需要設定 On Demand。若主動關閉後又重新連線,或切換網路後狀態改變,請先檢查其條件。Today Widget 是快捷操作相關設定,不能取代在 Home 確認目前伺服器及 Global Routing。

若 Wi-Fi 與行動數據的結果不同,請保持同一台伺服器、同一種方式及同一種測試方法,分別重新測試;只有一次變更一項條件,結果比較才有意義。每次修改後儲存、重新連線並重做驗證,再決定是否保留變更。準備傳送診斷記錄時,請隱藏密碼、驗證識別資訊、完整訂閱網址及個人網路資訊,只保留錯誤類型及相關操作順序即可。

完成這五個步驟後,應能確認目前使用的伺服器、Global Routing 方式及驗證結果。若仍無法找出原因,請參閱疑難排解;若需要調整 Rule、General 或 DNS,請再查看設定完整指南。之後更新訂閱或修改設定後,也應重新檢查「選取項目 → 連線 → 測試 → 實際存取」,不要只憑匯入成功就判斷設定已生效。

Shadowrocket 的 Settings 頁面,顯示 Language、Test Method、Today Widget、On Demand、Diagnostics、Proxy、TCP 及 UDP 設定項目
Settings:分別檢查測試方法、按需連線與診斷,每次只調整一項條件。