Shadowrocket 官方手冊

Shadowrocket 術語解說

介面上看到的是入口還是開關?設定中寫的是條件還是動作?可依分類查閱,也能分享個別術語的連結。

介面與開關

先確認連線是否已開啟,再查看開啟後採用哪種處理模式。

Home
主畫面提供連線開關、伺服器清單及目前狀態。選取伺服器只是指定可能使用的遠端端點;連線開關關閉時,不會因此建立連線。若開關已開啟,但連線行為與預期不同,請再檢查 Global Routing。
Global Routing
這項設定用來選擇連線的處理方式。Config(設定)依目前設定比對規則,Proxy(代理)透過選定的代理路徑連線,Direct(直連)則不經代理伺服器。切換模式不會改寫設定檔中的規則。
Config
同一個詞有兩種用途:作為介面入口時,可查看及管理設定檔;作為 Global Routing 選項時,表示依目前設定處理連線。匯入檔案後若要測試其中的規則,須同時確認啟用的是哪個檔案,以及目前選取的模式。
On Demand
按需連線會在符合已設定條件時由系統發起,例如網路環境變更後,系統會重新判斷是否連線。此功能控制何時建立連線,不負責決定特定網域採用哪條路徑。若手動中斷後又自動連線,可先檢查按需條件,再查看分流規則。
Connectivity Test
連線測試會透過一次測試請求,確認目前網路與伺服器的組合是否可用。顯示的耗時會受測試方式、目標及當下網路狀況影響,不能換算成下載速度。測試成功也不代表設定中的每條分流規則都已通過驗證。

代理協定

協定決定與遠端通訊的方式。手動輸入時,請以現有的伺服器參數為準。

Shadowsocks
用戶端依照約定的加密方式與憑證和伺服器端通訊。位址與連接埠決定連線位置,加密方式與憑證則決定雙方能否正確處理資料。即使伺服器位址可連線,加密方式設定錯誤仍可能導致代理請求失敗。
VMess
此協定通常以 UUID 識別使用者。協定名稱無法表示伺服器端採用哪種傳輸方式;傳輸方式及相關欄位須與現有參數相符。若連線失敗,可分別核對使用者識別碼與傳輸參數,避免同時變更兩類設定。
VLESS
此協定通常也以 UUID 識別使用者,但不能只因憑證格式相似,就套用另一種協定的設定。傳輸安全性取決於另外設定的安全層,例如 TLS。輸入時請分別確認協定、傳輸方式與安全性選項。
Trojan
通常透過 TLS 建立連線,並使用密碼完成驗證。伺服器位址用來指定連線位置;SNI 則是在 TLS 交握時宣告的服務名稱,兩者用途不同。若憑證名稱有誤,應先核對服務方提供的名稱,而不是關閉憑證驗證。
Hysteria2
這是以 QUIC 為基礎、底層使用 UDP 的代理協定。確認 TCP 服務可連線,不代表同一網路中的 UDP 流量也能抵達。排查時可分別核對網路條件,以及位址、連接埠與驗證資訊。
WireGuard
這是以金鑰識別對端,並透過 UDP 傳輸封裝資料的通道協定。對端公鑰用來識別遠端,本機私鑰則代表本端身分,兩者不可互換。記錄設定或提供排查資訊時,請勿公開私鑰。

規則關鍵字

閱讀一行規則時,先看比對條件,再看符合後的處理方式。

