官方手冊 · 術語速查

Shadowrocket 術語表

依介面、協定及規則語法查詢術語。先分清「何時連線」、「連線到哪裡」與「如何分流」,再調整相應設定。

本頁保留英文介面用語與規則關鍵字;中文說明用來解釋用途,不會取代用戶端中的原名。不同平台的功能入口可能不同,操作步驟請參閱教學,完整語法請參閱規則參考。

Interface / Controls

介面與開關

看到某個功能入口時,先確認它是用來管理連線、切換處理模式,還是查看診斷資訊。設定名稱相似,不代表用途相同。

Home
查看伺服器清單、選擇連線目標並操作連線開關的頁面。清單中有一筆紀錄,只代表參數已儲存,不代表連線正在運作。開始排查時,應分別確認目前選取的伺服器、連線開關狀態及 Global Routing 模式,避免只檢查其中一項。
Global Routing
控制整體路由模式,常見選項為 Config(設定)、Proxy(代理)、Direct(直連)。Config 依目前設定中的規則處理,Proxy 採用代理模式,Direct 採用直連模式;實際行為仍可能受系統與應用程式必要處理影響。介面中的 Proxy、Direct 與規則列中的大寫 PROXY、DIRECT 所屬層級不同;驗證分流規則時,應先選擇 Config。
On Demand
依預設網路條件觸發連線行為,例如在指定網路環境下啟動連線。它處理的是「何時連線」,而不是「某個網域採用哪種策略」。啟用前先確認手動連線正常,再逐一設定觸發條件;否則自動連線的狀況可能掩蓋原有的伺服器或設定問題。
Add Server
手動輸入既有伺服器參數的入口,Type 用來選擇連線協定。伺服器位址、連接埠、驗證欄位及傳輸相關選項都必須與伺服器端設定一致,不能只憑名稱判斷協定。參數由你的服務商提供;若已有完整的匯入資料,應優先檢查匯入結果,不必重複建立相同紀錄。
Connectivity Test
依所選測試方式檢查伺服器是否能回應的診斷工具。延遲通常是一次測試往返所需的時間,不等於可用頻寬,也不能直接推斷所有網站的存取速度。比較結果時應使用相同測試方式及網路環境;測試通過後,仍須以實際目標請求確認 DNS、路由及應用層連線。
Data
查看上傳、下載等流量數據的頁面,可依用戶端提供的檢視方式觀察伺服器或應用程式的使用情況。數據反映特定統計範圍,不宜直接視為服務商帳單;歸零及統計週期也會影響比較結果。驗證規則時,應搭配請求紀錄與比對策略判斷,不能只因總流量增加就認定某條規則已生效。
DNS
將網域名稱轉換為 IP 位址的機制,是多數網域連線建立前的其中一個環節。解析成功只代表取得位址,不保證該位址上的服務可用;反之,網域解析失敗也可能讓正常的伺服器看起來無法連線。調整 DNS 前先記錄原有設定,並區分網域解析錯誤、連線逾時與憑證錯誤。
Protocols

協定

協定名稱說明連線方式,不代表連線品質。選擇 Type 時應以既有伺服器資料為準;相同位址搭配不同協定,不會自動成為可用設定。

