官方手冊 · 術語索引

Shadowrocket 術語表

依含義查找介面用語、協定名稱與規則關鍵字。先分清比對條件、處理策略與連線參數,再修改對應設定。

  • 英文介面用語維持原文
  • 五大類概念索引
  • 每個詞條皆可透過錨點連結

查詢術語前先確認所在位置

同一個英文詞可能出現在不同層級。例如 Config 可能是設定管理入口,也可能是 Global Routing 中的選項;Proxy 是介面選項,PROXY 則常見於規則策略。判斷含義時,應一併查看所在頁面、相鄰欄位及目前啟用的設定,不要只看單一詞彙。

本頁說明概念,不取代逐步操作指引。首次匯入請閱讀使用說明;若要確認 DNS、On Demand、Ping、Log 等選項,請參閱選項手冊。不同平台的入口位置可能不同,以下術語說明不代表各平台的介面配置完全相同。

INTERFACE & SWITCHES

介面與開關

先確認開關控制的是整體連線、路由選擇還是診斷功能。連線開關已開啟,不代表每個請求都會使用相同路徑。

Global Routing
決定整體路由模式的選項,常見選擇為 Config、Proxy、Direct,分別代表依設定處理、使用代理與直連。Config 會依目前設定中的規則處理請求;Proxy 與 Direct 則用來選擇整體代理或直連模式。自訂規則未生效時,請先確認此處是否選擇 Config,再檢查規則本身。
Config / Proxy / Direct
這是 Global Routing 中的三個介面用語,不是三個伺服器名稱。Config 代表依設定分流,Proxy 代表使用代理路徑,Direct 代表使用直連路徑。它們與規則列中的大寫 PROXY、DIRECT 位於不同層級,回報問題時最好一併註明所在頁面。
On Demand
依預設條件由系統觸發 VPN 連線的機制,適用於需要依網路環境管理連線的情境。這不等同於規則清單,也不是某種協定。修改後請分別檢查切換網路、解除鎖定及手動中斷後的行為,避免將條件觸發的重新連線誤認為開關故障。
DNS
將網域名稱解析為 IP 位址的機制,是存取網域時的重要環節。DNS 解析成功只代表取得位址,後續連線仍可能受到路由、伺服器狀態或協定參數影響。若延遲測試正常但網頁無法開啟,請分別確認解析結果與實際連線記錄,不要一次修改所有 DNS 欄位。
Connectivity Test
用來檢查指定連線路徑是否可達的測試入口,結果取決於測試方式與目標。測試成功不代表所有網站、協定與規則都正常。比較多筆記錄時,請維持相同的測試方式與網路環境;測試失敗後,再配合 Log 判斷問題發生於解析、建立連線或後續請求階段。
Ping
通常用來描述探測回應所需時間,但介面中的實際測量意義須依目前測試方式判讀。數值較低不代表下載速度一定較快,也不能保證長時間連線穩定。評估實際使用情況時,請參考應用程式存取結果、連續測試與網路切換狀況,不要只憑一次測試就修改整份設定。
Log
查看連線與診斷記錄的入口,可協助找出解析失敗、連線錯誤或規則比對問題。排查時先記下操作時間,再重現一次問題,方便將記錄對應到特定請求。分享記錄前,請檢查伺服器位址、訂閱連結、識別資訊及其他敏感欄位,只保留排查所需內容。

PROTOCOLS

協定

協定名稱說明連線採用的技術方式,不代表連線參數已完整。類型、識別資訊、傳輸與安全層設定應以你已有的伺服器資料為準。

