官方手冊 術語速查

Shadowrocket
介面與規則術語

依所在介面與使用情境查找術語,釐清連線模式、比對條件與處理策略。

英文名稱保留 App 與設定檔中的原文。每個術語都可透過標題旁的連結定位;需要依序操作時,請前往教學;要查詢購買紀錄,請參閱App Store 指南。

介面與開關

連線方式與操作入口

先確認目前模式,再判斷設定是否生效。開啟連線開關,只表示系統已開始處理相關流量,不能單憑此判定目標網站或伺服器可連線。

Global Routing

選擇整體流量處理模式的入口,提供設定檔 Config、代理 Proxy、直連 Direct 三種模式。若要依網域或 IP 規則分流,應選擇 Config 並檢查目前使用的設定檔;切換模式不會補上伺服器驗證參數,也無法修復遠端連線錯誤。

Config

這個名稱常見於兩種情境:設定檔管理入口,以及 Global Routing 中依設定檔處理流量的模式。進入設定檔管理可檢視或編輯檔案;選擇 Config 模式,才會要求流量依目前設定檔處理。若只儲存檔案,卻未選用正確設定檔,結果可能與預期不同。

Proxy / Direct

這兩者是 Global Routing 中的模式名稱,分別代表代理與直連,用來改變整體流量處理方式。若要確認規則是否影響結果,可先釐清測試目的,再暫時切換模式並重新送出要求;測試後請切回所需模式,勿將介面模式與規則中的大寫策略關鍵字混為一談。

On Demand

系統依已設定條件觸發連線的機制,適用於需要依網路環境管理連線的情況。此功能依賴系統 VPN 設定及相關條件,並不保證伺服器可用;手動中斷後若連線再次觸發,請先檢查 On Demand 設定,再判斷是否有異常。

Add Server

手動輸入使用者既有伺服器資訊的入口。先選擇協定類型,再確認位址、連接埠與驗證欄位。不同協定的表單不能直接互換;即使欄位名稱同為密碼或使用者識別碼,也應依原始設定填寫。儲存成功只表示項目已建立,仍須實際測試連線。

Connectivity Test

協助檢查連線可達性的測試入口,結果須配合所選測試方式判讀。顯示的耗時通常反映特定探測的往返或要求處理時間,不等同於下載速度,也無法涵蓋所有目標網站。若發生逾時,請進一步檢查網路、伺服器參數與實際要求結果。

協定

協定類型與連線參數

協定決定連線雙方如何建立連線;傳輸方式與安全層可能是另外設定的項目。以下說明皆以使用者已有自己的訂閱或伺服器資訊為前提,填寫時請依據對應設定。

Shadowsocks

一種代理協定,常見參數包括伺服器位址、連接埠、加密方式與密碼。加密方式必須與伺服器相符,不可為了嘗試連線而任意更改。手動輸入既有資訊時,也應確認是否另有傳輸參數,以免只複製位址與密碼,漏掉其他必要設定。

VMess

使用使用者識別碼等參數建立連線的代理協定,可搭配不同傳輸方式使用。排查時應分別確認協定識別參數、傳輸路徑與安全層設定;即使位址和使用者識別碼相同,傳輸方式或路徑不相符仍可能造成連線失敗。

VLESS

一種代理協定,使用者識別碼、傳輸方式與安全層參數都須與伺服器端相符。僅看到 VLESS 名稱,無法判定連線使用哪種安全層;手動填寫時應逐項對照既有設定,不要直接套用其他協定的欄位。

Trojan

通常搭配 TLS 使用的代理協定,連線時須同時確認驗證密碼與憑證相關設定。伺服器位址與憑證驗證使用的名稱可能用途不同,不應直接視為同一欄位;若出現憑證錯誤,請確認名稱與裝置時間,並維持正常的憑證驗證。

Hysteria2

以 QUIC 為基礎的代理協定,使用 UDP 傳輸;實際連線表現會受網路路徑、壅塞情況與伺服器設定影響。填寫時請留意原設定中的 password、sni、obfs 等欄位;若網路路徑限制 UDP,單純修改規則通常無法解決交握問題。

WireGuard

使用公私鑰與通道位址建立連線的 VPN 協定,常見欄位包括 PrivateKey、PublicKey、Address 和 AllowedIPs。私鑰是敏感資訊,不可放進公開求助截圖;MTU 與位址範圍應依實際設定判讀,不宜直接套用他人的數值。

HTTP / SOCKS5

兩種不同的代理協定類型,應依伺服器支援的類型選擇,並確認驗證要求。目標網站使用 HTTPS,不代表代理類型必須選 HTTP;協定名稱也無法單獨說明用戶端至代理伺服器之間是否加密,還須檢查相關傳輸設定。

規則關鍵字

比對對象與處理策略

一條規則通常先寫比對方式,再寫比對內容,最後指定策略。先確認「比對了什麼」,再看「比對後如何處理」,比只查看單一關鍵字更容易找出問題。

DOMAIN

比對指定的完整網域名稱,例如 DOMAIN,example.com,DIRECT,比對對象是該網域本身。它不會自動涵蓋所有子網域,也不會比對 URL 路徑;若要分別處理同一網域下的不同路徑,無法只靠修改這條規則中的網域達成。

DOMAIN-SUFFIX

依網域名稱後綴比對,通常涵蓋指定網域本身及其子網域,例如 DOMAIN-SUFFIX,example.com,PROXY。比對內容只填網域名稱,不要加上協定開頭或頁面路徑;若要對特定子網域設定例外,請將較具體的規則放在這條規則之前。

