OFFICIAL MANUAL / GLOSSARY

Shadowrocket 術語表

依介面位置與比對對象查詢用語,區分連線設定與規則策略。

本頁屬於 Shadowrocket 官方手冊。英文介面用語、協定名稱與規則關鍵字均保留原文;說明以 iPhone 和 iPad 的使用情境為主。查到術語後,請先確認它出現的位置,再判斷影響的是伺服器參數、路由方式,還是單筆請求的處理結果。

  • 30 個常用術語
  • 依5大類概念查閱
  • 規則範例僅供教學使用

01 / INTERFACE

介面與開關

同一個英文詞在不同位置可能有不同意思。尤其要區分 Global Routing 的模式、頁面名稱,以及規則中的大寫策略標記。

介面與開關

Home

用來查看伺服器清單、選擇伺服器及操作連線開關的主要頁面。清單中有紀錄,只表示資料已匯入,不代表遠端服務可用,也不代表已建立連線。初次檢查時,請分別確認選取項目、連線開關與系統連線狀態,勿將三者混為一談。

介面與開關

Global Routing

決定整體流量處理方式的設定,設定檔、代理、直連分別對應 Config、Proxy、Direct。排查某個網域為何未依規則處理時,請先確認此處的模式,再檢查規則內容。切換模式不會自動修正伺服器密碼、憑證名稱或其他連線參數。

介面與開關

Config

在 Global Routing 中表示依目前設定檔處理流量:請求可能依規則使用代理、直連或遭到拒絕,因此不代表所有請求都會經過代理。作為頁面名稱時,Config 則是設定檔管理入口。閱讀教學時,請先確認指的是模式還是頁面,避免只匯入檔案卻未選取使用。

介面與開關

Proxy

Global Routing 中的代理模式,讓流量以代理方式處理,而非依目前設定檔逐條分流。它與規則中的大寫 PROXY 屬於不同層級,不能因文字相近就視為同一個開關。測試時仍須確認目前伺服器是否有效;切換模式本身無法解決驗證失敗。

介面與開關

Direct

Global Routing 中的直連模式,表示流量以直連方式處理。目前若處於 Direct,不應將請求未經代理誤判為規則有誤;若要觀察規則分流,請先切回 Config。規則末尾的大寫 DIRECT 只描述該規則命中後的處理方式,不代表全域模式已變更。

介面與開關

On Demand

依據已設定條件觸發連線的機制,與手動操作連線開關並非同一回事。若手動停止後又出現連線,請檢查是否仍符合 On Demand 條件,而非反覆刪除設定。調整時先記下原有條件,每次只變更一項,再觀察相同網路環境下的行為。

02 / PROTOCOLS

協定

協定決定雙方如何建立連線及交換資料,不代表線路品質。請依自己已有的伺服器資料選擇類型,不可只憑名稱或測試數字互換協定。

協定

Shadowsocks

一種代理協定,客戶端與伺服器須使用相符的位址、連接埠、密碼和加密方式。以 ss:// 開頭的文字通常是單筆分享連結,不一定是可更新的訂閱。匯入後仍應確認加密方式與原始資料相符,而非只檢查備註名稱。

協定

VMess

一種需驗證身分的代理協定,UUID 是常見的身分參數,但不是完整的連線設定。是否需要填寫傳輸方式、路徑、Host 與 TLS 等相關參數,取決於伺服器的實際設定。匯入後無法連線時,請逐項比對原始資料,同時確認裝置時間正確,勿只更換伺服器位址。

協定

VLESS

一種代理協定,身分參數、傳輸方式和安全參數共同構成連線設定。UUID 正確不代表其他欄位已完整,安全選項也不能只憑協定名稱自行推斷。使用既有的 vless:// 分享資訊時,請確認匯入後相關欄位仍完整,尤其不要任意更動伺服器要求的參數組合。

協定

Trojan

