官方手冊 / 名詞解釋

Shadowrocket 名詞解釋

先辨認設定所屬層級,再檢查參數與規則。介面詞彙、協定名稱與規則關鍵字保留英文原文;中文說明則用來解釋其用途,以及哪些情況不能據此推斷。

需要操作步驟,請參閱入門指南;需要依裝置取得應用程式,請查看全平台下載頁。本頁不提供、不販售,也不推薦節點或訂閱。

01 / 介面與開關

連線狀態與處理模式

清單、開關與路由模式各有用途。項目出現、項目已選取與連線已建立,是不同的狀態。

介面與開關

Home

Home 用於查看現有伺服器項目及連線相關狀態,通常也是開始檢查所選項目的位置。項目出現在清單中只表示資訊已儲存,不代表伺服器已可連線;排查時還應確認目前選取的項目、連線開關與實際要求結果。

介面與開關

Global Routing

Global Routing 決定整體流量處理模式:設定對應 Config、代理對應 Proxy、直連對應 Direct。Config 依目前的設定規則處理連線,Proxy 與 Direct 則採用各自的整體模式;這與單條規則末尾的 PROXY、DIRECT 動作不在同一層級。排查分流前,請先確認此處設定。

介面與開關

On Demand

On Demand 依既有條件請求系統按需建立連線,不應理解為持續偵測並修復所有連線故障。此功能無法修正錯誤的伺服器密碼、連接埠或傳輸參數;調整前請先確認手動連線可用,再檢查條件與系統權限。

介面與開關

Add Server

Add Server 是手動新增伺服器項目的入口,應逐項填入使用者現有的伺服器資訊。先選擇正確的協定類型,再檢查位址、連接埠、認證與傳輸參數;不同類型的欄位不能只因名稱相似就互相套用。

介面與開關

Connectivity Test

Connectivity Test 用於檢查目前測試目標與測試方式下的連線狀況,結果會受到本機網路、伺服器回應及目標狀態影響。顯示的耗時不等於檔案下載速度,測試成功也不代表所有應用程式要求都會成功;請依實際失敗的目標進一步確認。

介面與開關

DNS

DNS 負責將網域名稱解析為 IP 位址,解析結果會影響後續連線及部分位址規則的判斷。網域無法開啟,問題可能發生在解析階段,也可能出在連線階段;修改 DNS 前請先區分這兩種情況,避免同時更改多項設定而無從比較。

02 / 協定

類型、認證與傳輸

協定名稱只說明部分連線機制。請依使用者現有資訊檢查完整參數,不要只憑協定名稱推斷速度或可用性。

協定

Shadowsocks

Shadowsocks 是一種代理協定,基本資訊包括伺服器位址、連接埠、加密方式與密碼。用戶端選項必須與伺服器端一致;即使位址和連接埠相同,只要加密方式不同,仍可能無法通訊,不能只憑項目名稱判斷設定正確。

協定

VMess

VMess 使用識別碼與相關認證參數,實際連線也可能搭配不同的傳輸方式和 TLS 設定。檢查時應分別確認識別碼、傳輸路徑、伺服器名稱等項目;系統時間明顯不準也可能影響認證,不要只是不斷更換連接埠。

協定

VLESS

VLESS 將身分認證與傳輸層設定分開處理,設定時須同時檢查識別碼與搭配的傳輸參數。協定名稱本身不代表內容已加密,實際保護方式取決於搭配的安全機制;匯入後不要自行將安全選項改成看似相近的值。

協定

Trojan

Trojan 通常搭配 TLS 使用,認證密碼、連接埠與伺服器名稱都可能影響連線結果。憑證驗證失敗時,應檢查裝置時間、伺服器名稱與憑證是否相符,不要把關閉驗證當作一般處理方式;參數應以使用者現有的伺服器資訊為準。

協定

Hysteria2

Hysteria2 以 QUIC 為基礎,連線仰賴相應的 UDP 通訊條件,也涉及認證與 TLS 參數。一般網頁可開啟,不代表同一網路允許所需的 UDP 通訊;排查時應分別檢查本機網路、伺服器監聽狀態與設定內容,不要只憑協定名稱預測傳輸表現。

協定

WireGuard

WireGuard 是使用公私鑰識別對端的通道協定,金鑰、對端位址、通道位址及路由範圍必須彼此對應。完成交握與目標位址可連線是不同的檢查項目;私鑰屬於敏感資訊,公開排查資料時應予以移除,不要直接公開完整設定檔。

協定

HTTP

HTTP 作為伺服器類型時,表示 HTTP 代理,而不是要將目標網頁網址填入伺服器位址欄。是否需要使用者名稱、密碼及 TLS,取決於代理的實際設定;目標網頁使用 HTTPS,也不代表用戶端到代理之間必定使用 TLS。

協定

SOCKS5

SOCKS5 是一種通用代理協定,可依伺服器設定使用使用者名稱和密碼認證,但協定本身不會加密內容。能否使用 UDP 還取決於兩端實作與網路狀況;TCP 要求可用,不代表所有依賴 UDP 的要求也可用。