Shadowsocks
一種代理協定,常見連線參數包括伺服器位址、連接埠、密碼與加密方式。用戶端與伺服器兩端的參數必須相符,只填對位址與密碼仍可能無法連線。若服務商資料列有其他選項,請逐項核對,不要自行套用其他記錄中的設定。
VMess
一種使用識別資訊並搭配傳輸設定建立連線的代理協定。除了伺服器位址、連接埠與識別資訊,還可能涉及傳輸類型、路徑、Host 及 TLS 相關參數。匯入後若無法連線,請確認整組參數是否對應同一筆伺服器記錄,不要只檢查識別資訊。
VLESS
一種須搭配傳輸層與安全層設定使用的代理協定,識別資訊只是連線資料的一部分。它與 VMess 不能直接互換;即使欄位看起來相似,也不應只修改類型來重複使用記錄。核對時應依服務商提供的完整資訊確認傳輸、安全層與伺服器名稱等設定。
Trojan
一種通常以 TLS 建立連線的代理協定,常見資料包括伺服器位址、連接埠、密碼及伺服器名稱等。憑證錯誤與密碼錯誤是不同問題,應分別檢查。若 TLS 連線失敗,請優先確認系統時間、伺服器名稱及憑證資訊,不宜將略過憑證驗證當成一般處理方式。
Hysteria2
一種以 QUIC 為基礎的代理協定,連線狀況與目前網路是否支援 UDP 有關。認證、TLS 及資料中明確列出的其他參數都必須與伺服器相符。若在某個網路無法連線、換網路後卻成功,請保留同一組參數比較網路條件,不要先認定伺服器記錄填寫錯誤。
WireGuard
一種以公私鑰與 Peer 設定建立通道的協定,常見概念包括介面位址、對端公鑰、Endpoint 與 Allowed IPs。交握成功不代表所有目標位址的路由與 DNS 都設定正確。私鑰屬於敏感資訊,排查設定時不要將完整私鑰或含有私鑰的 QR Code 傳給他人。
HTTP / SOCKS5
兩種代理協定名稱,實際使用哪一種必須與伺服器提供的入口相符。協定名稱本身不代表用戶端與代理伺服器之間已加密,也不要因網站使用 HTTPS 就混淆代理入口的類型。確認時須一併核對位址、連接埠、認證要求及服務端明確支援的功能。

RULE KEYWORDS

規則關鍵字

規則前半段說明「比對什麼」,策略部分說明「符合後如何處理」。請先檢查比對範圍,再確認順序,最後確認引用的策略是否存在。

規則
由比對條件與處理策略組成的設定項目,通常依序由上而下檢查,符合後便停止繼續比對。例如 DOMAIN-SUFFIX,example.com,PROXY 包含關鍵字、比對值與策略。較具體的條件通常應放在範圍較廣的條件之前,避免請求先被前面的規則比對到。
DOMAIN / DOMAIN-SUFFIX / DOMAIN-KEYWORD
DOMAIN 比對完整網域名稱,DOMAIN-SUFFIX 比對指定網域及其子網域,DOMAIN-KEYWORD 比對網域名稱中包含的關鍵字。三者涵蓋範圍不同,不是同一寫法的縮寫。能明確判定目標時,應優先使用清楚的比對條件,避免範圍過廣的關鍵字影響其他網域。
IP-CIDR / IP-CIDR6
分別依 IPv4 與 IPv6 位址網段進行比對,斜線後的前綴長度決定網段範圍。例如 192.168.0.0/16 是一種 IPv4 網段表示法。IP 規則與網域規則的判斷依據不同,實際比對時還須確認目標位址、解析結果及前面已符合的規則。
GEOIP
依 IP 位址歸屬資料庫進行比對的規則關鍵字;歸屬結果取決於資料庫內容及更新狀況。它不會直接依網頁語言、網域後綴或使用者所在位置判斷。使用 CDN 或共用基礎架構的服務尤其需要確認實際目標 IP,不能只憑網站名稱推測比對結果。
FINAL
前面的規則都未符合時採用的預設規則,通常放在規則清單末尾。例如 FINAL,DIRECT 表示將尚未比對到的請求交由 DIRECT 處理。它決定未涵蓋流量的處理方式,因此修改前應先確認哪些請求會套用此規則,而不是把 FINAL 當成修復所有連線問題的開關。
PROXY / DIRECT / REJECT
PROXY 表示使用代理策略,DIRECT 表示直連,REJECT 表示拒絕請求。它們代表處理方式,不是網域、協定或伺服器位址;PROXY 最終使用的路徑仍須依目前設定與選擇確認。自訂策略名稱也必須在設定中有相應定義。
USER-AGENT
依請求中的 User-Agent 資訊進行比對的規則關鍵字,前提是目前的處理路徑能讀取相關內容。加密流量中無法看到的資訊,不能只靠新增規則來比對。因此不適合將它視為對所有應用程式都有效的識別方式,使用前應先確認實際請求及目前功能條件。

SUBSCRIPTION & CONFIG

訂閱與設定