DOMAIN
依完整主機名稱精確比對。條件設為 example.com 時,不會自動涵蓋 www.example.com。主機名稱欄位不包含網址中的通訊協定前綴、路徑或查詢參數。
DOMAIN-SUFFIX
依網域後綴比對網域本身及其子網域。例如,條件為 example.com 時,可比對 api.example.com,但不會比對 notexample.com。若要單獨處理某個子網域,應將較具體的規則排在通用後綴規則之前。
GEOIP
依位址資料庫中的國家或地區分類比對 IP,而不是根據網域後綴推測位置。同一網域可能解析出不同 IP,因此比對結果也可能不同。此結果也不等於伺服器的精確實體位置。
IP-CIDR
以位址前綴及前綴長度表示一段 IPv4 位址範圍。例如 192.0.2.0/24 會比對以 192.0.2 開頭的位址;斜線後的數字不是連接埠。若要比對 IPv6 位址範圍,對應的關鍵字是 IP-CIDR6。
FINAL
為未符合前序規則的連線指定處理動作,通常放在規則清單末尾。FINAL,DIRECT 表示其餘連線直接連至目標,不會將先前已符合規則的連線改為直連。若連線意外套用預設規則,請先核對前序條件與排列順序。
PROXY · DIRECT · REJECT
三者都是規則符合後的動作:PROXY 交由代理路徑處理,DIRECT 直接連線至目標,REJECT 則拒絕該連線。規則中的大寫 PROXY 和 DIRECT 只處理符合條件的項目,與介面中切換的 Proxy 和 Direct 模式不同。

訂閱與設定檔

伺服器清單決定可選擇哪些遠端端點,設定檔則決定如何處理連線。

伺服器
伺服器是用戶端連線的遠端端點,項目通常記錄協定、位址、連接埠及驗證資訊。已有這些參數時,可透過 Add Server 輸入。項目顯示名稱僅供辨識,變更名稱不會改變實際連線位址。
訂閱
訂閱連結由使用者現有的服務供應商提供,用來取得及更新一組伺服器項目;可在 App 中透過 Subscribe 新增。清單能更新,不代表其中每台伺服器都能連線。訂閱連結可能包含存取憑證,排查問題時請勿公開完整連結。
設定檔
設定檔用來儲存規則及相關設定,常見副檔名為 .conf。[General] 記錄一般設定,[Rule] 記錄分流規則。更新伺服器訂閱不等於替換目前的設定;排查分流問題前,請先確認實際啟用的檔案。
DNS
DNS 用來查詢網域對應的記錄,常見用途是取得連線所需的 IP 位址。解析成功只表示已取得記錄,不代表目標連接埠一定可連線。若出現網域解析錯誤,請先檢查解析路徑;若已解析但請求逾時,再檢查連線路徑。
URL Rewrite
設定中的 [URL Rewrite] 可依 URL 條件執行重寫或重新導向。分流規則決定連線採用哪條路徑,重寫規則處理的則是請求網址。對於加密請求,能否比對路徑也取決於 App 是否能讀取相關請求資訊。

系統權限與安裝

購買紀錄、系統授權與 App 內設定分別管理;更換裝置時應逐項確認。

VPN 設定
在 iPhone 或 iPad 上首次開啟連線時,系統可能會詢問是否允許新增 VPN 設定。此設定由系統管理,與 App 內的 .conf 檔案不同。若先前拒絕授權,可返回 Shadowrocket 再次嘗試連線,並閱讀系統提示。
已購項目
這是透過 App Store 查看購買紀錄、重新下載符合條件 App 的入口。更換裝置或重新安裝時,請先確認目前的商店帳號與原購買帳號一致。重新下載 App 不會透過購買紀錄取回伺服器項目或設定檔,App 內資料須另外移轉。
Apple 晶片與 Intel
這是 Mac 的兩種處理器架構。請在「關於這台 Mac」查看晶片或處理器名稱,再選擇對應的 Mac 安裝檔。首次開啟若遭系統阻擋,請先確認取得來源,再參閱安裝提示說明辨別提示類型。
App ID
這是 App Store 用來識別商品項目的數字編號,與購買所用的帳號不同。Shadowrocket 的 App ID 是 932747118,可在商品頁網址末尾核對。辨識商品項目時,也應確認開發者 Shadow Launch Technology Limited 及官方圖示,不要只看名稱。
Shadowrocket 全平台下載