官方手冊 · 術語查閱

Shadowrocket 術語解說

依介面入口、協定、規則與網路概念查閱。先辨認術語所屬層級,再判斷需要修改的是伺服器參數、設定檔,還是整體連線方式;英文名稱維持與介面及規則語法一致。

  • 介面用語保留英文
  • 規則關鍵字區分大小寫
  • 以已有的訂閱或伺服器資訊為前提
入口與連線方式

介面與開關

介面入口負責安排操作,連線狀態則反映執行情況。進入某個頁面或選取一筆記錄,本身都不代表已建立連線。

介面與開關

Home

Home 是查看伺服器清單、目前選取項目與連線狀態的主要入口。伺服器出現在清單中,只代表記錄已儲存;仍需選取合適的記錄並啟用連線。排查時,先區分「記錄存在」、「已選取」與「已建立連線」三種狀態。

介面與開關

Global Routing

Global Routing 決定整體路由方式:設定、代理、直連分別對應 Config、Proxy、Direct。Config 依目前設定中的規則處理要求;Proxy 以代理方式處理流量;Direct 則直接處理流量。這裡選取的模式與單條規則末尾的動作屬於不同層級。

介面與開關

On Demand

On Demand 使用系統的隨選連線機制,在符合設定條件時觸發 VPN 連線。它負責決定何時嘗試建立連線,不負責確保伺服器有效、認證正確或目標網站連得上。手動中斷後若再次出現連線,應一併檢查這項設定與網路條件。

介面與開關

Add Server

Add Server 用來手動新增伺服器記錄,欄位會依協定類型而異。位址、連接埠、認證欄位與傳輸參數需逐項對照已有的伺服器資訊,不能只憑名稱猜測。儲存後返回清單選取記錄,再透過實際要求進行驗證。

介面與開關

Settings

Settings 是查看及調整 App 設定的入口,與編輯個別伺服器參數的頁面用途不同。排查問題時,先記錄原值,再一次修改一項,才能確認變化來自哪項設定。實際選項與位置以裝置上的介面為準。

介面與開關

Connectivity Test

Connectivity Test 用來檢查指定測試目標在目前條件下是否連得上。測試方式、目標位址與本機網路都會影響結果,因此單次成功不代表所有服務都正常。發生異常時,應交叉比對測試結果、DNS、要求記錄及實際網頁連線狀況。

連線參數的共同語言

協定

協定規定用戶端與伺服器如何交換資料。協定名稱相同,不代表參數也相同;認證、傳輸方式與 TLS 設定都需分別核對。

協定

Shadowsocks

Shadowsocks 是一種代理協定,常見的必要資訊包括伺服器位址、連接埠、加密方式與密碼。加密方式也是連線參數之一,不能因密碼正確就忽略。手動填寫或匯入後,應檢查字元是否完整,並確認與已有的伺服器資訊一致。

協定

VMess

VMess 是一種具備身分驗證的代理協定,身分資訊與傳輸方式屬於不同參數層。填入身分識別後,還需核對連接埠、傳輸路徑及 TLS 等相關設定。認證失敗與傳輸建立失敗可能呈現相似狀況,應分層檢查,而非反覆更換同一個欄位。

協定

VLESS

VLESS 是一種代理協定,通常需要身分識別及與伺服器端相符的傳輸參數。身分識別用來辨識連線,不代表傳輸加密或憑證驗證已完成。設定時應使用完整的既有參數,並分別確認身分、傳輸與安全設定。

協定

Trojan

Trojan 通常搭配 TLS 使用,並以密碼等資訊進行認證。伺服器位址、連接埠、TLS 名稱與憑證驗證都會影響連線;密碼正確也不足以排除其他問題。遇到憑證錯誤時,應核對伺服器名稱與憑證設定,而非直接略過驗證。

協定

Hysteria2

