官方手冊 · 首次設定

Shadowrocket 使用教學

quick-start

匯入現有設定 → 選擇分流模式 → 連線與驗證。依五個步驟完成首次使用,再依失敗環節逐項檢查。

新增伺服器與匯入訂閱

01 / import

先判斷手上的資料屬於哪一種。訂閱連結通常是用來取得伺服器清單的網址;單一伺服器分享內容只描述一個連線;手動參數則包含協定、位址、連接埠及驗證資訊。三者用途不同,不要把訂閱網址填入 Host,也不要把用來查看說明的網頁網址直接當成訂閱連結。若無法確定,請先向自己的服務商確認資料類型。

已有訂閱連結:選擇 Subscribe

開啟 Home(主畫面),點選右上角的新增入口,或 SERVER(伺服器群組)中的 Add Server(新增伺服器)。進入後點選 Type(類型),選擇 Subscribe(訂閱),將自己的完整訂閱連結填入 URL 位址欄位。為這筆訂閱設定容易辨識的備註,然後儲存。返回 Home,等待清單取得完成,再檢查該訂閱下是否出現伺服器項目。

貼上前後各檢查一次連結邊界,尤其是開頭和結尾。聊天內容中的說明文字、換行和多餘空格可能會一起複製;網址中的查詢參數也可能遭到截斷。不要自行刪除看起來複雜的參數,它們可能用來識別你的訂閱。訂閱網址應如同帳戶憑證妥善保管,不要貼到公開留言、截圖或線上轉換頁面。

儲存訂閱不代表訂閱已成功更新。若只有群組名稱而沒有伺服器,請先進入該訂閱的操作入口嘗試更新,再檢查連結是否仍有效、目前網路能否取得內容。此時不必調整 Global Routing;匯入尚未完成,後續切換模式無法補齊空清單。也不要連續建立多筆相同訂閱,以免之後無法判斷正在使用哪一份。

已有伺服器參數:依 Type 填寫

如果取得的是逐項參數,請先在 Add Server 中選擇正確的 Type,再填入 Host(伺服器位址)和 Port(連接埠)。截圖展示的是包含 Password(密碼)與 Method(加密方法)的欄位組合;不同協定會顯示不同欄位,不能照著截圖為所有協定填寫同一組內容。Host 通常填入服務商提供的網域名稱或 IP 位址,而不是整個網頁連結。

驗證資訊、加密方法、傳輸方式和 TLS 相關參數都必須與伺服器端一致。協定名稱相近不代表欄位可以互換,也不要依經驗猜測缺少的項目。填寫後儲存,返回 Home,在 SERVER 中確認新項目存在。若已有 QR Code,可使用 Scan QR Code(掃描 QR Code);Import from Cloud JSON(從雲端 JSON 匯入)只適用於相應格式的資料,並非通用訂閱入口。

本步驟完成的標準是:清單中已有可選取的伺服器,且來源與備註都能辨識。先選擇一筆資料完整的項目,再進入下一步。若要了解特定協定欄位,請查看協定詳解,首次連線時不必修改所有進階選項。

Shadowrocket Add Server 新增伺服器頁面,顯示 Type、Host、Port、Password、Method 以及掃描匯入入口
Add Server:先選擇 Type,再填寫對應欄位。截圖中的欄位不代表所有協定。

Global Routing 三種模式

02 / routing

準備好伺服器項目後,返回 Home,點選 Global Routing(全域路由)查看目前的處理方式。此選項決定連線採用哪一類策略,不負責下載訂閱,也不會修正錯誤的伺服器密碼。首次使用應先了解三種模式,再決定是否需要編輯設定檔。

  • 設定檔(Config):依據目前設定檔中的規則決定如何處理連線。需要依網域或位址區分代理與直連時使用,但前提是已啟用符合預期的設定檔。
  • 代理(Proxy):將可接管的連線交由代理策略處理,適合短時間確認伺服器連線是否可用。這不代表每個應用程式的所有網路行為都必定經過同一條路徑。
  • 直連(Direct):連線採用直連方式,不透過代理伺服器轉送。需要暫時比對本機網路的存取結果時可以選用;選取後,不應再以代理存取結果判斷伺服器是否正常。

分別查看 Config 模式與 Config 頁面

