官方手冊 · 術語速查

Shadowrocket 術語與概念

依介面位置理解設定,依比對條件理解規則。英文名稱維持原樣,中文說明用途、適用範圍與常見混淆。

先釐清模式、規則與伺服器

Global Routing 決定整體處理方式,Rule 決定哪些連線符合哪些策略,SERVER 提供實際連線參數。這三個層次是不同設定。排查時,先確認目前模式,再查看符合條件的規則,最後核對伺服器資訊,避免在不同層次間反覆修改。

本頁以 iPhone/iPad 介面為例,其他平台的項目位置可能不同。Shadowrocket 是全平台閉源商業應用:iPhone / iPad 版於 App Store 一次性付費 $2.99;Mac(Apple 晶片與 Intel)/ Windows / Android / Linux 版免費。取得方式及本站 /dl/ 安裝檔入口請見下載頁;iPhone/iPad 系統需求以 App Store 頁面標示為準。

介面與開關

先確認設定所在的位置。相似的英文詞可能分別代表整體模式、頁面名稱或規則策略。

Global Routing

這是決定整體流量處理方式的入口,三種模式為設定、代理、直連,對應介面用語 Config / Proxy / Direct。它會先決定是否依設定中的規則分流;因此修改某條 Rule 前,應先確認目前是否選擇 Config。切換模式不等於更換伺服器,也不會自動補齊缺少的驗證參數。

Config

在 Global Routing 中,Config 表示依目前設定中的規則處理連線;作為頁面名稱時,Config 用來管理及選擇設定檔。看到這個詞時,先判斷它指的是模式選項,還是設定管理入口。匯入設定檔不代表它已成為目前生效的設定;使用前仍須確認選取狀態。

Proxy

這是 Global Routing 中的代理模式,連線交由目前選取的代理處理,不會逐條執行 Config 的分流判斷。診斷時可與其他模式進行對照測試,但測試後應恢復原本需要的模式。首字母大寫的 Proxy 是介面模式,不可與規則列中的全大寫 PROXY 混淆。

Direct

這是 Global Routing 中的直連模式,連線直接連至目標,不經代理伺服器。可用來對照本機網路是否能連至同一目標,但不會修復 DNS、目標服務或路由本身的問題。規則中的 DIRECT 只適用於符合該策略的連線,作用範圍與整體模式不同。

On Demand

這項功能會依預先設定的網路條件觸發 VPN 連線,條件應依裝置實際使用環境設定。它處理的是何時發起連線,Rule 處理的則是連線建立後如何管理流量。若啟用後出現反覆中斷又重新連線的狀況,應先檢查相關條件,再判斷是否為連線異常。

Settings

這是集中管理用戶端設定的入口,與在 Home 選擇伺服器的操作不同。設定項目及位置請以裝置上的實際介面為準,不必照著其他平台的操作路徑尋找同名按鈕。診斷時每次只修改一項,並記下原始值,才能判斷變更是否與目前問題有關。

協定

協定是用戶端與伺服器協作的方式,不代表速度等級。匯入時應以既有伺服器提供的類型與參數為準。

Shadowsocks

這是一種代理協定,伺服器位址、連接埠、密碼及加密方式等資訊必須彼此相符。只有位址和連接埠通常不足以建立正確連線,加密方式也不能因名稱相似就任意替換。若既有設定包含額外傳輸參數,應依原始資訊逐項核對,不要自行省略。

VMess

這是一種使用身分識別等參數進行驗證的代理協定。協定類型、身分資訊、傳輸方式及 TLS 設定是不同欄位;辨識出 VMess 不代表其他參數都正確。手動輸入時也應核對裝置時間與伺服器資訊,避免把驗證失敗誤判為網路中斷。

VLESS

這是一種代理協定,身分驗證與傳輸安全須分開理解。協定名稱本身無法說明是否啟用 TLS,傳輸方式、伺服器名稱等設定仍須與伺服器端一致。已有項目出現問題時,不要反覆切換協定類型;應回頭依原始設定逐項比對。

Trojan

