[術語表]官方手冊 · 術語參考

Shadowrocket 術語表

依介面位置與設定用途查找術語。先確認目前看到的是開關、協定還是規則關鍵字,再核對參數;同一個英文詞出現在不同位置時,意思可能不同。

介面用語保留英文 規則關鍵字區分大小寫 範例網域不代表可用服務

[Interface]

介面與開關

先區分介面名稱與路由模式。Global Routing 中的設定、代理、直連分別對應 Config、Proxy、Direct;其中 Config 也可能指管理設定檔的介面。

Home
用來查看伺服器項目、選擇連線目標及控制連線的介面。清單中出現項目,只表示資訊已儲存,不代表驗證、解析或連線已成功。初次使用時,請先確認選取的項目,再檢查連線開關及系統顯示的連線狀態。
Global Routing
決定請求採用哪種整體路由方式的設定。Config 依設定處理請求,Proxy 使用代理模式,Direct 使用直連模式;這不是選擇伺服器協定的項目。排查某條規則似乎未生效時,應先確認目前是否選取 Config,再檢查規則順序。
Config
作為 Global Routing 選項時,表示依照目前設定中的規則與設定處理請求。作為介面名稱時,則指管理、選取及編輯設定檔的位置,因此「已匯入 Config」和「目前以 Config 路由」並非同一回事。修改檔案後,請確認目前使用的是該檔案,而非名稱相近的其他副本。
Proxy
Global Routing 中的代理模式,適用的請求會交由目前代理處理,但仍須考量系統與設定中的略過範圍。它不會代為補齊伺服器位址、密碼或傳輸參數,也不保證所選伺服器可連線。介面中的 Proxy 與規則中的大寫 PROXY,應依各自所在位置解讀。
Direct
Global Routing 中的直連模式,讓適用的請求透過目前網路直接連至目標。這有助於確認問題是否只發生在代理路徑,但切換後能開啟某個目標,不足以證明原有伺服器參數都正確。直連仍取決於目前網路、DNS 與目標服務是否可用。
Add Server
手動新增伺服器資訊的入口;使用前請準備好已有的伺服器參數。先選擇正確的協定,再逐項填寫 SERVER、連接埠、驗證及傳輸相關欄位;不同協定中名稱相同的欄位不一定能互換。成功儲存只代表項目已建立,之後仍須測試連通性。
Connectivity Test
用來測試項目連通性的功能;結果會受測試方式、目標位址及目前網路狀況影響。顯示的耗時不等於實際下載速度,測試通過也不代表所有網站、UDP 請求或長連線都能正常運作。排查時應記下測試方式,並搭配實際存取結果與 Log 一起判斷。

[Settings]

Settings 設定項目

設定會影響解析、觸發連線、測試與記錄等行為。此處說明概念,不假設所有平台的選單位置或預設值都相同;實際設定值請以目前介面與使用中的設定為準。

DNS
將網域名稱解析為 IP 位址的機制,是許多連線開始前的必要步驟。解析失敗與代理驗證失敗是不同問題,通常無法靠修改代理密碼解決網域解析錯誤。核對時應分別查看解析伺服器、解析請求所走的路徑,以及解析出的位址是否符合預期;避免同時更改多個設定,以免無從比較。
On Demand
依照設定條件觸發連線的機制,不等於「任何情況下都會持續保持連線」。觸發條件、系統狀態與網路變化都會影響實際行為;手動關閉後是否會再次連線,也須依目前設定判斷。修改後請分別在相關 Wi-Fi、行動網路或網路切換情境中測試,不要只確認開關已開啟。
Ping
在設定或測試說明中,常用來指與連通性探測有關的項目;具體意義取決於採用的測試方式。不要把所有以毫秒顯示的結果都當成相同的 ICMP 往返時間,更不能直接換算成頻寬。比較兩個項目時,應盡量維持測試方式、測試目標與網路狀況一致。
Log
排查連線過程時可參考的記錄,有助於區分解析、建立連線、驗證或協定交涉等階段的問題。請先重現一次故障,再查看相近時間的相關記錄,避免把舊錯誤誤認為目前原因。分享記錄前,請移除訂閱網址、驗證資訊、伺服器私有資訊,以及可能識別個人存取行為的內容。
iCloud 同步
透過 iCloud 在支援的 Apple 裝置間同步應用程式支援資料的方式;實際同步範圍以目前應用程式設定為準。同步不會即時轉移連線狀態,也不能取代經確認可還原的獨立備份。更換裝置後,請逐項檢查伺服器項目、設定檔選擇及同步狀態;確認完成前,請勿刪除舊裝置上的資料。

