Shadowrocket 官方手冊

Shadowrocket 術語手冊

依介面位置與設定用途查找術語。先釐清「是否連線」、「連線至何處」與「請求如何分流」,再核對具體欄位;介面用語、協定名稱與規則關鍵字均保留英文原文。

本頁以使用者已有自己的訂閱或伺服器資訊為前提。術語說明可協助理解設定,但不能取代實際參數;首次設定可從快速入門開始,完整規則語法請參閱設定欄位。

5 類概念 30 個術語 規則與設定參考

介面與開關

不同介面入口負責不同層面的操作。Global Routing 控制整體模式,On Demand 控制觸發連線的條件,兩者並非同一個開關。

Home

查看伺服器、訂閱群組與連線狀態的主要介面,也是檢查目前選取伺服器的起點。清單中出現伺服器,只代表資訊已匯入,不表示連線已啟用。排查時先確認選取項目,再檢查連線開關與 Global Routing,避免混淆這三種狀態。

Global Routing

控制整體路由模式,常見選項有設定檔(Config)、代理(Proxy)與直連(Direct)。Config 依目前設定檔中的規則分流;Proxy 使用代理模式;Direct 使用直連模式。這裡的模式與個別規則末尾的 PROXY、DIRECT 策略屬於不同層級;驗證規則前,應先確認目前處於 Config。

On Demand

依預設網路條件觸發連線的機制,可減少手動操作連線開關的次數。它決定何時嘗試連線,而不是某個網域應走 PROXY 還是 DIRECT。若手動中斷後又自動連線,請檢查 On Demand 條件及系統中的相關連線設定。

Add Server

手動輸入單一伺服器參數的入口,適用於已取得完整伺服器資訊的情況。先選擇相應協定,再填寫位址、連接埠與驗證欄位;傳輸方式和 TLS 參數也須符合服務商提供的內容。只填對位址與連接埠,無法確保其他必要欄位都已填妥。

Connectivity Test

用來檢查伺服器是否可連線的診斷入口;結果反映目前測試方式與網路環境下的狀況。測試成功不代表所有網站的 DNS、規則比對和應用程式請求都正常;測試失敗也須配合所用方式判斷。應一併記錄測試結果與實際存取狀況,不要只比較某個延遲數值。

Settings

調整應用程式偏好設定與相關行為的介面,不等同於訂閱清單或目前啟用的設定檔。遇到問題時先記下原值,每次只修改一個與症狀相關的選項,再重複相同測試。各平台的介面內容可能不同,請以目前裝置顯示的英文名稱為準。

代理協定

協定規範用戶端與伺服器的通訊方式。協定名稱不能取代連線參數,也不代表固定的速度或穩定性;匯入後仍須核對傳輸與驗證資訊。

Shadowsocks

一種代理協定,常見參數包括伺服器位址、連接埠、加密方式與密碼。加密方式是協定設定的一部分,不能因名稱相似就任意替換。若來源另提供傳輸參數,也須一併核對;即使位址與密碼相同,其他欄位不同仍可能導致連線失敗。

VMess

使用使用者識別資訊及相關參數進行驗證的代理協定,設定中常見 UUID 等欄位。VMess 是協定層的名稱,實際連線也可能涉及不同傳輸方式與 TLS 設定。匯入後應完整核對伺服器資訊,而非只檢查 UUID;裝置時間不正確也可能影響驗證程序。

VLESS

一種代理協定;協定名稱本身不代表已啟用加密傳輸。伺服器可能要求特定傳輸層、安全參數或其他配套欄位,這些設定必須一併核對。不能只將 VMess 設定的類型名稱改掉,就當作 VLESS 使用;應以現有伺服器實際提供的參數為準。

Trojan

通常透過 TLS 傳輸代理通訊的協定;密碼用於驗證,TLS 參數則用來建立並驗證安全連線。伺服器位址與 SNI 可能相同,也可能由服務商指定不同值,不可憑印象填寫。若憑證驗證失敗,應先檢查網域、裝置時間及來源參數,不應將關閉驗證當作一般解決方式。