一種通常搭配 TLS 使用的代理協定,密碼用於驗證,TLS 相關設定則會影響安全連線的建立。伺服器位址與憑證驗證所用名稱可能各有用途,不能看到位址是 IP 就任意清除名稱。遇到憑證錯誤時,請先確認名稱、裝置時間與原始設定,不要直接關閉驗證。

協定

Hysteria2

一種以 QUIC 為基礎的代理協定,須仰賴底層網路支援 UDP。即使位址、連接埠和驗證資訊正確,仍可能因目前網路限制而逾時,因此應分開檢查參數與網路。名稱相近的協定世代不能直接視為相容,請以既有伺服器明確提供的類型為準。

協定

WireGuard

一種以金鑰為基礎的通道協定,介面位址、對端資訊和路由範圍須配套設定。它不使用一般的使用者名稱與密碼組合,不能直接套用其他協定的欄位。私密金鑰是敏感的連線資料;排查或分享設定時應先移除,公開截圖也不應包含完整金鑰。

協定

HTTP / SOCKS5

兩種不同的代理協定,其交握方式、驗證形式與支援的流量類型可能不同。即使位址相同,也不能把 HTTP 連接埠直接當成 SOCKS5 連接埠使用。是否支援 UDP、是否需要驗證,以及是否採用加密傳輸,應分別查核伺服器資料,不能只憑協定名稱判斷。

03 / RULE KEYWORDS

規則關鍵字

先看比對對象,再看處理策略。以下範例使用教學用網域 example.com,不提供實際連線服務;閱讀規則時,也請確認它在目前設定檔中的位置。

規則關鍵字

DOMAIN

用來比對完整網域名稱的規則關鍵字,例如 DOMAIN,example.com,PROXY 指向這個完整網域。它不會只因後綴相同就涵蓋 www.example.com,也不會比對網頁路徑。若只需處理某個明確的主機名稱,可先考慮精確比對,減少對其他網域的影響。

規則關鍵字

DOMAIN-SUFFIX

依網域後綴及其子網域進行比對,例如以 example.com 為條件,可涵蓋該網域及其子網域。這裡的後綴是依網域層級判斷,不是任何文字只要結尾相同就會命中。若網站資源分散在其他網域,請另外確認,不能認為一條後綴規則涵蓋所有相關請求。

規則關鍵字

DOMAIN-KEYWORD

依網域是否包含指定字串進行比對,涵蓋範圍通常比完整網域或後綴比對更廣。含有相同關鍵字的不相關網域也可能命中,因此新增前應確認預期範圍。此規則檢查的是網域,不是網頁內文、搜尋字詞或 URL 路徑;若需精確控制,應優先確認是否適合使用範圍較窄的條件。

規則關鍵字

GEOIP

依據 IP 地理位置資料庫比對,而非根據營運主體所在地或頁面內容判斷。資料庫紀錄可能與實際服務位置不同,使用 CDN 的網站也可能解析至不同位址。排查時應一併考量當下的目標 IP 與規則順序,勿只憑網站名稱認定它應命中哪個地區。

規則關鍵字

IP-CIDR / IP-CIDR6

分別用來比對 IPv4 與 IPv6 位址範圍,斜線後的前綴長度決定涵蓋的網段範圍。位址規則比對的是 IP,不是網域文字;網域解析結果改變時,命中的位址範圍也可能不同。撰寫規則前應確認位址類型與前綴長度,避免原本只想比對單一位址,卻涵蓋整個網段。

規則關鍵字

FINAL

前面的規則都未命中時使用的兜底關鍵字,例如 FINAL,DIRECT 表示其餘請求採用直連策略。FINAL 應放在規則清單最後,否則後續精確規則無法發揮預期作用。變更兜底策略會影響所有未被前面規則涵蓋的請求,請先確認影響範圍,再儲存並測試。

規則關鍵字

PROXY / DIRECT / REJECT

