官方手冊 / 術語索引

Shadowrocket 術語表

依介面位置與設定用途查找術語。英文名稱保留 App 原文,中文說明其意義、適用範圍與容易混淆之處。

介面名稱 協定參數 規則語法 設定說明

本站是 Shadowrocket 官方網站與官方手冊。本頁協助理解術語,不取代操作步驟;初次設定可先閱讀教學,需要逐項核對設定時再參閱設定參考。同一個詞可能出現在不同位置,例如 Config 既是設定檔入口,也可表示 Global Routing 中的一種模式。

Interface

介面與開關

先區分操作入口、整體模式與自動連線條件,再檢查伺服器或規則。

Home
查看伺服器列表、選擇伺服器及操作連線開關的主要介面。列表中出現項目只代表資料已儲存,不代表驗證成功或目標可連線。排查時請分別確認目前選取的項目、連線狀態和 Global Routing 模式。
Global Routing
決定流量整體處理方式的模式入口,三種模式為設定 Config、代理 Proxy、直連 Direct。變更模式會影響連線的處理方式,不能只憑開關已開啟就判斷流量去向。這與個別規則中的 PROXY、DIRECT 策略屬於不同層級。
Config
在 Global Routing 中表示設定模式,流量會依目前設定檔中的規則處理。作為頁面名稱時,則代表設定檔管理入口。若要依網域分流,除了選擇此模式,也須確認實際啟用的檔案及其規則內容。
Proxy
Global Routing 中的代理模式,主要流量會經由代理路徑處理,並非日常依網域逐條分流的同義詞。選擇此模式無法讓錯誤的位址或驗證參數變成有效。測試時仍須確認目前伺服器可用,並比對特定目標的連線結果。
Direct
Global Routing 中的直連模式,主要流量會直接連線至目標。可用來比對目前網路本身的連線狀況,但不代表所有 App 與系統連線行為都已驗證。個別規則中的 DIRECT 只決定符合該規則的流量如何處理。
On Demand
依已儲存條件觸發 VPN 連線的機制,實際行為取決於條件、系統狀態與設定。它管理何時嘗試連線,無法修正位址、密碼或 DNS 錯誤。手動中斷連線後若又自動連線,請一併檢查此處的觸發條件。
Add Server
手動填寫伺服器資料的入口。請比對現有資訊,核對類型、位址、連接埠與驗證欄位,再檢查傳輸和 TLS 等其他參數。需填寫哪些欄位取決於協定,不可將同一組參數不加區分地套用至所有類型。

Protocols

協定

協定名稱用於識別連線方式,不能用來判斷服務品質;參數請以現有伺服器端資料為準。

Shadowsocks
一種代理協定,連線設定通常包含伺服器位址、連接埠、加密方法與密碼。加密方法須與伺服器端一致,不能因密碼相同就省略核對。若資料包含其他選項,也應依原始資料填寫,不要自行推測。
VMess
一種使用識別碼等參數進行驗證的代理協定。除位址和連接埠外,也須核對伺服器端要求的傳輸方式及 TLS 等相關選項。成功匯入只代表資料可讀取,不表示所有連線參數都已驗證。
VLESS
一種代理協定,通常須核對識別碼、傳輸方式和安全參數。名稱與其他協定相近,不代表設定可以互換。修改現有項目時,請完整比對原始資料,不要只更改 Type 卻保留所有舊欄位。
Trojan
一種通常搭配 TLS 使用的代理協定,常見參數包括位址、連接埠與密碼。伺服器端要求的 TLS 名稱也須正確對應,不能只核對連線位址。若憑證驗證失敗,請先檢查參數和裝置時間,不要直接降低驗證要求。
Hysteria2
一種以 QUIC 為基礎的代理協定,連線表現與目前網路如何處理 UDP 有關。驗證、TLS 與選用的混淆設定,請依伺服器端資料核對。協定名稱不代表一定更快,實際結果仍取決於網路與伺服器端條件。
WireGuard
一種以金鑰為基礎的通道協定,設定包含本機位址、金鑰、對端及路由範圍。其設定方式不同於只填寫單一伺服器密碼,相關欄位須一併核對。私鑰屬於敏感資訊,不應出現在公開截圖或排查資料中。
HTTP / SOCKS5
兩種不同的代理協定,不能因位址和連接埠相同就互換類型。伺服器可能要求使用者名稱、密碼或特定 TLS 設定,請依提供的資料填寫。兩者描述的是代理連線方式,與瀏覽器網址列中的網頁協定不同。

Matching & policies

規則關鍵字

先看比對條件,再看處理策略;使用 Config 模式時,請搭配目前的設定檔檢查規則順序。