[Protocol]

協定

協定名稱用來辨認連線方式,不代表服務品質或預設參數。以下說明以使用者已有的伺服器資訊為前提;匯入後仍須確認協定、驗證、安全層與傳輸方式彼此相符。

Shadowsocks
一種代理協定,常見設定包括伺服器位址、連接埠、密碼與加密方式。加密方式與密碼都須和伺服器端一致;只修改名稱不會改變協定行為。如果現有設定包含其他傳輸參數,也應依原始資料核對,不能只複製位址和連接埠就認為設定完整。
VMess
使用使用者識別碼等參數進行驗證的代理協定,常見設定也包含傳輸方式與 TLS 設定。伺服器位址、使用者識別碼與傳輸層參數各有不同用途,不能以其中一個欄位取代另一個。遇到連線失敗時,也請確認裝置時間是否正確,再依原始參數逐項排查。
VLESS
一種代理協定,使用者識別碼、傳輸方式與安全層設定須分別確認。不能只憑 VLESS 這個名稱推斷是否啟用 TLS,也不能直接套用其他傳輸方式的路徑或 Host。若匯入後項目存在但無法連線,應優先比對原始設定中的驗證與傳輸相關欄位。
Trojan
通常透過 TLS 保護傳輸的代理協定,須確認密碼、伺服器位址、連接埠與 SNI 等資訊。SNI 用於 TLS 交握中的伺服器名稱指示,不一定與連線位址相同,請依既有服務參數填寫。發生憑證錯誤時,請先檢查名稱、系統時間與憑證設定;不應將 Allow Insecure 當成一般修復方式。
HTTP / SOCKS5
兩種不同的代理協定,在驗證、目標連線與傳輸能力方面各有不同。HTTP 代理可透過 CONNECT 建立通道,但協定名稱本身無法證明用戶端與代理伺服器之間已加密。新增時應確認伺服器提供的是哪種協定,並核對驗證方式及是否另有 TLS 要求。
WireGuard
以金鑰驗證並使用 UDP 傳輸的通道協定,設定包含金鑰、端點、位址與路由等資訊。金鑰欄位不能當成一般使用者名稱或密碼,私鑰也不應出現在公開截圖與記錄中。排查時須同時考量 UDP 是否可連通、金鑰是否配對,以及通道內的位址與路由,而不只是端點網域名稱。
Hysteria2
以 QUIC 為基礎的代理協定,建立連線與傳輸都取決於目前網路是否能使用 UDP。匯入時須配合伺服器端的驗證、連接埠、TLS 等相關設定;協定名稱不能取代這些具體參數。如果某個網路下無法連線、另一個網路卻正常,應結合網路狀況分析,不宜只靠反覆修改密碼判斷原因。

[Rule]

規則關鍵字

規則通常由上而下比對,最先符合的規則會決定採用的策略。閱讀一行規則時,依序辨認比對類型、比對條件與策略;網域規則和 IP 規則所依據的資訊不同。

