官方手冊 · 術語參考
Shadowrocket 術語表
依介面所在位置查找用語,再分辨通訊協定、比對條件與執行策略。英文名稱維持原樣;每個項目都可透過標題旁的連結直接前往。
Global Routing
DOMAIN-SUFFIX
FINAL
介面與開關
先確認用語出現的位置。Global Routing 中的模式、Config 頁面,以及設定檔中的策略,並非同一層級的設定。
- Home
- 主畫面可查看伺服器列表、目前選取項目與連線開關。列表中出現項目,只代表資訊已新增,不表示連線成功。初次使用時,請依序確認選取的伺服器、Global Routing 模式與連線狀態,避免把匯入成功當成已完成連線驗證。
- Global Routing
- 全域路由設定,決定流量整體採用哪種處理方式。三種模式為 Config(設定檔)、Proxy(代理)、Direct(直連);若要讓設定檔中的分流規則生效,請選擇 Config。排查問題時先記下目前模式,避免在 Proxy 模式下修改規則,卻誤以為規則沒有儲存。
- Config
- 在 Global Routing 中,Config 表示依目前設定檔處理流量。在頁面入口中,Config 則連至設定管理,用來查看及選取設定檔。判斷文件中的意思時,須依所在位置區分:開啟 Config 頁面與將路由模式設為 Config,是相關但不同的操作。
- Proxy
- Global Routing 中的代理模式,讓可處理的流量經由所選代理路徑傳送。可暫時用來確認代理路徑是否可用,但不能取代規則順序檢查。此處的 Proxy 指整體模式,與規則行末的大寫策略 PROXY 不同層級。
- Direct
- Global Routing 中的直連模式,讓流量直接連線至目標。可作為排查時的對照條件,但直連正常不代表代理伺服器的位址、驗證或傳輸設定正確。比較完成後,請恢復原本需要的模式,再驗證設定規則。
- On Demand
- 隨選連線設定,依應用程式與系統提供的條件觸發連線。它設定的是何時建立連線,而非某個網域應採用 PROXY 還是 DIRECT。設定後須在實際網路條件改變時進行驗證;手動中斷連線後的狀況,也應依目前的隨選條件判斷。
- Connectivity Test
- 連線測試用來查看伺服器在目前網路與測試方式下是否有回應,結果可能顯示延遲或失敗。延遲代表單次測試的回應時間,不等於檔案傳輸速度,也無法保證所有目標都能連線。若持續異常,請核對測試範圍、伺服器參數與系統時間。
通訊協定
通訊協定決定用戶端與伺服器的通訊方式。請依現有伺服器資料選擇類型,不要根據名稱、連接埠或延遲猜測參數。
- Shadowsocks
- 一種代理通訊協定,常見設定包含伺服器位址、連接埠、密碼與加密方式。加密方式必須與伺服器端一致,不可因列表中有相近名稱就任意替換。如果資料還包含外掛程式或其他選項,也應逐項核對;不可只填入位址與密碼就認定設定完整。
- VMess
- 一種代理通訊協定,設定通常包含使用者識別碼、伺服器位址與連接埠。實際連線也可能需要傳輸方式、路徑、Host 與 TLS 等設定,請以現有伺服器資料為準。匯入後可確認這些欄位是否保留,但不要以公開範例中的值覆蓋自己的設定。
- VLESS
- 一種代理通訊協定,名稱與 VMess 相近,但不是可互換選用的同一類型。請依伺服器資料核對驗證資訊、傳輸方式與安全設定,不可只複製位址和連接埠。某項傳輸選項是否可用,仍須以目前應用程式實際提供的設定為準。
- Trojan
- 一種使用 TLS 的代理通訊協定。除了位址、連接埠與密碼,也須留意用於憑證驗證的主機名稱。連線位址與憑證主機名稱可能用途不同,不可只因兩者不相同就擅自改成一致。若遇到憑證錯誤,請先核對主機名稱、憑證有效性與裝置時間。
- Hysteria2
- 一種以 QUIC 為基礎的代理通訊協定,連線仰賴目前網路對 UDP 的實際支援。即使位址與驗證資訊正確,仍可能因網路狀況而逾時。排查時應分別檢查目前網路、伺服器端狀態與通訊協定參數,不要直接將單次逾時歸因於密碼錯誤。
- WireGuard
- 一種以金鑰為基礎的通道通訊協定,設定包含本機金鑰、對端公開金鑰、對端位址與通道位址等資訊。各欄位用途不同,只有伺服器位址無法還原完整設定。私密金鑰屬於敏感資訊,分享截圖或提交排查資料前應先遮蔽,不應放入公開的設定片段。
- HTTP / SOCKS5
- 兩種不同的代理通訊協定,請依伺服器實際提供的類型選擇。連接埠相同不代表通訊協定相同;是否需要使用者名稱、密碼,以及支援哪些流量,也須分別核對。HTTP 代理這個名稱本身,不代表用戶端與代理伺服器之間必定採用 TLS 加密。
規則關鍵字與策略
一條規則通常由比對類型、比對內容與策略組成。先確認是否符合,再查看符合後如何處理;不要將通訊協定名稱當成規則類型。
規則閱讀範例
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,PROXY
第一行比對指定的網域後綴,第二行比對一個 IPv4 私有網段,最後一行則處理前面規則都未符合的流量。這是語法範例,並非適用於所有裝置的完整設定。
- [Rule]
- 設定檔中放置分流規則的區段;方括號表示區段名稱,不是網域比對條件。規則通常由上而下檢查,符合後便採用該規則指定的策略,因此具體規則應放在可能涵蓋它的廣泛規則之前。規則生效的前提是目前採用 Config 模式,且已選取對應設定檔。
- DOMAIN
- 依完整網域名稱比對的規則類型,例如
DOMAIN,example.com,PROXY。此規則只比對指定網域,不會自動涵蓋所有子網域。若要涵蓋www.example.com等子網域,請視需求新增完整網域規則,或使用 DOMAIN-SUFFIX。
- DOMAIN-SUFFIX
- 依網域名稱後綴比對的規則類型;
DOMAIN-SUFFIX,example.com,PROXY可涵蓋該網域及其子網域。此處應填入網域名稱,不要填完整網頁網址、通訊協定前綴或頁面路徑。這種比對會依網域邊界判斷,不等同於在任意位置搜尋一段文字。
- DOMAIN-KEYWORD
- 依網域名稱中出現的關鍵字比對,例如
DOMAIN-KEYWORD,example,PROXY。關鍵字越短,可能涵蓋越多無關網域,因此不可只因寫法簡短就拿來取代精確規則。若發生錯誤分流,請檢查關鍵字範圍,以及該規則在列表中的位置是否過前。
- GEOIP
- 依 IP 地理位置資料庫進行比對,例如
GEOIP,CN,DIRECT。判斷依據是位址歸屬資料,不是網頁語言、營運者名稱或網域後綴。若目標使用分散式服務,解析出的位址與資料庫紀錄都可能影響比對結果,請搭配連線紀錄判斷。
- IP-CIDR / IP-CIDR6
- 分別用於比對 IPv4 與 IPv6 網段;斜線後的數字是前綴長度,不是連接埠號碼。例如
192.168.0.0/16表示一個網段,而非單一伺服器。只設定 IPv4 網段無法涵蓋 IPv6 目標,排查時須確認連線實際使用的位址類型。
- FINAL
- 前面的規則都未符合時採用的預設規則,通常放在規則列表末尾。
FINAL,PROXY表示剩餘流量交由代理路徑處理,不代表代理連線失敗後會自動改為直連。若 FINAL 放得太前面,後續規則可能沒有機會檢查。
- PROXY
- 規則中的代理策略,表示符合條件的流量交由代理路徑處理。它只指定處理方向,不會替使用者補上伺服器位址、密碼或通訊協定參數。請注意,大寫 PROXY 是規則策略;首字母大寫的 Proxy 則可指 Global Routing 中的整體代理模式。
- DIRECT
- 規則中的直連策略,表示符合條件的流量直接連線至目標,不經該代理伺服器轉送。這不保證目標一定可連線,結果仍取決於目前網路、DNS 與目標服務狀態。若要讓特定本機位址直連,應先確認正確網段,再將具體規則放在適當位置。
- REJECT
- 規則中的拒絕策略,用來阻擋符合條件的請求。它不是代理無法使用時的修復選項,誤用會讓原本可連線的目標直接失敗。若排查某個應用程式部分內容無法顯示,請檢查是否有範圍過廣或順序過前的 REJECT 規則符合相關網域。
訂閱與設定檔
伺服器列表決定連線到哪裡,設定檔則決定如何處理流量。兩者可能相關,但更新其中一項不代表另一項也會更新。
- Subscribe
- 與匯入及更新訂閱相關的用語,可從使用者現有的訂閱網址讀取伺服器項目。更新訂閱可能改變項目數量、名稱與參數,但不等於更新規則設定檔。訂閱網址可能包含身分憑證,不應公開;更新失敗時,請先核對網址是否完整及目前是否有效。
- Server / Add Server
- Server 指一筆伺服器設定,日常也稱為節點;Add Server 是新增伺服器的入口。伺服器名稱只是方便辨識的標籤,真正影響連線的是通訊協定、位址、連接埠與驗證等欄位。手動新增時請以現有伺服器資料為準;儲存後仍須進行測試並實際確認是否能連線。
- Configuration File
- 設定檔以區段整理一般設定、分流規則、主機對應與重寫內容,常見區段名稱包括 [General]、[Rule]、[Host] 與 [URL Rewrite]。設定檔與伺服器列表並非同一份資料。編輯前請保留原設定;修改後確認目前選用的檔案,避免只修改到未啟用的副本。
- [Host]
- 設定檔中指定主機名稱對應的區段,可為特定網域指定解析結果。手動對應可能讓該網域繼續使用舊位址,因此網域連線異常時,不能只檢查 DNS 伺服器。不要將他人環境中的整段對應直接複製到自己的設定;確有需要時,請記錄用途與還原方式。
- [URL Rewrite]
- 設定檔中整理 URL 重寫規則的區段,可依規則變更或處理符合條件的請求網址。這與 [Rule] 中選擇 PROXY、DIRECT 或 REJECT 的分流機制不同,兩者不能互相取代。加密連線的可見範圍也受連線方式與相關設定限制,不應假設任意網址都能直接重寫。
系統與安裝
請區分網域解析、系統授權與應用程式取得方式。系統顯示通道已建立,不代表所有伺服器和目標服務都已確認可用。
- DNS
- 網域名稱系統會將
example.com這類網域名稱解析為 IP 位址。解析失敗與連不上代理伺服器是不同問題,排查時應分別驗證。設定中的dns-server = system表示使用系統 DNS;更換 DNS 後,也應留意快取與 [Host] 對應的影響。
- VPN Configuration
- 系統用來建立網路通道的設定授權;首次連線時,可能需要使用者在系統提示中確認。允許新增設定,只代表應用程式取得相應權限,不代表遠端伺服器已通過驗證。授權後若仍無法連線,請逐項檢查伺服器參數、Global Routing 與連線紀錄。
- Purchased
- App Store 中的已購項目,可用來尋找原帳號購買過的應用程式,並依商店規定重新下載。更換 iPhone / iPad 或重新安裝時,請先確認使用原購買帳號,並檢查應用程式是否仍可下載。找不到項目時,先核對購買紀錄與帳號地區,不要只根據搜尋結果就認定需要再次購買。