Global Routing 中的 Config 是處理模式;底部的 Config(設定檔)頁面則用於管理和編輯設定內容。兩者名稱相同,但層級不同。準備使用規則分流時,請進入 Config,確認目前選取的檔案,再開啟檢視 Rule(規則)部分。截圖中的 General(一般設定)、Hosts(主機對應)、URL Rewrite(網址重寫)和 HTTPS Decryption(HTTPS 解密)屬於其他設定部分,首次連線不必逐項開啟。

Rule 通常依照由上而下的順序比對,命中第一條規則後便採用相應策略。DOMAIN-SUFFIX 用於比對網域後綴,IP-CIDR 用於比對位址網段,FINAL 是前面的規則都未命中時的預設處理方式。DIRECT 表示直連,PROXY 表示代理策略。檢查規則時,不只要查看是否包含目標網域,也要確認上方是否有更廣泛的規則先行命中。

本教學不要求新建整套規則。已有可信任的設定時,只要確認選取狀態和規則內容即可;若只有伺服器參數,還無法判斷設定是否正確,可以先使用代理(Proxy)進行一次連線測試,驗證後再切回設定檔(Config)。不要同時更換伺服器、修改規則和調整 DNS,否則即使存取結果改變,也難以判斷是哪項修改生效。規則關鍵字的簡要定義可查閱術語表。

Shadowrocket Config 設定檔編輯頁面,顯示 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 和 Add Rule
Config:在 Rule 中確認分流規則;Global Routing 的選擇仍在 Home 完成。

Home 開啟連線

03 / connect

選好模式後返回 Home,在 SERVER 群組中點選準備使用的伺服器。確認選取標記位於預期項目上,再確認 Global Routing 目前顯示的值。訂閱中有多個項目時,匯入成功不代表應用程式一定已選取剛新增的項目;連線前再次確認可避免誤用舊項目。

開啟頁面頂端 Not Connected(未連線)旁的開關。首次使用時,系統可能會跳出新增 VPN 設定的授權提示。確認要求來自 Shadowrocket 後選擇允許,並依系統要求完成密碼或裝置身分驗證。此步驟是讓系統建立本機網路接管設定,與填寫伺服器帳戶是兩回事;系統密碼不應填入伺服器的 Password 欄位。

返回應用程式後,等待頂端狀態變更。若先前拒絕授權,開關可能無法維持開啟;此時重新發起連線,依系統提示檢查 VPN 設定權限,不要透過重複匯入訂閱處理授權問題。若裝置受組織管理且 VPN 設定遭到限制,應先確認裝置管理規則,而不是反覆嘗試變更伺服器欄位。

開關開啟和系統顯示 VPN 狀態,只能表示本機網路接管已啟動,無法單獨證明遠端伺服器可存取,也不能證明每條規則都依預期命中。即使密碼錯誤或目標服務無法連線,本機狀態也可能與實際存取結果不同。保持目前的伺服器和模式不變,進入下一步驗證,先建立一組可重現的結果。

需要停止時,返回 Home 關閉頂端開關,並確認狀態回到未連線。首次排查期間不必開啟 On Demand(隨選連線);若原本已啟用,之後應留意網路條件是否會再次觸發連線。明確保留連線開關、所選伺服器和模式,比反覆切換多個項目更容易找出問題。

Shadowrocket Home 主畫面,顯示 Not Connected 開關、Global Routing、Connectivity Test 和 SERVER 新增入口
Home:確認伺服器和 Global Routing 後,再開啟頂端連線開關。

連線測試與生效驗證

04 / check

先在 Home 使用 Connectivity Test(連線測試),觀察目前項目是否有回應。此測試的意義與 Settings 中的 Test Method(測試方法)有關:不同方法檢查的目標和網路層級不同。因此,有回應不代表網頁一定能完整開啟;沒有回應也不能立刻證明伺服器的所有功能都無法使用。先記錄結果,再配合實際存取情形判斷。

分開驗證「能連線」和「規則正確」

開啟瀏覽器,造訪一個原本就需要使用且位址明確的目標頁面,觀察是否能載入。再造訪一個預期直連的頁面,確認一般網路存取仍正常。測試時盡量使用新的頁面要求,避免只憑快取頁面判斷。若只有某個應用程式異常,先確認瀏覽器的存取結果,不要立刻將局部問題歸因於整體連線無法使用。

接著返回 Shadowrocket,開啟 Data(資料記錄)查看本次要求對應的連線資訊;在可檢視的要求詳細資料中確認目標、規則及處理策略。使用設定檔(Config)時,預期直連的要求應對應 DIRECT,預期代理的要求則應進入相應代理策略。目標頁面能開啟,只代表有一條可用路徑,不能取代規則命中檢查。