Hysteria2

以 QUIC 為基礎的代理協定,其通訊仰賴 UDP,因此目前網路是否允許相關 UDP 流量會影響連線。驗證資訊、伺服器名稱與 TLS 設定仍須準確相符。若某個網路能連線、另一個卻不行,應一併檢查網路條件,不要只靠反覆更換密碼嘗試。

WireGuard

以金鑰建立加密通道的協定,常見參數包括用戶端私密金鑰、對端公開金鑰、端點與通道位址。各欄位用途不同,私密金鑰與公開金鑰不可互換,端點也不等同於通道內部位址。私密金鑰屬於敏感資訊,排查問題或分享截圖前應先遮蔽,並確認匯入內容來自自己的設定來源。

HTTP / SOCKS5

兩種不同的代理協定;選用時必須符合伺服器支援的類型,不能因位址和連接埠相同就互換。部分伺服器需要使用者名稱與密碼,是否須驗證取決於伺服器設定。協定名稱本身也不能證明用戶端到代理伺服器的傳輸已加密,安全性須依實際連線方式判斷。

規則關鍵字

關鍵字描述比對條件,行尾策略則描述符合條件後的動作。以下網域與網段僅供說明語法,不可作為實際服務參數。

DOMAIN

用來完整比對指定網域,例如 DOMAIN,example.com,PROXY 只適用於該網域。它不會自動涵蓋 www.example.com 等子網域,適合將影響範圍限制在單一主機名稱。規則中的網域不應包含通訊協定前綴、連接埠或網頁路徑,這些都不是網域本身的一部分。

DOMAIN-SUFFIX

依網域後綴比對,例如 DOMAIN-SUFFIX,example.com,PROXY 可涵蓋 example.com 及其子網域。適合處理同一網域體系,但不會自動涵蓋使用其他網域的相關資源。若某個子網域需要例外處理,應將更精確的 DOMAIN 規則排在前面。

DOMAIN-KEYWORD

檢查網域是否包含指定字串,例如 DOMAIN-KEYWORD,ads,REJECT 會比對網域中含有該字串的請求。它不會搜尋網頁內容或完整 URL,比對範圍也可能超出預期。封鎖前應確認實際符合的網域;若能用精確網域表示,應優先縮小條件範圍。

GEOIP

依 IP 地理資料庫中的地區歸屬比對目標位址,例如 GEOIP,CN,DIRECT。它判斷的是位址歸屬,不是網站使用的語言、公司所在地或頁面內容。結果會受目標解析出的位址與資料庫資料影響,因此同一網站在不同網路或解析結果下,可能符合不同條件。

IP-CIDR / IP-CIDR6

分別依 IPv4 與 IPv6 網段比對,網段後的前綴長度會決定位址範圍。範例 IP-CIDR,192.0.2.0/24,DIRECT 使用文件範例網段說明寫法,不應直接當作實際規則。檢查此類規則時,應同時考量 IPv4 與 IPv6,否則只涵蓋一種位址族可能會漏掉實際請求。

USER-AGENT

依請求中可辨識的 User-Agent 資訊進行比對,用來區分具有相應請求特徵的流量。這不等於通用的「依應用程式名稱分流」,也不能假設所有加密請求都會提供可供比對的欄位。規則未命中時,應先確認用戶端是否能取得相應資訊,而非只修改比對字串。

FINAL

處理先前未符合其他規則的請求,是整份規則清單的預設項目。FINAL,PROXY 會將其餘請求交由 PROXY 處理,FINAL,DIRECT 則會將其餘請求交由 DIRECT 處理。通常應放在清單末尾;若排在具體規則之前,後續規則就無法處理這些請求。

策略與比對

