官方手冊 · 術語索引
Shadowrocket 術語手冊
依介面、協定與設定查詢術語。介面中的 Proxy 是一種分流模式,規則末尾的 PROXY 則是單條規則的處理策略。
介面與開關
先分清伺服器選取、連線狀態與分流模式。三者分別決定使用哪個連線、連線是否啟用,以及哪些請求交由代理處理。
- Home
- 用來查看伺服器清單、目前選取項目與連線開關。伺服器旁的選取標記只表示選了哪個項目,不代表已建立連線。網頁無法開啟時,先確認選取項目是否正確,再檢查開關與測試結果。
- Global Routing
- 用來選擇流量處理方式:
Config(設定)依目前設定檔處理流量,Proxy(代理)採用代理模式,Direct(直連)採用直連模式。要確認某條規則是否生效,先確認目前處於Config模式。切換模式不會將現有伺服器改成其他協定。
- Config
- 出現在導覽列時,指管理設定檔的頁面;出現在
Global Routing中時,指依目前設定檔處理流量的模式。修改規則後若未出現預期結果,應分別確認選取的檔案與目前使用的模式。
- On Demand
- 在符合設定條件時觸發連線,例如裝置切換網路後。它決定何時嘗試連線,不決定連線建立後某個網域要走代理或直連。關閉連線後又自動啟用時,先確認
On Demand的狀態與觸發條件。
- Add Server
- 用來手動新增伺服器,適合已掌握伺服器資料的情況。先依資料選擇協定類型,再確認位址、連接埠及該類型所需的驗證參數。儲存項目只代表資料已輸入,仍須選取該項目並測試連線。
協定
協定決定用戶端與伺服器的通訊方式。選擇類型時應以現有伺服器資料為準;即使位址和連接埠相同,不同協定也不能互換。
- Shadowsocks
- 主要用於加密轉送的代理協定。手動輸入時,位址、連接埠、加密方法與密碼都須與伺服器端設定一致。只確認位址和連接埠,無法排除加密方法或驗證資訊輸入錯誤。
- VMess
- 以
UUID識別使用者的代理協定。UUID用來識別連線使用的使用者身分,不是伺服器位址。若資料另有指定傳輸方式、路徑或 TLS 參數,也須逐項確認,不能只依位址和連接埠自行補齊。
- VLESS
- 將代理協定與傳輸安全分開處理,連線保護取決於實際設定的安全層。它與
VMess都可能使用UUID,但欄位相似不代表兩者相容。複製現有項目時,不應只更改協定名稱而沿用其他參數。
- Trojan
- 透過 TLS 傳輸的代理協定,通常以密碼驗證。伺服器位址用於定位連線端點,TLS 伺服器名稱則用來識別憑證所對應的主機,兩者不一定相同。若出現憑證名稱不符,先依現有資料確認相關欄位。
- HTTP / SOCKS5
- 兩種不同的代理介面:HTTP 代理可使用
CONNECT建立通道,SOCKS5則有獨立的連線與驗證交涉流程。是否需要使用者名稱和密碼,取決於伺服器端設定。介面名稱本身無法說明連往代理伺服器的連線是否加密。
- WireGuard
- 透過 UDP 傳輸的加密通道協定,以金鑰識別通道另一端。除了端點位址和連接埠,通道位址及允許透過通道傳送的位址範圍也會影響連線。公鑰與私鑰用途不同,排查時請勿將私鑰貼到記錄或截圖中。
- Hysteria2
- 以 QUIC 為基礎的代理協定,連線仰賴通往伺服器的 UDP 路徑。同一設定在某個網路可用、換到另一個網路後卻逾時時,網路條件也是排查方向之一。不能只憑一次測試推斷此協定在所有裝置上的速度或耗電情形。
規則關鍵字
規則關鍵字用來比對請求,策略則決定如何處理符合條件的請求。檢查規則時,先確認要比對的是完整網域名稱、網域後綴還是目標 IP,再確認規則順序。
- DOMAIN
- 依完整網域名稱精確比對。條件設為
example.com時,不會一併比對www.example.com。只想處理特定主機名稱時,使用精確比對可避免影響同一網站的其他子網域。
- DOMAIN-SUFFIX
- 比對指定網域及其子網域,例如同一條件可涵蓋
example.com和docs.example.com。此類比對依網域層級判斷,不是任意字串包含比對。規則條件應填入網域名稱,不要加入網址的通訊協定前綴或路徑。
- GEOIP
- 依地理 IP 資料庫對目標位址的分類結果進行比對,不會依頁面使用的語言或網域後綴判斷。同一項服務可能解析出多個位址,分類結果也可能隨位址而異。排查比對結果時,應確認該次連線使用的目標位址。
- IP-CIDR / IP-CIDR6
- 分別依 IPv4 與 IPv6 位址範圍比對;斜線後的數字表示前綴長度。只設定 IPv4 位址範圍,不會涵蓋同一服務的 IPv6 位址。檢查規則未符合的原因時,先確認實際連線使用哪一種位址。
- FINAL
- 為未符合前面規則的請求指定預設策略,通常放在規則區段的末尾。若某項連線採用預設策略,先確認前面的條件是否涵蓋實際請求目標。直接修改預設策略,也會影響其他未符合規則的請求。
訂閱與設定
伺服器項目用於建立連線,設定檔則用來儲存規則等設定。匯入現有訂閱、啟用某份設定檔,以及在裝置間同步 App 資料,是三種不同操作。
- Subscribe
- 透過使用者現有的訂閱連結匯入伺服器清單。更新時,清單可能因來源內容變更而新增或移除項目,但更新不等於切換分流規則。訂閱網址可能包含存取憑證,提供排查資訊前請先遮蔽。
- SERVER
- 用來整理或顯示伺服器項目的介面標籤。項目名稱只是辨識文字,實際連線取決於位址、連接埠、協定與驗證資訊等參數。即使兩個項目顯示相同名稱,也不要只憑名稱判定它們使用相同伺服器。
- 設定檔
- 儲存規則等設定的檔案,例如在
[Rule]區段中描述請求的比對條件與處理策略。匯入檔案不代表已選取該檔案,也不代表Global Routing已切換為Config。修改現有檔案前請保留原始檔,以便確認與還原。
- iCloud 同步
- 符合帳號與系統設定條件時,可透過 iCloud 在裝置間同步 App 資料。更換裝置後,商店已購項目對應的是 App 購買紀錄,不是設定檔備份。同步完成後,仍應在新裝置確認實際顯示的設定檔與伺服器項目。
策略與診斷
符合策略表示請求採用哪種處理方式;測試結果則表示某次檢查是否完成。開關已啟用或顯示延遲數值,都不能單獨證明某個網站可正常存取。
- PROXY
- 將符合規則的請求交由代理處理的規則策略。規則符合不表示對應伺服器一定可用,也無法證明目標服務已回應。排查時應分別檢查策略是否符合、伺服器是否連通,以及目標服務是否回應。
- DIRECT
- 讓符合條件的請求不經代理,透過裝置目前的網路直接傳送。它與
Global Routing中的Direct模式拼法相近,但單條DIRECT規則只會影響符合該規則的請求。直連仍會受到目前網路與網域解析條件影響。
- REJECT
- 拒絕符合條件的請求,不會改用其他策略處理該請求。若網站的圖片、登入或其他功能使用了遭拒絕的網域,即使首頁能開啟,相關功能仍可能失效。排查時先縮小比對範圍,再重新測試受影響的功能。
- DNS
- 負責將網域名稱解析為位址等記錄;解析結果會影響依目標 IP 判斷的規則。解析成功只表示取得結果,與能否成功連線至目標服務是兩回事。若只有部分網域無法使用,先確認是否有解析錯誤,再檢查符合的規則。
- Connectivity Test
- 用來檢查目前網路條件下能否完成指定測試。單次測試成功不代表所有網站都能存取,也無法驗證特定服務規則是否符合。比較兩次結果時,盡量維持伺服器、測試目標與網路條件一致。
- 延遲
- 指單次測量所記錄的耗時,可能受網路、測試目標與測量方式影響。適合在相同條件下比較,但低延遲不等於高頻寬,也不代表長時間連線穩定。發生逾時時,先確認測試是否收到回應,再比較耗時。