03 / 規則關鍵字

比對對象與書寫範圍

規則由上而下檢查,第一條符合條件的規則會決定動作。範例使用保留網域與文件專用位址,僅用來說明格式。

規則關鍵字

DOMAIN

DOMAIN 精確比對指定網域,例如 DOMAIN,example.com,DIRECT。這條規則不會自動涵蓋 www.example.com;若要涵蓋子網域,應確認是否適合改用 DOMAIN-SUFFIX,而不是自行猜測比對範圍。

規則關鍵字

DOMAIN-SUFFIX

DOMAIN-SUFFIX 比對指定網域及其子網域,例如 DOMAIN-SUFFIX,example.com,PROXY 會同時涵蓋該網域及其下層網域。比對依據是網域邊界,不會因其他網域含有相似字串就符合,適合用來設定同一網域體系的共同行為。

規則關鍵字

DOMAIN-KEYWORD

DOMAIN-KEYWORD 檢查網域是否包含指定字串,例如 DOMAIN-KEYWORD,ads,REJECT。此規則不要求完整網域或網域後綴相同,因此較短的關鍵字可能誤擋正常要求;新增前應先確認連線記錄中的完整網域。

規則關鍵字

GEOIP

GEOIP 依 IP 地理資料庫分類比對目標位址,例如 GEOIP,CN,DIRECT。資料庫結果並非對營運主體或使用者所在地的判斷;同一網站使用多個位址時,分類也可能不同,應參照實際目標位址確認。

規則關鍵字

IP-CIDR / IP-CIDR6

IP-CIDR 用於比對 IPv4 網段,IP-CIDR6 則用於 IPv6;斜線後的前綴長度決定涵蓋範圍。IP-CIDR,192.0.2.0/24,DIRECT 是文件專用位址範例;規則比對的是目標位址,而非網頁名稱。修改前綴長度會改變影響範圍。

規則關鍵字

FINAL

FINAL 用於處理未符合前面規則的連線,例如 FINAL,PROXY 指定預設動作。通常應放在規則清單末尾;若提早出現,後續規則可能沒有機會處理連線。因此排查規則順序時,除了內容,也要檢查位置。

04 / 策略動作

符合規則後的連線處理

實心圓點、空心圓圈與斜線圓圈分別標示三種動作。這些符號只是本站用於閱讀的標記,並非應用程式內的狀態指示。

策略動作

PROXY

PROXY 是規則中的代理動作,符合條件後會依目前選取的代理處理該連線。它不會自動提供伺服器,也不保證所選伺服器可連線;若規則已符合但要求仍失敗,還須檢查現有伺服器項目、認證參數與連線狀態。

策略動作

DIRECT

DIRECT 表示符合條件的連線不經代理伺服器,而是透過本機網路直接存取目標。直連仍可能受到 DNS、路由或目標服務故障影響,並不保證一定成功;這是單條規則的動作,應與 Global Routing 中的 Direct 模式分開理解。

策略動作

REJECT

REJECT 用於拒絕符合條件的連線,常見檢查項目包括比對條件是否設得太寬,以及是否排在更具體的規則之前。網頁內容無法載入或應用程式部分功能失效時,可先查看記錄,確認是否符合此動作,再修改對應條件,避免一次停用所有規則。

05 / 訂閱與設定

項目、設定與復原

訂閱負責更新項目,設定負責管理處理規則,購買紀錄則用來重新取得應用程式。三者不能互相取代。

訂閱與設定

Subscribe

Subscribe 透過使用者現有的訂閱網址取得或更新伺服器項目,網址須向使用者自己的服務供應商取得。更新可能變更項目內容與數量,手動修改也可能遭到覆寫;訂閱網址可能包含存取憑證,應避免放入公開截圖、記錄檔或共用文件。

訂閱與設定

SERVER

SERVER 表示伺服器相關項目或資訊,通常包含位址、連接埠、協定與認證參數。伺服器項目主要說明「如何連線」,不等同於包含 DNS、規則與其他設定的完整設定;匯入伺服器資訊後,不應假設分流規則也已一併建立。

訂閱與設定

Config

Config 可表示設定檔管理入口,也會出現在 Global Routing 的設定模式名稱中,須依所在位置判斷。匯入檔案與選取啟用是兩項不同操作;調整前請先備份目前檔案,再確認實際生效的項目,避免誤以為匯入成功就代表已完成切換。

訂閱與設定

iCloud 同步

iCloud 同步是在支援此功能的裝置與設定條件下同步相關資料的方式,實際範圍以應用程式和系統提供的選項為準。同步不等於獨立備份,刪除或修改也可能同步至其他裝置;移轉前應確認內容,並另行保留需要的設定匯出檔案。

訂閱與設定

已購項目

已購項目是 App Store 中查看同一購買帳號過往取得之應用程式的入口,重新取得應用程式不會自動還原設定。iPhone / iPad 版在 App Store 一次性付費 $2.99;Mac / Windows / Android / Linux 版免費。重新取得應用程式與還原伺服器服務是兩回事。