這是一種通常搭配 TLS 使用的代理協定,須核對驗證密碼、連接埠及伺服器名稱。TLS 驗證取決於憑證、名稱等條件;IP 位址有回應,不代表驗證與憑證檢查也能通過。出現憑證錯誤時,應先檢查網域、裝置時間及原始參數,不要直接關閉驗證來掩蓋原因。

Hysteria2

這是一種以 QUIC 為基礎的代理協定,連線過程仰賴 UDP 網路條件。驗證、TLS 及其他傳輸參數都應與伺服器設定相符,不能只填入伺服器位址。若在某個網路環境中連線失敗,可維持參數不變並切換網路比對,以區分網路條件與設定問題。

WireGuard

這是一種以金鑰為基礎的通道協定,設定通常包含介面位址、金鑰、對端端點及路由範圍。私密金鑰屬於敏感資訊,分享設定或排查問題的圖片前應先移除。通道成功建立與能否連至目標網路是兩回事,仍須檢查位址範圍、DNS 及對端路由。

HTTP / SOCKS5

這是兩種不同的代理協定,即使位址相同也不能據此互換類型。是否需要帳號驗證、支援哪些流量,應以伺服器提供的資訊為準。協定名稱本身不代表已啟用加密傳輸,不能只憑 HTTP 或 SOCKS5 字樣判斷整條連線是否受到保護。

規則關鍵字與策略

關鍵字說明「比對什麼」,策略說明「符合後如何處理」。以下範例僅說明語法,不是可直接取代現有設定的完整規則集。

Rule

一條 Rule 通常包含比對類型、比對內容及處理策略,規則一般由上而下檢查。較寬泛的項目若排在前面,後續較具體的項目可能無法生效。排查時應檢查最先符合的規則,而不只是確認清單中是否有某個網域。

DOMAIN

這個關鍵字會比對完整網域名稱,例如 DOMAIN,example.com,DIRECT。它不會自動涵蓋所有子網域,也不會把 URL 路徑視為網域的一部分。若要同時處理主網域與下層網域,應先了解 DOMAIN-SUFFIX 的涵蓋範圍,再選擇適合的寫法。

DOMAIN-SUFFIX

這個關鍵字會比對指定網域及其子網域,例如 DOMAIN-SUFFIX,example.com,PROXY。它依網域後綴的邊界判斷範圍,不是只要任意位置出現相同文字就符合。比對內容不要加入 https:// 或頁面路徑。

GEOIP

這個關鍵字會依目標 IP 在地理資料庫中的分類進行比對,例如 GEOIP,CN,DIRECT。判斷依據是連線對應的目標位址與資料庫,不是網站顯示的語言或註冊資訊。內容傳遞網路及位址分配變動可能影響分類,因此不能把它視為對網站身分的固定判定。

IP-CIDR / IP-CIDR6

這兩個關鍵字分別比對 IPv4 與 IPv6 位址範圍,斜線後的前綴長度決定範圍。例如 IP-CIDR,192.168.0.0/16,DIRECT 表示比對這段 IPv4 位址範圍。它比對的是 IP,不會依某個網域自動追蹤其後續所有位址變動。

FINAL

這是前面的規則都未符合時使用的預設備用項目,例如 FINAL,PROXY。通常應放在規則清單末尾,否則可能提前接手原本應由後續規則處理的連線。修改此項會影響所有未被前面項目涵蓋的目標,調整前應先確認現有分流設定的目的。

PROXY

這是規則中的代理策略標記,表示符合條件的連線交由代理路徑處理。實際連線仍取決於目前選取的代理及對應伺服器是否可用;符合 PROXY 不代表一定能連上目標。這是規則的處理結果,不是 Global Routing 中的 Proxy 整體模式。

DIRECT

這是規則中的直連策略標記,表示符合條件的連線直接連至目標,不經代理伺服器。裝置仍須具備正常的本機網路與名稱解析條件。某條連線使用 DIRECT,不代表用戶端整體處於 Direct 模式;其他連線仍可能符合不同策略。

REJECT

