官方手冊 / 術語查閱

Shadowrocket 術語表
介面、協定與規則

遇到英文設定項目時,該先查什麼?先確認它屬於介面操作、連線協定還是規則策略,再閱讀對應說明。本頁保留英文原名,每張術語卡都能透過網址末尾的錨點直接定位。

準備開始操作?請依照 首次使用教學逐步確認;需要完整規則範例時,請前往 規則手冊。以下概念說明不取代 App 內目前顯示的選項。

01 / Interface

介面與開關

同一個詞是否總是指同一項功能?不一定。先查看所在頁面與上下文,尤其要區分 Config 入口、Config 模式,以及規則中的策略。

介面與開關

Home

要在哪裡檢查目前的連線?Home 是查看伺服器項目、目前選取項目與連線開關的主要入口。先確認選取的項目,再查看開關狀態;顯示已連線只代表通道狀態,無法單獨證明目標網站可正常存取。若遇到異常,應進一步檢查測試結果、模式與規則。

介面與開關

Global Routing

為什麼切換模式後,存取結果會改變?Global Routing 決定整體流量的處理方式;設定、代理、直連分別對應介面用語 Config、Proxy、Direct。需要依設定分流時請檢查 Config;暫時排查時可對照其他模式,但測試後應還原預期設定,避免把測試狀態當成日常設定。

介面與開關

Config

Config 是檔案還是模式?在設定管理入口,它指的是檢視、編輯與選取設定檔;在 Global Routing 中,則表示依目前設定處理請求。編輯檔案後,還要確認它是否為目前使用的設定檔,不能只憑成功儲存就認定規則已生效。

介面與開關

Proxy / Direct

這兩種模式和規則策略相同嗎?Proxy、Direct 是 Global Routing 中的模式名稱,分別用於整體代理與直連處理;規則列中的 PROXY、DIRECT 則是大寫策略關鍵字。排查時先記下模式,再查看規則,避免在未依設定分流的狀態下反覆修改規則檔。

介面與開關

On Demand

為什麼網路變更後會觸發連線?On Demand 用於依網路等條件觸發 VPN 連線,實際條件請以 App 內選項為準。它回答「何時連線」,規則回答「如何處理請求」,兩者屬於不同層次。修改後請分別測試 Wi-Fi 與行動網路下的實際行為。

介面與開關

Add Server / Subscribe

已有的資訊應填在哪裡?Add Server 是新增連線資訊的入口,Subscribe 是訂閱類型名稱。手動新增時,請選擇與現有參數相符的協定;匯入訂閱時,填入使用者自己的訂閱網址,再檢查產生的項目。不要把訂閱網址填入單一伺服器的位址欄位。

介面與開關

Connectivity Test

測試通過代表什麼?Connectivity Test 會依所選測試方式檢查連線狀況,結果只適用於當時的測試條件。比較項目時,應使用相同的測試方式與網路,再確認實際目標。一旦測試失敗,不代表參數必定失效;一次成功也不保證所有服務都能存取。

02 / Protocols

協定

協定名稱能決定要如何填寫嗎?只能確認參數類別,無法推知具體數值。請以使用者現有的服務參數為準,逐項確認驗證、傳輸與安全設定。

協定

Shadowsocks

為什麼位址正確仍無法連線?Shadowsocks 還需要相符的連接埠、密碼與加密方法等參數,任何一項不一致都可能導致連線失敗。加密方法不是能任意更換的偏好設定;若現有資訊包含額外傳輸參數,也應一併確認,不能只複製位址與密碼。

協定

VMess

只填 UUID 就足夠嗎?VMess 使用 UUID 等識別參數,但完整連線還需要伺服器位址、連接埠、傳輸方式及相應的 TLS 設定。若使用 WebSocket,還要確認路徑與 Host 等相關欄位。不要因為名稱相似,就沿用其他協定的參數組合。

協定

VLESS

VLESS 的安全設定該如何理解?VLESS 使用 UUID 識別使用者,連線保護須依實際傳輸方式與安全設定判斷,不能只看協定名稱。請依現有資訊確認 TLS、伺服器名稱與傳輸欄位;即使位址與 UUID 相同,相關欄位不同也可能無法建立連線。

協定

Trojan

為什麼密碼和伺服器名稱都要檢查?Trojan 通常搭配 TLS,並使用密碼進行驗證;密碼正確不代表憑證驗證一定會通過。請確認連接埠、TLS 伺服器名稱與憑證相關提示。遇到憑證錯誤時,先檢查名稱與裝置時間,不應把關閉驗證當成一般處理方式。