規則中的策略標記,分別代表代理、直連和拒絕,通常位於規則的處理結果部分。它們回答「命中後如何處理」,而 DOMAIN 等關鍵字回答「比對什麼」。策略欄位也可能引用設定檔中定義的策略群組名稱,此時應確認群組名稱與實際選取項目,不能只檢查規則條件。

規則關鍵字

規則比對順序

規則清單通常由上而下尋找第一個命中項目,後面的規則不會自動覆蓋先前的命中結果。精確的例外規則一般應放在可能涵蓋它的廣泛規則之前,FINAL 則放在最後。若某條規則看似正確卻未生效,應先檢查上方是否已有較早命中的規則,再考慮新增重複規則。

04 / SUBSCRIPTION & CONFIG

訂閱與設定檔

伺服器清單回答「可連線至哪些遠端服務」,設定檔回答「如何處理流量」。兩者彼此相關,但匯入、更新和選取使用是不同操作。

訂閱與設定檔

Subscribe

與訂閱管理相關的介面用語;訂閱通常透過網址取得並更新一組伺服器紀錄。請使用自己已有的訂閱網址,並依實際連結類型匯入,勿將伺服器清單與設定檔視為相同內容。訂閱更新只代表系統嘗試重新取得清單,不代表其中每台伺服器都能建立連線。

訂閱與設定檔

Add Server

新增伺服器資料的入口;手動輸入時,應先選擇正確的協定,再依既有資料填寫位址、連接埠與驗證參數。不同協定所需欄位並不相同,不能看到空白欄位就自行套用其他協定的填寫方式。儲存後先確認紀錄,再測試連線;詳細操作順序請參閱使用教學。

訂閱與設定檔

伺服器

指客戶端建立代理連線時所連接的遠端服務,介面清單中的一筆紀錄通常會儲存其連線參數。備註名稱只是方便辨識的標籤,無法證明地理位置、可用性或驗證狀態。連線失敗時,請比對實際位址、連接埠與協定參數,而非只依備註文字判斷。

訂閱與設定檔

設定檔

用來整理規則、DNS 和其他運作設定的檔案,有別於只列出伺服器的訂閱內容。匯入設定檔與選取設定檔是兩個操作;檔案已存在不代表目前正在使用。修改前請保留可還原的原始設定,修改後確認目前設定檔及 Global Routing,才能判斷預期規則是否已參與處理。

05 / DNS & NETWORK

DNS 與網路

解析、建立連線與載入內容是不同階段。單次測試結果只能說明它實際涵蓋的流程;排查時應保持測試條件一致。

DNS 與網路

DNS

將網域名稱解析為 IP 位址的機制,是許多連線建立前的必要步驟。解析成功不代表後續連線一定成功,伺服器延遲正常也無法證明目標網站的 DNS 正常。排查時應區分伺服器網域與目標網站網域,記錄失敗階段,再確認相關解析設定,避免一次更換所有選項。

DNS 與網路

Connectivity Test

用來輔助檢查連線狀況的測試入口,結果取決於測試目標、測試方式及當下網路條件。測試成功只表示這次測試所涵蓋的路徑可連通,不保證所有網站、協定或資源都能載入。若測試成功但網頁無法開啟,請進一步檢查目標網域解析、路由命中情況與實際請求錯誤。

DNS 與網路

延遲

測試請求往返所需的時間,通常以毫秒顯示,反映特定測試條件下的回應耗時。延遲不是頻寬,也不直接等於網頁載入速度;不同測試方式所得數值不適合直接比較。判斷異常時,應在相同網路與測試目標下重複觀察,並參考實際連線結果,而非只選擇數字最低的項目。

DNS 與網路

UDP

一種傳輸層協定,不提供與 TCP 相同的可靠、有序傳輸機制;上層應用程式可依自身協定處理封包遺失與重傳。相關服務能否運作,須同時獲得客戶端設定、伺服器能力與底層網路支援。若部分服務可用、部分逾時,請先確認它們是否依賴不同傳輸方式,不要只因網頁能開啟就排除網路問題。

返回術語表頂端 ↑