DOMAIN
精確比對指定網域名稱的規則關鍵字,例如 DOMAIN,example.com,DIRECT。這條規則不會自動涵蓋 www.example.com,後者是另一個網域。若只想調整單一完整網域的策略,可先考慮這種比對範圍明確的方式。
DOMAIN-SUFFIX
依網域後綴邊界比對指定網域及其子網域,例如 DOMAIN-SUFFIX,example.com,PROXY。它可涵蓋 example.com 和 api.example.com,但不是比對任意包含字串的規則。若某個子網域需要例外處理,應將範圍更明確的規則放在這條廣泛規則之前。
DOMAIN-KEYWORD
依網域是否包含指定字串進行比對,例如 DOMAIN-KEYWORD,example,PROXY。其涵蓋範圍通常比精確網域與後綴規則更廣,也可能符合彼此無直接關係的網域。使用前應確認需要的是字串比對,還是指定網域及其子網域的範圍比對。
IP-CIDR
依 IPv4 網段比對目標位址;CIDR 中斜線後的數字代表網路前綴長度。例如 IP-CIDR,192.168.0.0/16,DIRECT 可用來指定這個私有位址範圍的策略。它比對的是位址而非網站名稱;請求是否有可供比對的位址資訊,也會影響規則判斷。
IP-CIDR6
依 IPv6 網段比對目標位址,使用適用於 IPv6 位址的前綴表示法。IPv4 的 IP-CIDR 項目不會自動涵蓋 IPv6,因此同一目標透過不同位址類型連線時,可能符合不同規則。排查「相同網域名稱偶爾採用不同策略」時,應一併檢查解析結果中的 IPv4 與 IPv6。
GEOIP
依據 IP 地理資料庫中的歸屬資訊比對目標位址,例如 GEOIP,CN,DIRECT。資料庫記錄不等於使用者所在地、內容使用的語種或網站經營者所在地,也可能因實際部署變更而有時間差。若要穩定處理特定網域,不宜只靠 GEOIP 推斷該網域的所有連線行為。
FINAL
為未符合前序規則的請求指定最終策略,通常放在規則清單末尾。例如 FINAL,PROXY 表示其餘請求交由 PROXY 處理,不會重新從第一條規則開始比對。若大量請求都符合 FINAL,應先檢查前序規則的範圍、順序,以及目前是否使用預期的設定檔。
PROXY / DIRECT / REJECT
規則中常見的策略標識,分別代表交由代理策略處理、直接連線及拒絕請求。這些是規則符合後的處理結果,不是 Shadowsocks 或 VLESS 這類協定;PROXY 最後使用哪個目標,還須參照目前選取的代理與設定。REJECT 代表主動拒絕,不要將因此產生的連線失敗誤判為伺服器無法連線。

[Profile]

訂閱與設定

伺服器項目用來描述連線目標,設定檔則用來描述處理規則,兩者不可混為一談。本網站僅說明如何管理使用者已有的訂閱或伺服器資訊,不提供、銷售或推薦節點或訂閱。

Subscribe
透過使用者已有的訂閱網址取得並更新伺服器項目的功能;網址應向自己的服務供應商取得。連結可能包含可識別帳號或授權存取的參數,請妥善保管,不要公開張貼。更新訂閱通常只會更新由該訂閱管理的項目,不能據此推斷整份規則設定或手動編輯內容也已同步更新。
SERVER
伺服器位址欄位,通常填寫網域名稱或 IP 位址,並搭配獨立的連接埠及驗證欄位使用。除非欄位明確要求完整連結,否則不要直接將訂閱網址、網頁網址或含路徑的 URL 當成伺服器網域名稱填入。介面中的伺服器記錄通常還包含協定等參數,因此只有 SERVER 欄位內容不足以建立連線。
設定檔
包含 [General]、[Rule] 等設定與規則的文件,用來描述如何處理請求。匯入檔案不代表已選用該檔案,也不代表 Global Routing 已切換至 Config。編輯前請保留可還原的副本;修改後應以明確的目標請求驗證符合規則的行為,而非只確認檔案能否儲存。
URL Rewrite
依條件改寫請求 URL 或執行相應處理的機制,與決定請求採用哪條連線路徑的路由規則屬於不同層面。它不會因為某條 DOMAIN-SUFFIX 規則符合就自動生效;HTTPS 內容能否處理,還取決於適用條件與憑證信任等因素。了解規則來源與作用範圍後再啟用;不要為了解決一般連線問題而盲目新增改寫項目。
已購項目
在 App Store 查詢帳號購買記錄的入口,可用來確認 Shadowrocket 的購買記錄及重新下載資格。iPhone / iPad 版在 App Store 一次性付費 $2.99,兩種裝置可共用同一購買帳號的購買記錄;Mac、Windows、Android、Linux 版免費。重新下載時,請確認目前使用的商店帳號與原購買帳號相同,並以商店頁面顯示的可用狀態為準。

若已能辨認術語但仍無法連線,可參閱常見問題,區分解析、驗證與規則比對問題;需要修改特定設定時,請前往Settings 設定參考逐項確認。