訂閱用來取得及更新服務資訊,設定則用來組織規則與相關選項。匯入成功、訂閱更新成功與實際連線成功,是三項需要分別確認的結果。

Subscribe
用來匯入或更新訂閱內容的入口;訂閱連結請向自己的服務商取得。訂閱通常包含多筆伺服器記錄,不同於只描述單一伺服器的連結,也不一定包含完整的分流設定。訂閱網址可能含有存取憑證,複製、截圖或提出問題時請避免公開完整連結。
Add Server / SERVER
Add Server 用來新增單筆伺服器記錄,SERVER 相關欄位則用來填寫對應的伺服器資訊。記錄通常包含協定類型、位址、連接埠與認證參數等,不只是一個名稱。手動填寫適用於已備妥完整參數的情況;若只有訂閱連結,請使用相應的訂閱入口,不要將整條連結填入伺服器位址欄。
Config
作為設定管理入口時,Config 用來整理目前使用的規則、策略引用及其他設定內容。將檔案儲存在此處,不代表該檔案已選取並啟用;設定是否存在與是否生效須分別確認。它也不同於 Global Routing 中的 Config 選項,後者表示依目前設定處理路由。
Scan QR Code
讀取 QR Code 設定內容的入口;QR Code 本身只是資訊載體,不會自動補齊缺少的參數。同一個 QR Code 可能包含單筆伺服器連結、訂閱網址或其他內容,匯入前應確認辨識結果與來源。成功掃描不代表一定能連線,也不要公開含有認證資訊的 QR Code。
URL Rewrite
依比對條件改寫請求 URL 或執行相關重新導向的功能,與決定請求採用哪條路徑的路由規則不同。它不能直接取代 DOMAIN-SUFFIX 或 FINAL,也不是解決 DNS 解析失敗的通用方法。使用前應了解比對範圍與流量可見性,並透過單項測試確認不會影響其他請求。
iCloud 同步
透過 iCloud 在適用裝置間同步受支援的資料,實際同步範圍請以目前的應用程式選項為準。這與從服務商更新訂閱是兩個不同的流程,也不等同於還原商店購買記錄。若資料未顯示,請分別檢查 iCloud 帳號、同步開關、網路狀態及待同步的內容。

PACKAGES & PLATFORMS

安裝套件與平台

先確認作業系統與處理器類型,再選擇取得方式。本網站的安裝套件由 /dl/shadowrocket/ 路徑提供,相關入口集中於下載頁。

.deb / .rpm / .AppImage
Linux 常見的軟體套件格式,應依發行版、套件管理工具與系統環境選擇,而非按檔案大小判斷。.deb 常用於 Debian 系發行版;.rpm 常用於採用 RPM 套件管理的發行版;.AppImage 通常須先設定可執行權限,再檢查執行相依項目。詳細操作請參閱安裝安全性提示,不要混用不同格式的指令。
Apple 晶片 / Intel
選擇 Mac 安裝套件時須確認處理器類型,可在系統的「關於這台 Mac」中查看。Shadowrocket 為兩種處理器分別提供 .dmg 安裝套件,不能只依電腦外觀或購買年份判斷。首次開啟若出現「無法驗證開發者」,確認來源後,請依安裝安全性提示在「隱私權與安全性」中處理。
App Store / 已購項目
iPhone / iPad 可透過 App Store 取得 Shadowrocket;重新下載時,可在原購買帳號的已購項目中查找。確認產品時,請一併核對開發者 Shadow Launch Technology Limited、官方圖示及 App ID 932747118;系統需求以 App Store 頁面標示為準。iPhone / iPad 版在 App Store 售價 $2.99,採一次性付費;Mac、Windows、Android、Linux 版免費。
用戶端與連線服務
用戶端負責執行代理連線、規則分流與本機設定;連線服務則提供可連線的伺服器及認證資料,兩者並非同一項服務。一次買斷用戶端 ≠ 購買連線方案;現有伺服器或訂閱仍須另外確認是否有效。訂閱更新、帳號狀態或伺服器維護等問題,請依自己的服務商提供的資訊確認。

依問題繼續查閱

需要操作步驟時,請參閱使用說明;需要逐項確認設定時,請參閱選項手冊。若要尋找安裝套件或商店入口,請前往全平台下載頁;匯入後無法連線時,請保留目前設定,先記錄測試結果與錯誤訊息,再逐項排查,避免同時修改多處而無法判斷原因。