若要進行比對,可在維持同一伺服器的情況下,短暫比較設定檔(Config)與代理(Proxy)。代理(Proxy)可用但設定檔(Config)異常時,通常應優先檢查目前設定和比對順序;兩者都失敗,則繼續檢查伺服器參數、本機網路與遠端狀態。測試結束後,恢復準備日常使用的模式,不要把排查期間的暫時選擇當成最終設定。

伺服器可用、實際目標存取正常、規則處理也符合預期時,首次設定就完成了。此時可保留目前有效的設定,再逐步了解隨選連線或更細緻的分流規則。不要為了尋找某個「最佳參數」一次調整大量進階選項;之後修改前,請保留可還原的設定副本,並妥善保管其中的連線憑證。

依失敗環節逐項排查

05 / diagnose

先將問題歸類為匯入、連線、存取或規則四個環節,再處理對應條件。儲存失敗、SERVER 清單空白、開關無法開啟、頁面無法載入並非同一種故障。保留目前的錯誤文字,不要一開始就刪除所有設定或重置全部選項;這會失去有效的比對資訊,也可能連原本可用的項目一起移除。

匯入失敗或清單空白

返回訂閱設定確認完整 URL,檢查是否誤用了普通網頁網址,以及複製時是否遺失參數。確認目前網路可以存取訂閱網址,並向自己的服務商確認訂閱狀態。若回傳的是登入頁、錯誤說明或不支援的內容,重複更新也不會讓它變成有效設定。可保留訂閱備註並記錄錯誤提示,不要公開傳送包含憑證的連結。

測試失敗或連線後無法存取

手動新增的項目請先確認 Type、Host、Port 和驗證欄位,再檢查 TLS、傳輸方式等附加參數是否完整。若本機網路本身無法正常瀏覽一般頁面,請先處理 Wi-Fi 或行動網路。接著可在維持相同項目和模式的情況下,更換網路進行比對。連線測試成功但網頁失敗時,也要檢查網域解析和目標服務狀態,不能只看一次測試數值。

部分頁面異常或切換模式後結果不同

先確認 Global Routing 沒有停留在直連(Direct),再確認 Config 中實際啟用的設定檔。設定檔(Config)下某個目標異常、但代理(Proxy)下正常時,請優先查看對應要求命中了哪條 Rule。具體網域規則應放在可能提早命中的廣泛規則之前,FINAL 通常作為最後的預設處理方式。先找出實際命中的項目,再決定是否調整,不要直接刪除整組規則。

在 Settings 中只檢查與現象相關的項目

進入 Settings(設定)後,可查看 Test Method 以了解 Connectivity Test 的測試方式;檢查 On Demand 是否依目前網路條件觸發連線;需要更多線索時再使用 Diagnostics(診斷)。截圖中的 Proxy、TCP、UDP 是不同的設定群組,並非遇到問題就必須全部修改的開關。排查前記錄原始值,調整後立即重新測試,若結果不符預期就還原。

如果問題仍未解決,請整理發生時間、網路類型、所選協定、目前模式和具體錯誤,再向自己的服務商確認伺服器端狀態。分享截圖或診斷文字前,應遮蔽訂閱 URL、密碼、驗證識別資料和其他個人資訊。更多問題可前往常見問題依類別查找;協定參數的意義與選擇差異請參閱協定詳解,首次上手不必在此展開整套技術設定。

Shadowrocket Settings 設定頁面,顯示 Test Method、On Demand、Diagnostics 以及 Proxy、TCP、UDP 設定群組
Settings:依據失敗現象檢查相關項目,修改前先保留原始值。

其他裝置與取得方式

get

以上介面步驟以 iPhone / iPad 為例。Shadowrocket 也提供 Mac(Apple 晶片與 Intel)、Windows、Android 和 Linux 版本。iPhone / iPad 版 App Store 售價 $2.99,一次性付費;Mac / Windows / Android / Linux 版免費。安裝檔由本站下載頁提供,網址位於本站 /dl/shadowrocket/ 路徑。

目前版本 讀取中 · iPhone / iPad $2.99 一次性付費,其他平台免費

需要再次確認 iPhone / iPad 應用程式時,請查看下載頁的正版核驗:開發者為 Shadow Launch Technology Limited,應用程式 ID 為 932747118,圖示請以官方商店所示為準。