協定

HTTP / SOCKS5

HTTP 與 SOCKS5 可以互換嗎?兩者是不同的代理協定,須選擇與伺服器端一致的類型,並確認連接埠及使用者名稱、密碼等驗證資訊。協定名稱本身不保證傳輸加密,是否有安全傳輸層須依完整設定判斷。不要把網頁網址直接當成可用的代理參數。

協定

WireGuard

WireGuard 為什麼需要多組欄位?它使用金鑰組建立加密通道,還需要對端端點、通道位址與路由範圍等資訊。公鑰與私鑰用途不同,不能對調填寫;私鑰屬於敏感憑證。連線異常時,應依現有設定逐項確認,而非自行產生一組數值取代。

協定

Hysteria2

Hysteria2 的測試為什麼可能受網路影響?它以 QUIC 為基礎,連線取決於網路是否允許 UDP 通訊,也需要正確的驗證與 TLS 參數。若參數看似相同卻無法連線,應先區分驗證問題與網路可達性問題。額外混淆等選項只依現有服務資訊填寫。

03 / Rules & Policies

規則關鍵字與策略

規則由哪些部分組成?先判斷比對條件,再執行對應策略。下方的 example.com 僅供說明語法;看完範例後,請回到自己的設定確認規則順序。

規則關鍵字與策略

Rule

一條規則負責什麼?Rule 會將請求的比對條件對應至處理策略,通常依清單順序由上而下尋找,命中後採用相應策略。較具體的例外應放在範圍較廣的條件之前;排查時先找最早命中的規則,而非只檢查最後新增的項目。

規則關鍵字與策略

DOMAIN

只想比對一個完整網域時該怎麼做?DOMAIN 用於精確比對,例如指定 example.com 時,不會自動涵蓋 www.example.com。條件欄位只填網域,不加 https://、連接埠或網頁路徑。若要涵蓋子網域,應再判斷是否適合使用 DOMAIN-SUFFIX。

DOMAIN,example.com,DIRECT
規則關鍵字與策略

DOMAIN-SUFFIX

如何同時涵蓋根網域與子網域?DOMAIN-SUFFIX 會依網域後綴邊界進行比對;example.com 可涵蓋本身及 www.example.com 等子網域,但不會比對任意包含該字串的網域。若某個子網域需要採用不同策略,應將該網域的具體規則放在這條範圍較廣的規則之前。

DOMAIN-SUFFIX,example.com,PROXY
規則關鍵字與策略

DOMAIN-KEYWORD

要如何比對含有特定字串的網域?DOMAIN-KEYWORD 會檢查網域是否包含指定字串,比對範圍可能涵蓋多種不同的網域後綴。它比完整網域或後綴條件更寬,可能命中原本不打算處理的目標。使用前應先列出預期與非預期的比對案例。

規則關鍵字與策略

GEOIP

GEOIP 如何比對目標?它依據 IP 地理資料庫中的歸屬資訊比對目標位址,而非依據網頁語言或使用者所在位置。資料庫內容與實際網路部署可能不同,目標位址變更也會影響結果。排查時應查看實際解析位址與規則命中情況。

GEOIP,CN,DIRECT
規則關鍵字與策略

IP-CIDR / IP-CIDR6

如何指定一段目標位址?IP-CIDR 用於比對 IPv4 位址範圍,IP-CIDR6 則比對 IPv6 位址範圍;斜線後的前綴長度決定涵蓋範圍。前綴設定過寬會包含更多位址,不能只憑開頭相似就判斷比對正確。目標有兩種位址時,還要分別檢查實際使用的位址類型。

IP-CIDR,192.0.2.0/24,DIRECT
IP-CIDR6,2001:db8::/32,DIRECT
規則關鍵字與策略

USER-AGENT

USER-AGENT 能識別每個 App 嗎?它依據可讀取的 HTTP User-Agent 資訊比對,不等同於依 App 身分判斷。加密請求中的相關資訊通常無法直接讀取,比對能力會受請求可見性影響。撰寫前先確認請求確實包含可用欄位,不要把它當成通用的 App 分流條件。

規則關鍵字與策略

FINAL

前面的規則都未命中時該怎麼辦?FINAL 用來指定最終處理策略,通常放在規則清單末尾。若將它放在具體規則之前,後續條件就無法依預期比對。選擇 DIRECT 或 PROXY 應依自己的設定目標判斷,不要直接把範例當成通用答案。