規則
由比對條件和處理策略組成的設定項目,用來決定特定連線的去向。常見分流規則會依序比對,因此前面的寬泛條件可能影響後面的精確項目。排查時應一併檢查規則內容、排列位置與最終預設策略。
DOMAIN
依完整網域名稱比對的規則關鍵字,例如只為 example.com 設定處理方式。這不會自動涵蓋該網域下的所有子網域。若要涵蓋 www.example.com 等網址,請明確新增項目或考慮使用 DOMAIN-SUFFIX。
DOMAIN-SUFFIX
依網域後綴比對,通常用來涵蓋指定網域及其子網域。參數請填寫網域名稱,不應包含網頁網址的路徑或查詢參數。涵蓋範圍比單一完整網域更大,新增後請確認相關子網域是否都適用相同策略。
DOMAIN-KEYWORD
依網域是否包含指定關鍵字進行比對。這不表示網頁內文包含該詞,實際比對範圍也可能比預期更廣。若只想處理特定網站,通常應先確認 DOMAIN 或 DOMAIN-SUFFIX 是否更符合需求。
GEOIP
依 IP 地理位置資料庫的結果進行比對,而非根據網頁語言判斷。結果與目標 IP、資料庫內容及解析結果有關。若網站使用分散式服務,不能只憑網站名稱推斷一定符合某個 GEOIP 條件。
IP-CIDR / IP-CIDR6
分別用於比對 IPv4 與 IPv6 位址範圍,位址後方的 CIDR 前綴決定比對範圍。變更前綴會影響涵蓋的位址數量,不只是改變寫法。排查網域連線時,也應核對實際解析結果,避免只檢查 IPv4 而忽略 IPv6。
FINAL
未符合前面規則時採用的最終處理項目,通常放在規則末尾。它不是特定網域的專用條件,而是為其他連線提供預設策略。若許多未個別列出的目標未依預期處理,請檢查 FINAL 的值。
PROXY / DIRECT / REJECT
常見規則策略,分別表示交由代理路徑處理、直接連線及拒絕連線。全大寫寫法屬於規則語法,須與介面模式 Proxy、Direct 區分。PROXY 的實際出口也須依設定中的代理選擇或策略群組判斷。

Subscription & configuration

訂閱與設定

伺服器資料決定連線至何處,設定檔決定如何處理流量,兩者須分開檢查。

Subscribe
管理現有訂閱的相關介面用語,訂閱網址可用來取得及更新伺服器項目。匯入伺服器訂閱後,不應因此判斷完整的分流設定已啟用。訂閱網址可能包含存取憑證,分享排查資訊時請遮蔽完整連結。
伺服器
儲存協定、位址、連接埠與驗證等參數的連線項目,也常稱為節點。項目名稱只是方便辨識的標籤,無法證明實際所在地、連線能力或速度。連線失敗時應核對欄位和服務狀態,而不只是顯示名稱。
設定檔
儲存規則、DNS 等行為設定的檔案,用途與伺服器訂閱不同。匯入檔案不代表它已成為目前使用的檔案,請在 Config 中確認選取狀態。切換前建議保留原有檔案,發現差異時方便比對。
Scan QR Code
透過 QR Code 讀取現有連線資訊的入口;QR Code 只是承載資料的形式。辨識後仍須核對協定類型與欄位是否完整,再嘗試連線。含有密碼或其他憑證的 QR Code 應妥善保管,不要直接公開。

Settings & diagnostics

Settings 設定項目

以下詞語用來理解設定與測試結果,不代表每個項目都需要變更。

DNS
將網域名稱解析為 IP 位址的機制,是連線過程的一部分。解析成功與連上代理伺服器是兩回事;變更 DNS 也不等於切換流量出口。排查時應分別記錄網域能否解析、取得哪些位址,以及後續連線是否成功。
Connectivity Test
用來檢查目前條件下連線是否可達的測試入口。測試通過只能表示該次測試所經路徑有回應,不代表所有網站、協定或分流規則都正常。請搭配實際連線目標、目前模式與記錄,進一步判斷問題所在。
Ping
測試相關名稱,用於觀察所選方法與目標下的回應時間,不應一概視為 ICMP 測試。不同方法、目標及網路條件下的數值無法直接比較。延遲較低不代表傳輸速度較快;若逾時,也須進一步核對測試方法。
Log
記錄連線、解析或規則處理等過程的資訊,供排查時參考;顯示欄位取決於記錄類型與層級。查看時請比對問題發生時間,區分驗證失敗、解析失敗和連線逾時。分享前請確認是否包含位址、訂閱憑證或瀏覽記錄。
iCloud 同步
透過 iCloud 在符合條件的裝置間同步 App 支援的資料,範圍以實際設定為準。同步不等同於獨立備份,也不會決定 App Store 購買記錄。更換裝置時,請分別確認購買帳號、同步狀態與目前設定,避免混為一談。