Shadowsocks
使用指定加密方式與密碼建立代理連線的協定。位址、連接埠、加密方式及密碼必須整套一致,伺服器端要求的擴充參數也應一併確認。遇到驗證或交握失敗時,先檢查欄位是否遭截斷或含有多餘空格;不要把變更規則策略當成修正協定參數的方法。
VMess
使用使用者識別碼等參數完成身分驗證的代理協定,連線也可能包含獨立的傳輸與 TLS 設定。填入使用者識別碼後,仍須確認傳輸方式、路徑及伺服器名稱等相關欄位。僅憑連接埠號無法判斷這些參數;排查時也應確認裝置時間正確,避免時間偏差影響驗證。
VLESS
分開處理使用者驗證與傳輸安全設定的代理協定,使用者識別碼是其中一項核心參數。實際連線所需的傳輸方式及安全選項由伺服器端決定,不能直接套用其他伺服器紀錄。若使用者識別碼正確但仍無法連線,應繼續檢查 TLS、伺服器名稱及傳輸相關欄位,而非反覆修改驗證資料。
Trojan
通常透過 TLS 與密碼驗證建立連線的代理協定。密碼、伺服器位址、連接埠及用於憑證驗證的伺服器名稱都須符合伺服器端要求。憑證錯誤與密碼錯誤屬於不同環節,應分別確認;不應為了讓測試暫時通過而任意關閉憑證驗證,或忽略伺服器身分問題。
HTTP
在伺服器類型中,HTTP 指連線至 HTTP 代理伺服器的方式,不代表目標網頁只能使用 HTTP。若代理伺服器支援,可透過 CONNECT 建立目標連線;是否需要使用者名稱、密碼,以及用戶端至代理伺服器之間是否使用 TLS,則取決於伺服器端設定。這與目標網站本身使用 HTTP 或 HTTPS 是不同層面的概念。
SOCKS5
用來向代理伺服器提交連線請求的協定,連線目標可用網域名稱或位址表示。TCP、UDP 及驗證功能須同時考量用戶端和伺服器端的支援情況,不能因一種測試成功就推定所有流量類型都可用。SOCKS5 本身不等同於加密通道,使用時仍須了解底層傳輸環境。
WireGuard
以金鑰配對建立加密通道的協定,參數通常包括 Endpoint、雙方金鑰、通道位址與允許的位址範圍。這不是把密碼換成一段金鑰就能完成的一般伺服器設定,各欄位都須彼此對應。私鑰是敏感憑證,提交診斷截圖或分享設定前應先移除;公鑰與私鑰也不能填反。
Hysteria2
以 QUIC 為基礎的代理協定,仰賴 UDP 傳輸,並使用 TLS 及相應的驗證參數。目前網路若限制 UDP,即使位址與驗證資料正確,也可能發生交握逾時。排查時應先確認網路條件及伺服器是否可連線,再檢查驗證資料與其他選項;協定名稱本身無法保證特定速度。
Rule Keywords

規則關鍵字

規則關鍵字定義「依據哪些條件進行比對」。下方片段是語法範例,並非完整設定;example.com 及其子網域僅用來說明比對範圍。

DOMAIN
精確比對單一網域名稱,不會自動涵蓋其子網域。例如 DOMAIN,example.com,PROXY 會比對 example.com,但不會因此比對 api.example.com。適合為單一主機設定明確例外;若要涵蓋整個網域及其子網域,應考慮 DOMAIN-SUFFIX,並確認例外規則的順序。
DOMAIN-SUFFIX
比對指定網域名稱本身及其子網域,例如 DOMAIN-SUFFIX,example.com,PROXY 同時涵蓋 example.com 與 api.example.com。它依網域層級邊界比對,不是任意比較字串結尾,因此不會涵蓋 notexample.com。若要讓某個子網域採用不同策略,應將更具體的 DOMAIN 規則放在前面。
DOMAIN-KEYWORD
檢查網域名稱是否包含指定字串,例如 DOMAIN-KEYWORD,ads,REJECT。這種比對方式範圍較廣,可能同時涵蓋非預期的網域,且沒有 DOMAIN-SUFFIX 的網域層級邊界。新增後應查看實際比對紀錄;若誤比對過多,優先改用明確的網域名稱或網域後綴。
GEOIP
依據 IP 地理資料庫中的紀錄比對目標 IP 的歸屬,例如 GEOIP,CN,DIRECT。它不會判斷網頁內容類別,也不直接代表網站營運方所在地;資料庫更新及目標解析結果都可能影響比對結果。使用前應了解相關 DNS 行為,不應將地理歸屬視為判斷目標身分的唯一依據。
IP-CIDR
比對 IPv4 位址範圍,例如 IP-CIDR,192.168.0.0/16,DIRECT 可用來指定一段私有位址。斜線後的數字是前綴長度,用來決定比對範圍,不是連接埠號。規則是否需要觸發網域解析也與設定選項有關;排查區域網路存取問題時,應一併確認實際子網路、目標位址及規則位置。
IP-CIDR6
比對 IPv6 位址範圍,例如 IP-CIDR6,fc00::/7,DIRECT 代表一段 IPv6 唯一本地位址範圍。IPv4 的 IP-CIDR 規則不會自動涵蓋 IPv6 位址,同一網域也可能同時解析出兩種位址。若不同請求採用不同路徑,應檢查實際連線位址,而不是只依網域名稱推斷規則結果。
USER-AGENT
依可見 HTTP 請求中的 User-Agent 資訊比對請求,但這不代表能可靠辨識發出請求的應用程式。加密連線不一定能直接取得這個欄位;應用程式也可能省略、修改或共用相同識別資訊。使用這類規則前,應確認請求資訊是否可見,並了解涉及 HTTPS 解密時的憑證與隱私影響,不能只憑應用程式名稱撰寫判斷條件。
FINAL
前面的規則都未比對成功時採用的預設規則,例如 FINAL,PROXY。它通常放在 Rule 區段末尾,不再附加網域或位址條件。若將 FINAL 提前放置,後續一般規則便不會有比對機會;選擇預設策略時,應先決定未分類請求要直接連線,還是交由代理路徑處理。
Policies / Order