Hysteria2 是以 QUIC 為基礎的代理協定,底層通訊依賴 UDP。如果目前網路限制 UDP,即使其他類型的連線正常,也不代表 Hysteria2 能順利建立連線。認證、TLS 與其他參數應依照既有設定填寫;協定名稱本身不代表固定的速度或穩定性。

協定

WireGuard

WireGuard 透過金鑰組建立加密通道,本機私鑰與對端公鑰用途不同,不可互換。Address 指的是通道介面位址,不是伺服器的公開連線位址;DNS 與 MTU 也分別影響解析和資料傳輸。私鑰應妥善保存為敏感資訊,參數含義可參閱WireGuard 參數說明。

協定

HTTP / SOCKS5

HTTP 與 SOCKS5 是不同的代理協定類型,應依照已有的伺服器資訊選擇,不能只因位址和連接埠相同就互換。是否需要使用者名稱、密碼,以及是否具備傳輸保護,取決於伺服器設定與實際連線方式。協定名稱不等於加密保證,也不代表支援所有要求類型。

比對條件 → 執行動作

規則關鍵字

先看規則比對的項目,再看符合後會執行什麼動作。以下語法用於理解結構,範例網域不代表可以直接套用為設定。

規則關鍵字

Rule

Rule 由比對條件與執行動作組成,用來決定要求的處理路徑。在設定模式下,通常會由上而下檢查規則,最先符合的規則會影響最終結果,因此較具體的條件通常應排在範圍較廣的條件之前。修改後應檢查要求實際符合哪條規則,而不只是確認規則文字已儲存。

規則關鍵字

DOMAIN

DOMAIN 依完整網域名稱比對,例如 DOMAIN,example.com,DIRECT。它只對應指定網域,不會因名稱相關就自動涵蓋所有子網域。若要同時涵蓋主網域及其子網域,應先判斷是否適合使用 DOMAIN-SUFFIX。

規則關鍵字

DOMAIN-SUFFIX

DOMAIN-SUFFIX 依網域後綴比對,通常涵蓋指定網域本身及其子網域。例如,針對 example.com 的後綴規則可用於該主網域與下層網域,但不代表會比對名稱中任意包含這段文字的網域。單一頁面可能會要求多個不同網域的資源,主網域符合規則也不代表所有資源都走相同路徑。

規則關鍵字

DOMAIN-KEYWORD

DOMAIN-KEYWORD 會檢查網域是否包含指定關鍵字,適用範圍通常比完整網域或後綴規則更廣。較短且常見的關鍵字,容易連帶比對到原本不打算處理的網域。只有確實需要這種範圍時才使用,並搭配要求記錄確認是否發生誤比對。

規則關鍵字

GEOIP

GEOIP 依據 IP 地理資料庫中的歸屬資訊比對,例如 GEOIP,CN,DIRECT。資料庫的歸屬資訊不等於伺服器的精確實際位置,也不能直接代表連線速度。處理網域要求時,還應考慮解析結果與位址選擇是否改變了實際參與比對的 IP。

規則關鍵字

IP-CIDR / IP-CIDR6

IP-CIDR 與 IP-CIDR6 分別用於比對 IPv4、IPv6 位址區段。位址後方斜線標示的前綴長度決定涵蓋範圍,不能將它當成連接埠。只新增 IPv4 規則,不代表已涵蓋同一服務的 IPv6 位址;檢查時也應留意實際連線使用的位址類型。

規則關鍵字

FINAL

FINAL 用來處理未符合前面規則的要求,通常放在末尾作為後備處理。FINAL,PROXY 與 FINAL,DIRECT 對剩餘流量的處理方式不同,因此不能只檢查前面的網域規則。若將後備規則移到前面,後續的細分規則可能就沒有比對機會。

規則關鍵字

PROXY / DIRECT / REJECT

PROXY 表示交由代理路徑處理,DIRECT 表示直接連線至目標,REJECT 則表示拒絕要求。這些是規則中的動作,應與 Global Routing 的 Proxy、Direct 整體模式分開理解。即使符合 PROXY,仍需要有效的伺服器與正確參數;規則比對成功不代表後續連線也成功。