DOMAIN-KEYWORD

依網域名稱中包含的字串比對,適合確實需要涵蓋多個相關網域的情況。關鍵字太短可能連不相關的網域也一併比對,因此不應將它視為 DOMAIN-SUFFIX 的簡單替代品;若出現意外比對,請先確認關鍵字是否過於寬泛。

GEOIP

依目標 IP 在地理資料庫中的分類比對,例如 GEOIP,CN,DIRECT。資料庫分類不等於網站顯示語言、營運主體所在地或使用者所在位置;同一網域也可能解析到不同位址,因此分析規則結果時,也要查看實際目標 IP。

IP-CIDR / IP-CIDR6

分別用於比對 IPv4 與 IPv6 位址範圍,斜線後的數字代表網路前綴長度。例如 192.168.0.0/16 表示一個 IPv4 網段,而非單一主機位址;只設定 IPv4 規則,不代表 IPv6 連線也會自動符合相同條件。

FINAL

前面的規則都未比對時套用的最終處理規則,通常放在規則清單末尾。FINAL,DIRECT 與 FINAL,PROXY 的預設處理方向不同,請依實際需求選擇;排查某個目標為何直連或使用代理時,也要確認它是否最後套用了這條規則。

PROXY / DIRECT / REJECT

規則內建的策略關鍵字,分別代表使用代理、直接連線與拒絕要求。它們填在規則的策略位置,不能取代網域或位址條件;PROXY 仍須有可用的代理項目,DIRECT 則不表示要求會避開裝置所在的區域網路。

規則順序

規則通常由上而下比對;較具體的例外應放在較寬泛的條件之前,再以 FINAL 作為預設處理。若兩條規則涵蓋同一目標,後面的規則可能不會生效;調整後請儲存、確認目前使用的設定檔,並以新的要求重新測試。

[Rule]
DOMAIN,status.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT

需要逐行說明時,請參閱DOMAIN-SUFFIX 規則寫法範例。

訂閱與設定檔

匯入內容與設定範圍

伺服器項目說明連線方式;訂閱用來批次更新項目;設定檔則用來整理規則與一般設定。匯入前請先確認內容類型,避免將不同入口當成相同操作。

Subscribe

用來匯入使用者既有訂閱網址的類型,可透過遠端內容取得或更新伺服器項目。訂閱網址可能包含識別憑證,應妥善保管為敏感資訊;更新成功只表示內容已取得並解析,不代表其中每台伺服器都能連線,也不表示完整規則設定已一併切換。

伺服器項目

用戶端中儲存的一組連線參數,通常包括協定、位址、連接埠及相關驗證資訊,也常稱為節點。顯示名稱主要用於辨識,無法證明實際位置或效能;更換項目後,既有連線可能需要重新建立,驗證時請送出新的要求。

Config 設定檔

用來整理一般設定、規則與策略等內容的文字設定檔,可能包含 [General]、[Rule] 等段落。它與伺服器訂閱並非同一類內容;修改前建議保留目前可用的副本,匯入後請確認已選用目標檔案,再檢查規則與相關設定。

DNS / DoH

DNS 負責將網域名稱解析為 IP 位址;DoH 則透過 HTTPS 傳送 DNS 查詢。網域名稱成功解析,不代表後續連線一定成功;更換解析方式也不代表變更連線出口。排查時請分別確認解析結果、規則比對結果與目標連線,避免一次修改多項設定。

Scan QR Code

從 QR Code 讀取連線資訊的入口。辨識結果可能是單一伺服器資訊,也可能是訂閱網址。QR Code 只是資料載體,無法自動確認內容正確;儲存前請核對協定類型、位址與其他參數。若格式無法辨識,可對照既有原始設定逐項檢查。

依操作順序繼續閱讀:匯入既有設定、選擇 Global Routing 並確認連線。

App Store 與購買

正版辨識與購買紀錄

Shadowrocket 是 Apple 平台的付費用戶端,主要適用於 iPhone 與 iPad;Mac、Apple TV 與 Apple Vision 的相容性及系統需求,請以 App Store 頁面標示為準。

App Store 商品頁面

Shadowrocket 唯一的取得管道,也是核對價格、相容性與購買適用範圍的頁面。辨識時請同時確認官方圖示、開發者 Shadow Launch Technology Limited 與 App ID;只看名稱或搜尋結果排序不足以完成核對,詳細步驟請參閱正版辨識說明。

App ID

App Store 商品連結中的應用程式識別碼,Shadowrocket 對應的識別碼為 932747118,在連結中顯示為 id932747118。此識別碼用來區分特定 App,不是帳號編號,也不是購買憑證;即使不同商店顯示的語言或貨幣不同,仍應核對此識別碼。

一次買斷

指用戶端的購買方式,美國商店定價約為 2.99 美元,實際價格請以 App Store 頁面為準,各地商店會以當地貨幣顯示。用戶端一次買斷 ≠ 線路方案,連線仍須使用者已有的訂閱或伺服器資訊;購買 App 與維護這些連線資訊是兩回事。

已購項目

在 App Store 查看購買紀錄並重新取得 App 的入口。更換裝置或重新安裝時,請先確認目前使用的商店帳號及其購買紀錄。恢復 App 不等於還原用戶端內的設定,伺服器資訊與規則也須分別確認;家人共享的適用範圍請以商店頁面及帳號設定為準。