策略與比對順序

關鍵字定義比對條件,策略定義符合條件後的處理方式。規則不會自動將較具體的條件排在前面,書寫順序本身就是設定的一部分。

PROXY
規則策略,表示將符合條件的流量交由代理路徑處理;實際使用哪台伺服器,取決於目前選擇及相關設定。它不是特定協定,也不代表固定使用某個伺服器位址。規則比對到 PROXY 但請求失敗時,應繼續檢查所選伺服器、驗證參數及目標連線狀況,不要直接認定規則未生效。
DIRECT
規則策略,表示符合條件的流量直接連線至目標,不經所選代理伺服器。直連仍取決於目前網路的 DNS、系統路由及目標服務狀態,因此 DIRECT 不代表一定能連線成功。它與 Global Routing 中的 Direct 模式不同:單條 DIRECT 規則只處理符合該規則的請求。
REJECT
規則策略,表示拒絕符合條件的請求,不會刪除伺服器紀錄,也不會清除訂閱。過於寬泛的比對條件可能連應用程式所需的請求也一併拒絕,造成部分內容無法顯示或功能不能使用。遇到這類情況,應先查看比對紀錄、縮小比對範圍或調整具體例外,不宜直接增加更多拒絕規則。
比對順序
Rule 中的一般規則由上往下檢查,符合第一條規則後便採用其策略,不會繼續尋找「看起來更精確」的後續條件。通常應將具體例外放在較寬泛的規則之前,並將 FINAL 放在末尾。修改後應確認目前設定檔已啟用、Global Routing 處於 Config,並以新的連線請求觀察比對結果。
Subscribe / Config

訂閱與設定檔

伺服器資訊回答「連線到哪裡」,規則設定回答「哪些請求使用這條連線」。匯入伺服器、更新訂閱及切換設定檔是不同操作,應分別確認。

Subscribe
透過訂閱網址取得及更新一組伺服器資料的方式,訂閱連結由你的服務商提供。連結中可能包含存取憑證,不可公開貼在截圖、記錄檔或共用設定中。更新訂閱可能會變更伺服器清單,但不代表已切換規則設定,也不保證先前選取的伺服器仍然存在;更新後應重新確認目前的選擇。
伺服器
用戶端中儲存的一筆連線紀錄,通常包含協定、位址、連接埠及驗證參數,也常稱為節點。紀錄名稱只是方便辨識的標籤,無法證明實際位置、協定功能或連線品質。伺服器可手動新增,也可來自既有訂閱;重複匯入相同資料只會增加管理負擔,不會改善連線。
Config
既可指管理設定檔的入口,也可指 Global Routing 中依設定檔規則處理流量的模式,須依所在位置判斷。設定檔可包含 General、Rule、Host 等區段,分別描述基本行為、比對條件及靜態網域對應。儲存檔案不代表目前正在使用該檔案;調整前先保留副本,再確認目前啟用的項目。
URL Rewrite
依條件改寫請求 URL 或執行相應重寫動作的設定區段,與 Rule 中選擇 PROXY、DIRECT、REJECT 的路由規則不同。重寫可能改變請求路徑或回應流程,不能取代伺服器驗證參數。處理 HTTPS 請求時也受可見資訊及相關憑證設定限制;應先了解比對範圍,再逐條測試。

返回分類目錄 ↑