這是規則中的拒絕策略標記,表示拒絕符合條件的連線。範圍過寬時,可能連帶影響正常頁面所需的資源,因此不要只憑模糊的名稱就大範圍新增規則。修改後若部分內容無法顯示,應核對符合紀錄與規則順序,再決定是否縮小比對範圍。

訂閱與設定

訂閱用來更新伺服器項目,設定描述流量處理方式;備份與同步則用來保存資料,彼此不能取代。

Subscribe

這是透過使用者已有的訂閱網址取得及更新伺服器項目的方式,不是連線服務本身。更新可以改變項目清單,但不會自動修復已過期的訂閱、失效的驗證資料或伺服器故障。訂閱網址可能含有存取憑據,不應公開貼在留言、截圖或可共用的文件中。

SERVER

伺服器項目不只有位址,還包含連接埠、協定、驗證資訊,以及可能存在的傳輸參數。清單中的名稱通常只是方便辨識的標籤,不能據此判斷實際地理位置或連線表現。若需修正參數,應以使用者已有伺服器的原始資訊為準。

Add Server

這是手動建立伺服器項目的入口,適用於已掌握完整伺服器資訊的情況。先選擇正確的協定類型,再依欄位輸入位址、連接埠及驗證參數,避免混用不同協定的欄位。儲存後還須選取項目並測試連線;儲存本身不代表伺服器已可使用。

iCloud 同步

這是透過 iCloud 在適用裝置間同步應用程式支援資料的方式,須符合相應的帳號與系統條件。同步不等於獨立備份,誤刪或錯誤修改也可能同步到其他裝置。更換裝置前,應另行儲存需要的設定;還原後逐項核對目前的 Config、伺服器項目及訂閱狀態。

連線與診斷

先確認測試的對象,再解讀結果。連線狀態、解析結果、回應時間與實際頁面存取,分別反映不同問題。

DNS

這是將網域名稱解析為 IP 位址的過程,通常發生在實際連線至目標之前。解析成功不代表連線一定成功,連線失敗也不一定是 DNS 問題。排查時應分別檢查解析結果、目前的路由策略及目標服務,不要只因頁面無法開啟就連續更換 DNS 設定。

Connectivity Test

這是檢查項目連線狀況的工具,結果取決於目前選用的測試方式、目標及網路條件。測試有回應,只能表示當時相應的測試路徑取得結果,不能取代實際服務存取。比較多個項目時應維持相同測試條件;選定後,再連線至自己實際需要的目標。

延遲

延遲是在特定測試條件下測得的回應時間,不是下載速度,也不是傳輸量。數值較低不代表所有網站都會更快,實際表現也會受到目標位置、封包遺失、網路壅塞及伺服器負載等因素影響。單次逾時同樣不足以判斷結果,應在相同條件下重新測試,並搭配實際連線狀況評估。

Data

這是查看流量紀錄或連線統計的頁面,具體項目請以目前介面為準。用戶端紀錄與服務商的計費範圍、統計週期可能不同,不能用一方的總量直接推算另一方的帳單。排查時應留意與問題相關的目標、時間及策略資訊;分享紀錄前,請移除私人位址與驗證資訊。

URL Rewrite

這是針對符合條件的 URL 執行重寫處理的設定功能,與選擇 PROXY 或 DIRECT 路徑不同。網域規則負責流量分流,URL Rewrite 則比對並處理請求網址。HTTPS 下能否處理相關內容,取決於加密及其他設定條件;新增重寫規則不代表所有請求都會生效。

從術語回到實際操作

首次設定時,請依入門教學匯入既有資訊、選擇 Global Routing 模式並測試連線。若要分階段檢查權限、設定、流量與日常維護,請參閱完整使用手冊;遇到特定錯誤時,再透過FAQ縮小排查範圍。

建議閱讀順序:Global Routing → Config → Rule → PROXY / DIRECT / REJECT → DNS。先建立各層次的概念,再了解個別協定的參數,可減少把路由問題誤認為驗證問題。

返回術語分類 ↑
Shadowrocket 全平台下載