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 及官方圖示,不要只看名稱。