記錄、更新與儲存

訂閱與設定

伺服器訂閱負責維護連線記錄,設定檔則負責管理規則等設定。匯入、同步與備份用途不同,不宜互相取代。

訂閱與設定

Subscribe

Subscribe 用來透過使用者已有的訂閱連結維護伺服器清單;更新時會重新讀取該連結傳回的內容。訂閱連結可能包含認證資訊,應像密碼一樣妥善保管;更新後的記錄變化應先與訂閱連結傳回的內容核對。伺服器清單更新不代表規則設定也會隨之更新。

訂閱與設定

SERVER

SERVER 表示存放伺服器連線資訊的記錄,中文說明中也常稱為伺服器或節點。顯示名稱主要用於辨識,實際連線取決於位址、連接埠、協定、認證及相關傳輸參數。名稱相同不代表參數相同,重新命名也不會改變伺服器本身的網路能力。

訂閱與設定

Config

Config 可指管理設定檔的介面入口,也可指 Global Routing 中的設定模式,需依上下文判斷。設定檔用於管理規則、DNS 等設定,伺服器訂閱則主要維護伺服器記錄。匯入檔案不代表已套用;驗證時還需確認目前使用的設定檔與整體路由方式。

訂閱與設定

Scan QR Code

Scan QR Code 透過相機讀取 QR code 中可辨識的連線資訊,首次使用時可能需要相機權限。QR code 只是資訊載體,不會自動確保其中參數完整或有效。匯入後應核對協定、位址與認證欄位;含有連線憑證的 QR code 也應避免公開分享。

訂閱與設定

iCloud 同步

iCloud 同步用於在裝置間同步 App 支援的資料,實際範圍取決於 App 設定與系統狀態。同步不等同於完整備份;換機後仍應逐項檢查伺服器、目前設定檔及連線設定。手動匯出的檔案也可能包含敏感參數,還原前可參閱設定備份與換機移轉。

解析、交握與傳輸

DNS 與網路

要求需要經過多個階段。區分網域解析、伺服器連線、認證與內容傳輸,才能依實際故障狀況安排排查順序。

DNS 與網路

DNS

DNS 會將網域名稱解析為 IP 位址等記錄,是瀏覽網站時常見的前置步驟。DNS 傳回結果不代表目標已可連線;伺服器延遲正常,也無法證明網域解析正常。網站無法開啟時,應先判斷問題發生在解析階段,還是解析後的連線與傳輸階段。

DNS 與網路

延遲

延遲表示特定測試所需的時間,具體意義取決於測試方式與目標。延遲較低不代表下載頻寬較高,也不保證其他網站或 App 使用相同路徑。比較記錄時應維持測試條件一致,並搭配實際要求確認結果。

DNS 與網路

TLS / SNI

TLS 用於保護傳輸;SNI 則在 TLS 交握時指出所連線的伺服器名稱。用來建立連線的位址可能與該名稱不同,填寫時應分別依照已有的伺服器設定。憑證驗證錯誤時,應檢查名稱、憑證鏈與裝置時間,不應只靠忽略錯誤來判斷連線是否正確。

DNS 與網路

UDP

UDP 是一種資料報傳輸協定,部分通道協定、即時通訊與 DNS 要求會使用它。使用 UDP 的連線需由本機網路、伺服器及相關設定共同支援。網頁能開啟不代表 UDP 路徑也正常;排查時應使用符合故障服務的測試方式。

DNS 與網路

MTU

MTU 表示鏈路可承載的最大傳輸單元大小,通道封裝會占用額外空間。設定不當時,可能發生連線已建立但部分內容傳輸異常的情況;不過僅憑這種現象仍無法直接判定原因。調整時應記錄原值,依照既有設定操作,並以相同服務重新測試。