PROXY、DIRECT、REJECT 用來回答「符合規則後如何處理」。策略名稱不是協定名稱,也不是伺服器參數;大小寫與使用情境應以設定原文為準。

PROXY

表示將符合規則的請求交由設定指定的代理路徑處理,實際使用的伺服器取決於目前選取項目與設定。它不是伺服器位址,也不會自動補齊缺少的驗證參數。規則符合 PROXY 後仍無法存取,須繼續檢查伺服器連線、協定欄位與目標服務,不能只確認規則是否正確。

DIRECT

表示直接連線至目標,不經過代理伺服器,但流量仍可能經過用戶端的規則處理程序。某條規則使用 DIRECT,不代表連線開關已關閉,也不等於 Global Routing 目前處於 Direct 模式。排查直連請求失敗時,應檢查目前網路能否直接連至目標,以及 DNS 是否正常。

REJECT

表示拒絕符合規則的請求,適合用於明確需要阻擋的目標或請求特徵。條件設得太廣,可能連登入、圖片或其他必要資源也一併阻擋,因此新增前應確認比對範圍。若頁面只載入部分內容,可檢查是否符合 REJECT,而不是立即將所有流量改為 PROXY。

比對順序

規則通常由上而下檢查,第一條符合的規則會決定該請求的處理策略,不會因後面還有更具體的條件就自動重新選擇。應將單一網域等例外條件放在廣泛條件之前,最後再寫 FINAL。修改後測試時應送出新請求,並搭配可用的連線記錄確認比對結果,避免舊連線干擾判斷。

訂閱與設定檔

訂閱通常用於取得伺服器清單,設定檔則負責規則與相關行為。匯入其中一項,不代表另一項也已完成,更不代表已建立連線。

Subscribe

透過使用者現有的訂閱連結取得並更新伺服器清單;連結應向自己的服務商取得。訂閱回傳的內容是否包含群組或其他資訊,取決於來源提供的格式,不能將它視為完整的規則設定。連結可能含有存取憑證,提交問題或分享截圖時,應遮蔽完整網址與敏感參數。

伺服器資訊

指建立連線所需的位址、連接埠、協定與驗證等參數,使用者常稱為節點資訊。清單中的顯示名稱方便辨識,並非判斷協定或實際地理位置的可靠依據。手動填寫或從訂閱匯入,都應以自己的服務商提供的資訊為準;不可將教學中的範例網域當作可用伺服器。

Config

Config 既是管理設定檔的介面名稱,也是 Global Routing 中依設定檔規則處理流量的模式名稱,須依上下文區分。在 Config 中儲存某份檔案,不代表該檔案已啟用;選取檔案,也不代表整體路由模式正確。驗證時應依序檢查目前檔案、檔案中的 Rule 與 Global Routing。

General / Rule / Host / URL Rewrite

這些名稱用來區分設定檔中的不同用途:General 放一般設定,Rule 放分流規則,Host 定義主機名稱對應,URL Rewrite 負責重寫 URL。URL 重寫不同於一般網域分流,是否生效取決於具體請求與相關條件。編輯前先保留原設定,不要將規則行放進錯誤區段。

DNS

將網域解析為 IP 位址的機制,是連線至目標前的重要環節,也可能影響依目標 IP 判斷的規則。若伺服器連線測試正常但網頁無法開啟,DNS 仍可能是需要檢查的環節。修改相關設定時應記下原值,並區分伺服器網域解析問題與目標網站網域解析問題。

更新訂閱

重新從訂閱來源取得伺服器清單;來源回傳內容若有變動,名稱、數量與參數也可能隨之改變。更新成功不代表每台伺服器都能連線,更新失敗也不應立即刪除原有清單。先檢查連結是否完整、目前網路與來源狀態,保留可用資訊後再決定是否重新匯入。

依問題繼續查閱

了解術語後,請依目前操作選擇相應說明,避免同時修改伺服器、設定檔與系統設定。