FINAL,DIRECT
規則關鍵字與策略

PROXY / DIRECT / REJECT

規則命中後會如何處理?PROXY 表示交由代理處理,DIRECT 表示直接連線,REJECT 表示拒絕該請求;實際代理出口還須依目前選取項目與設定判斷。這些是處理結果,不是比對條件。誤用 REJECT 會導致無法存取目標,因此應先確認命中範圍。

04 / Subscription & Configuration

訂閱與設定

匯入成功後,為什麼還要檢查設定?連線項目說明「連線到哪裡」,設定檔說明「如何處理請求」,兩者不能視為同一份內容。

訂閱與設定

訂閱

訂閱網址儲存了什麼?它是用來匯入或更新連線項目的資訊來源;內容格式與更新結果依使用者現有的服務而定,不一定包含完整規則設定。網址可能含有個人存取憑證,不應放在公開截圖、記錄檔或分享文字中。更新後先確認項目,再進行連線測試。

訂閱與設定

伺服器項目

項目名稱能代表可用性嗎?不能。伺服器項目記錄位址、連接埠、協定與驗證等參數,顯示名稱只是方便辨識的標籤。多個項目也可能指向同一個端點。修改前先記錄原有參數,修改後確認目前實際選取的項目,避免測到其他記錄。

訂閱與設定

設定檔

設定檔與訂閱有什麼不同?設定檔用來整理通用設定、規則與其他處理邏輯,常見區段名稱包括 General、Rule、Host 與 URL Rewrite;連線訂閱則主要用於管理連線資訊。儲存檔案與選取檔案使其生效是不同操作。調整前請保留可還原的副本,並逐項驗證修改的影響。

訂閱與設定

URL Rewrite

URL Rewrite 和 DOMAIN 規則是同一回事嗎?不是。URL Rewrite 會依 URL 條件執行重寫等處理,普通分流規則則用來決定連線策略。URL 中的路徑、查詢參數與協定部分都可能影響比對;加密請求的可見性也會限制處理方式。若只需要選擇直連或代理,先確認普通規則是否已足夠。

05 / DNS & Network

DNS 與網路

解析、連線與驗證是同一個步驟嗎?它們屬於不同環節。先確認故障發生在哪一層,再調整對應設定,避免一次變更多個項目而難以判斷結果。

DNS 與網路

DNS

網域無法開啟就一定是 DNS 問題嗎?DNS 負責將網域名稱解析為 IP 位址,解析成功後仍可能在連線、驗證或規則處理階段失敗。先檢查是否取得預期位址,再判斷後續連線狀況。修改 DNS 後應考量快取影響,並保持測試目標一致,不能只憑一次重新整理就下結論。

DNS 與網路

Host

設定檔的 Host 和傳輸參數中的 Host 相同嗎?設定檔的 Host 區段用於靜態網域對應,傳輸參數中的 HTTP Host 則是與請求相關的欄位,兩者用途不同。靜態對應會影響解析結果,目標位址變更後可能需要同步調整。排查時先確認正在查看的是哪一類設定。

DNS 與網路

延遲

數值越低就一定代表存取越快嗎?延遲是特定測試條件下的回應時間,不等同於傳輸吞吐量,也無法代表每個目標網站的使用體驗。比較時應使用相同的測試方式與網路,並實際驗證存取情況。短暫波動或一次逾時不足以說明長期狀態,解讀測試結果時應一併考量測試條件。

DNS 與網路

TLS / SNI

伺服器位址與 SNI 為什麼可能不同?TLS 用於保護連線,SNI 用於在交握時傳送伺服器名稱;連線端點可以是位址,而驗證名稱須與服務設定及憑證相符。請依現有參數填寫,不要任意對調兩者。遇到憑證錯誤時,先確認名稱、裝置時間與憑證狀態,再判斷後續處理方式。

查到術語後,接下來該如何排查?

先用一句話確認目前遇到的問題:是新增資訊失敗、無法建立連線,還是已連線但目標存取異常?分別記錄相關介面用語、協定類型、Global Routing 模式與命中規則,每次只調整一個條件。記錄中應隱去訂閱網址、密碼、私鑰等敏感資訊。

需要實際操作步驟時,請閱讀 教學;需要判斷規則順序時,請閱讀 規則手冊;購買、還原已購項目及首次開啟相關問題,請參閱 疑難排解。系統需求與裝置相容性請以 App Store 頁面標示為準。

返回術語分類 ↑