官方手冊 / 術語參考
Shadowrocket 術語表
保留英文原文,依使用位置理解意思。先分清介面模式、協定與規則動作,再核對現有訂閱或伺服器資訊中的參數。
30 個術語項目
介面詞與規則關鍵字
依類別查閱
01 / 介面與開關
模式名稱與操作入口
Global Routing(全域路由)有三種模式:Config(設定)、Proxy(代理)、Direct(直連)。模式決定連線的處理方式,不代表伺服器是否可用。
- 介面與開關Home(首頁)
- 查看伺服器項目、訂閱群組並選擇連線對象的主要入口。列表中出現項目,只表示連線資訊已儲存,不代表驗證成功或已建立連線。排除問題時,先確認目前選取的項目,再檢查連線開關與實際連線結果。
- 介面與開關Global Routing(全域路由)
- 決定連線處理方式的模式選擇,包含 Config(設定)、Proxy(代理)與 Direct(直連)。Config 依目前設定規則分流,Proxy 透過代理路徑處理,Direct 則以直連路徑處理。切換模式與更換伺服器是兩種不同操作,測試前應記下兩者目前的狀態。
- 介面與開關Config(設定)
- 這個詞可指設定管理入口,也可指 Global Routing 中的設定模式,須依所在位置判斷。在設定模式下,連線去向由目前啟用的規則決定。匯入伺服器訂閱不代表已選好設定,也不代表所有連線都會經過代理。
- 介面與開關Proxy(代理)
- 作為 Global Routing 的選項時,表示以代理模式處理連線,排除問題時可用來與設定模式進行受控比較。這無法修正錯誤的密碼、失效的位址或不相符的協定參數。請留意,介面中的 Proxy 與規則動作 PROXY 的大小寫及作用層級不同。
- 介面與開關Direct(直連)
- 作為 Global Routing 的選項時,表示連線不會經由所選的代理伺服器轉送。直連仍取決於目前的網路、DNS 解析與目標服務是否可用,並不等於關閉裝置網路。切換至 Direct 後若能成功連線,只能表示這條直連路徑可用,不能據此確認代理參數正確。
- 介面與開關Add Server(新增伺服器)
- 手動填入現有伺服器資訊的入口,欄位會依所選協定而異。請先選對協定,再逐項核對位址、連接埠、身分驗證及傳輸相關參數。不要為了填滿表單而填入未知欄位,也不要把訂閱網址直接當成伺服器主機位址。
02 / Settings 設定項目
解析、隨需連線與診斷
設定項目用來調整連線行為或查看狀態。遇到問題時一次只修改一項,並記下修改前的值,避免同時變更多個條件而無法判斷原因。
- Settings 設定項目DNS(網域名稱解析)
- 負責將網域名稱轉換為可連線的 IP 位址,解析結果也可能用於比對位址類規則。解析路徑與服務連線路徑不應簡單視為同一回事。修改 DNS 後若結果沒有立即變化,請考量快取、目前設定與系統網路狀態,不要反覆疊加新設定。
- Settings 設定項目On Demand(隨需連線)
- 依已設定的條件觸發系統連線行為,減少重複手動操作。這項設定決定何時嘗試連線,不會取代伺服器選擇、協定參數或分流規則。測試手動中斷連線時,也應檢查隨需條件,避免將條件觸發的重新連線誤認為開關未生效。
- Settings 設定項目Ping(回應時間測試)
- 與回應時間探測相關的設定或測試概念,結果取決於探測方法、目標與當下網路狀況。回應時間較短不代表下載速度較快,單次逾時也不能證明所有服務連線都會失敗。比較結果時應使用相同方法,並參考實際連線與記錄判斷。
- Settings 設定項目Log(記錄)
- 用來查看連線過程,協助分辨網域名稱解析、伺服器連線、身分驗證及規則比對等環節。查看記錄時,應針對一次明確的測試操作尋找相關項目,不宜只根據最後一行推斷原因。記錄可能包含連線目標或伺服器資訊,對外分享前請先移除敏感內容。
- Settings 設定項目Widget(小工具)
- 指與系統小工具相關的功能,方便查看狀態或快速進入相關操作。可用的小工具形式與內容以裝置系統及 App 內介面為準。小工具顯示的狀態可作為提示;若要確認連線是否符合預期,仍應回到 App 並查看實際連線結果。
- Settings 設定項目iCloud Sync(iCloud 同步)
- 透過 iCloud 在符合條件的裝置間同步 App 支援的資料,實際同步範圍請依 App 內說明確認。這不等於完整裝置備份,也不等於還原 App Store 購買記錄。更換裝置前,請確認同步已完成,並另外妥善保存仍需使用的訂閱與伺服器資訊。
03 / 協定
協定名稱與參數範圍
協定定義用戶端與伺服器如何建立通訊。名稱不代表效能排名;應使用現有伺服器實際支援的協定,並確保傳輸方式與安全參數相符。
- 協定Shadowsocks
- 一種代理協定,連線時必須填入相符的伺服器位址、連接埠、加密方式與密碼等資訊。加密方式是協定參數,不能只因名稱相似就互相替換。現有記錄若包含其他參數,也應依伺服器原始說明核對,而非只複製位址與連接埠。
- 協定VMess
- 具備身分驗證與加密機制的代理協定,通常還須搭配特定傳輸設定。身分識別、傳輸類型及相關欄位都必須與伺服器一致,只有位址正確仍不足以建立連線。排除問題時,應分別檢查協定驗證與傳輸層,並確認裝置時間設定正確。
- 協定VLESS
- 一種輕量代理協定,應分別理解協定身分驗證與承載連線的傳輸安全設定。匯入記錄後,應一併檢查身分識別及伺服器要求的傳輸與安全選項。不能因為它與 VMess 使用相似形式的識別資訊,就直接互換兩者的連線類型。
- 協定Trojan
- 通常以 TLS 承載連線並透過密碼完成驗證的代理協定。除了位址、連接埠與密碼,也應核對伺服器名稱及憑證驗證要求。遇到憑證錯誤時,請先檢查名稱、裝置時間與伺服器設定,不應將關閉驗證當成一般解法。
- 協定Hysteria2
- 以 QUIC 為基礎的代理協定,底層通訊須透過相應的 UDP 路徑。即使伺服器驗證參數正確,若目前網路限制 UDP 通訊,仍可能無法建立連線。協定名稱本身不保證速度;任何與頻寬相關的欄位都應依伺服器實際說明填寫。
- 協定WireGuard
- 使用公私鑰進行身分驗證的通道協定,必須正確設定端點、金鑰、位址與路由相關參數。公鑰與私鑰用途不同,不可互換;私鑰應視為敏感憑證妥善保管。成功匯入一筆記錄,不代表位址與路由適合目前環境,仍須確認實際連線狀況。
- 協定HTTP / SOCKS5
- 這是兩種不同的代理協定,並非同一類型的不同名稱;驗證與傳輸能力也取決於伺服器的實際設定。只憑連接埠號碼,無法可靠判斷應選用哪種協定。一般 HTTP 代理與 SOCKS5 本身不等同於加密通道,還需另外確認連線的安全條件。
04 / 規則關鍵字
比對條件與處理動作
規則通常由比對類型、比對內容與處理動作組成。閱讀時先確認條件是否符合,再看動作指向何處;規則順序也會影響最終結果。
- 規則關鍵字DOMAIN / DOMAIN-SUFFIX
- DOMAIN 用來比對指定的完整網域;DOMAIN-SUFFIX 用來比對網域後綴及其子網域。例如
DOMAIN-SUFFIX,example.com,PROXY可涵蓋該網域及其子網域。比對內容應填入網域,而非包含路徑的完整網址;兩種寫法的涵蓋範圍也不同。
- 規則關鍵字DOMAIN-KEYWORD
- 依網域是否包含指定關鍵字進行比對,涵蓋範圍通常比完整網域或網域後綴更廣。較短或常見的字串可能會比對到原本不打算處理的網域。若只想涵蓋特定目標,請先確認能否使用 DOMAIN 或 DOMAIN-SUFFIX 明確界定範圍。
- 規則關鍵字GEOIP
- 依 IP 地理位置資料庫比對位址,例如
GEOIP,CN,DIRECT。它判斷的是位址在資料庫中的歸屬,不是網頁語言、內容來源或網站營運者所在地。資料庫更新、網域解析結果與快取都可能影響實際比對結果。
- 規則關鍵字IP-CIDR / IP-CIDR6
- 分別用於比對 IPv4 與 IPv6 位址範圍,斜線後的前綴長度決定涵蓋範圍。前綴長度設定錯誤可能擴大比對範圍,讓不相關的連線套用相同策略。只處理 IPv4 的規則不會自動涵蓋 IPv6,請依目標實際使用的位址類型一併檢查。
- 規則關鍵字FINAL
- 用來處理前面的規則都未比對到的連線,通常放在規則列表末尾作為後備規則。
FINAL,PROXY表示將其餘連線交由 PROXY 指定的處理策略。它不是用來測試伺服器是否可用的指令;已符合前面規則的連線不會再由末尾的後備規則重新決定。
- 規則關鍵字PROXY / DIRECT / REJECT
- 這些大寫關鍵字代表規則動作,不是網域或協定:PROXY 交由代理策略處理,DIRECT 使用直連,REJECT 拒絕連線。PROXY 最終使用的對象,也應一併確認目前的設定與選取項目。它們與 Global Routing 中的 Proxy、Direct 並非同一層級的開關。
05 / 訂閱與設定
資料來源、匯入與購買記錄
伺服器訂閱會更新連線項目,設定檔用來整理處理邏輯,App Store 記錄應用程式購買。三者分別儲存、分別還原,避免將 App 還原誤認為連線資訊也已還原。
- 訂閱與設定Subscribe(訂閱)
- 透過使用者現有的訂閱網址取得並更新伺服器項目的機制;訂閱網址應向你的服務供應商取得。網址可能包含存取憑證,不應張貼在公開頁面、截圖或記錄中。更新會依訂閱內容刷新相關項目,但不代表能自動修復過期的驗證資訊,也不等於修改所有分流規則。
- 訂閱與設定Server(伺服器項目)
- 一筆儲存協定、主機位址、連接埠與驗證等資訊的連線記錄,列表中的備註名稱主要用於辨識。兩筆項目名稱相同,不代表參數一定相同;名稱不同,也可能指向同一台伺服器。排除問題與移除重複項目時,應核對實際欄位,而非只看備註或群組名稱。
- 訂閱與設定設定檔
- 用來整理規則、DNS 與其他處理選項,決定連線在設定模式下如何分流。伺服器訂閱主要更新連線對象,設定檔主要描述處理邏輯,兩者無法直接互相取代。啟用新設定前,應保留可還原的副本,並確認其中引用的策略能對應到實際連線對象。
- 訂閱與設定Scan QR Code(掃描 QR Code)
- 讀取 QR Code 所含連線資訊的匯入入口;QR Code 只是資料載體,並非獨立協定。請只掃描來源明確且屬於你現有服務的內容,並在儲存後核對辨識出的協定與必要欄位。QR Code 也可能包含敏感驗證資訊,不宜當作一般圖片公開分享。
- 訂閱與設定已購項目
- App Store 中與購買帳號連結的 App 購買記錄,可用於符合條件的重新下載。還原購買記錄不代表訂閱、伺服器記錄或本機設定也會一併還原,這些資料需要另外確認。iPhone 與 iPad 的購買適用範圍及其他裝置的相容性,請以 App Store 頁面標示為準。