官方手冊 · 名詞對照

Shadowrocket 術語表

先對照介面原文查明詞義,再回到對應設定核對。這裡分別說明協定類型、比對條件、處理策略與購買記錄,避免把不同層次的名詞混為一談。

英文大小寫具有實際用途:介面模式 Proxy 與規則策略 PROXY 並非相同設定;Config 既可指頁面入口,也可指 Global Routing 中的設定模式。

[General]

介面與開關

先確認所在頁面與目前模式。清單中有伺服器、連線開關已開啟、請求依預期分流,分別代表不同狀態。

介面與開關

Home

查看伺服器清單、選取預設伺服器及操作連線的主要頁面。成功匯入只表示項目已加入清單,不代表驗證資訊正確,也不代表目前網路能連上該伺服器。首次連線時,請先確認選取的項目,再處理連線開關與系統授權。

介面與開關

Add Server

手動填寫既有伺服器資訊的入口。先依服務商提供的資訊選擇協定類型,再核對位址、連接埠、驗證及傳輸參數;不同類型顯示的欄位不盡相同。不要只填入名稱和位址就認為設定完整,名稱只是方便辨識的標籤。

介面與開關

Config

作為頁面入口時,用來管理及選取設定檔;作為 Global Routing 模式時,表示依設定檔中的規則處理請求。檔案已儲存,不代表已選取並啟用。排查規則未生效時,需同時確認目前使用的檔案與 Global Routing 狀態。

介面與開關

Global Routing

決定整體路由方式的設定,常見模式有配置、代理、直連,對應介面用語 Config、Proxy、Direct。Config 依設定規則處理,Proxy 採用代理模式,Direct 採用直連模式。這是全域模式選擇,不能與單條規則末尾的策略關鍵字混為一談。

介面與開關

On Demand

依設定條件觸發 VPN 連線的機制,不是定時更新訂閱的功能。是否觸發也取決於系統授權、目前網路及 App 內的條件。若手動關閉連線後又出現連線狀態,請先檢查 On Demand 設定,不要直接認定 App 異常。

介面與開關

Connectivity Test

協助判斷連線可達性的診斷功能。測試成功只表示在該次測試條件下路徑可用,不能據此推斷所有網站、協定與規則路徑都能正常運作。結果異常時,請結合預設伺服器、Global Routing、DNS 與實際請求記錄繼續排查。

介面與開關

DNS

將網域名稱解析為 IP 位址的機制,通常發生在建立目標連線之前。解析失敗可能導致網域無法開啟;解析成功後,連線仍可能因路由或伺服器問題而失敗。不要一次修改多組 DNS 與規則設定,請保留原設定並逐項驗證。

[Proxy]

協定

協定決定雙方如何通訊與驗證,並不直接代表速度。填寫時請以既有伺服器參數為準,不要只憑名稱更換協定類型。

協定

Shadowsocks

使用指定加密方式及驗證資訊傳輸代理流量的協定。伺服器位址、連接埠、密碼與加密方式都必須與伺服器端一致;即使密碼正確,加密方式不同也可能無法連線。若既有項目還包含其他配套參數,也請一併保留,不要只複製其中幾個欄位。

協定

VMess

使用 UUID 等身分資訊的代理協定,驗證參數只是完整設定的一部分。傳輸方式、Host、路徑及 TLS 等配套設定也可能影響連線,請依伺服器端要求填寫。不能只把 VMess 項目的類型改成 VLESS,就認為已完成協定轉換。

協定

VLESS

使用 UUID 驗證,且協定本身不提供負載加密的代理協定。連線安全性取決於 TLS 等配套傳輸設定,因此不能只看到 UUID 就認為參數齊全。核對時應分別檢查身分資訊、傳輸方式與安全設定,避免混淆伺服器端網域名稱與顯示名稱。

協定

Trojan

通常搭配 TLS 使用,並以密碼驗證的代理協定。除了伺服器位址與密碼,也應確認伺服器端網域名稱及憑證驗證相關設定。憑證出錯時,請先確認網域名稱、裝置時間與伺服器憑證,不應把關閉驗證當作一般修復方式。

協定

Hysteria2

以 QUIC 為基礎、底層使用 UDP 的代理協定。驗證資訊及 TLS 參數需與伺服器端一致,目前網路對 UDP 的處理方式也會影響連線可達性。連線失敗時,應先分辨參數錯誤與傳輸路徑問題,不能只憑協定名稱判斷它在特定網路中的表現。

協定

WireGuard

使用公私鑰、對端位址及相關網路參數建立加密通道的協定。公鑰與私鑰用途不同,不能互換;匯入時也應核對位址與路由範圍等資訊。私鑰屬於敏感資料,向他人求助時應予以隱藏,切勿將完整設定直接貼到公開內容中。

協定

HTTP / SOCKS5

兩種不同的代理協定類型,連線協商方式與支援的行為並不相同。位址、連接埠、驗證方式及是否使用 TLS,應依伺服器實際設定填寫,不能只憑常見連接埠推斷協定。協定名稱本身也不代表所有資料都已加密,請核對實際傳輸設定。

需要區分身分驗證與傳輸設定時,可繼續閱讀VMess 與 VLESS 欄位對照。

[Rule]

規則關鍵字

規則前段說明「比對什麼」,末尾策略則說明「如何處理」。以下片段僅用於說明語法,並非完整設定檔。

規則關鍵字 · 比對條件

DOMAIN-SUFFIX

依網域後綴比對,涵蓋指定網域及其子網域。例如 DOMAIN-SUFFIX,example.com,PROXY 可用來比對 example.com 和 api.example.com。這不是任意字串包含比對,命中後會採用末尾指定的策略。

規則關鍵字 · 比對條件

GEOIP

依據 IP 位址的地區歸屬資訊進行比對,不是依網頁語言或網域後綴判斷。結果取決於實際比對到的位址與使用的地區資料庫。同一網域可能解析出多個位址,因此不能只憑網域名稱預測每次的比對結果。

規則關鍵字 · 比對條件

IP-CIDR

依 IPv4 位址網段比對,斜線後的前綴長度決定網段範圍。例如 IP-CIDR,192.168.0.0/16,DIRECT 表示該網段採用 DIRECT。範圍越大,可能涵蓋的位址越多;修改前應確認是否會影響其他目標。

規則關鍵字 · 比對條件

IP-CIDR6

依 IPv6 位址網段比對,與 IP-CIDR 適用的位址類型不同。只新增 IPv4 網段規則,不會自動涵蓋 IPv6 請求。如果同一網域的連線行為不一致,請依實際連線位址檢查,不能只看是否命中 IPv4 規則。

規則關鍵字 · 末尾規則

FINAL

前面的規則都未命中時,用來處理其餘請求的末尾規則。例如 FINAL,PROXY 表示其餘請求使用 PROXY。它不是「強制所有請求都走代理」的獨立開關,前面已命中的規則仍會決定各自請求的處理方式。

規則關鍵字 · 處理策略

PROXY

表示以代理方式處理的規則策略關鍵字,通常寫在規則末尾。實際出口仍須依目前選取的伺服器及相關設定而定。它與 Global Routing 中的 Proxy 模式名稱相近,但前者是單條規則的處理結果,後者則是整體路由模式。

規則關鍵字 · 處理策略

DIRECT

表示直接連線至目標,不以代理伺服器作為該請求的出口。DIRECT 不代表請求不經過系統網路處理,也不表示 DNS 一定採用固定路徑。若目標本身無法連線,將規則改成 DIRECT 也不會自動恢復連線。

規則關鍵字 · 處理策略

REJECT

表示拒絕符合該規則的請求,而不是改用其他伺服器重試。如果某個網域或 App 一直無法連線,請檢查是否誤中 REJECT。修正規則時,優先縮小比對範圍並確認順序,不要直接刪除所有相關規則。

規則關鍵字 · 比對條件

DOMAIN

依完整網域名稱比對,例如 DOMAIN,api.example.com,PROXY 只適用於指定網域。它不會自動比對 example.com 或其他子網域。若要涵蓋整個網域後綴,請先了解 DOMAIN-SUFFIX 的比對範圍,再選擇合適的關鍵字。

[General]

訂閱與設定

伺服器項目負責連線參數,設定檔負責規則等設定,訂閱則用來集中取得及更新項目。三者彼此相關,但不能互相取代。

訂閱與設定

Subscribe

用來集中取得及更新伺服器項目的訂閱類型,網址由使用者向既有服務商取得。更新可能變更項目的名稱、數量與參數,手動修改的內容也可能在後續更新時被覆寫。訂閱網址可能包含身分資訊,複製、備份及求助時都應妥善保管。

訂閱與設定

伺服器

App 中的一個連線項目,也常稱為節點,包含協定、位址、連接埠及相應的驗證資訊。項目名稱只是本機辨識用的標籤,重新命名不會改變伺服器所在地或連線能力。測試逾時也不一定表示項目格式錯誤,還需檢查伺服器端狀態與目前網路。

訂閱與設定

規則

將比對條件與處理策略連結的設定指令,例如依網域決定使用 PROXY 或 DIRECT。規則通常依序比對,因此同一條規則放在不同位置,可能產生不同結果。修改前請先儲存原始檔案,並以實際請求驗證,不要只確認檔案是否成功儲存。

訂閱與設定

Config 設定檔

儲存規則、DNS 等設定的文字檔案,可包含 [General]、[Rule] 等設定區段。它不等於伺服器訂閱;匯入設定檔也不代表已有可連線的伺服器。儲存、選取啟用及切換 Global Routing 是不同操作,需逐一確認。

訂閱與設定

iCloud 同步

透過 Apple 帳號及 App 支援的同步設定,儲存並同步相關資料。App 購買記錄與設定同步是兩回事,重新下載後仍應檢查伺服器、設定檔及其選取狀態。更換裝置前,建議另存必要設定,並在新裝置確認完成前保留舊裝置資料。

查看設定備份與轉移步驟 →
[General]

App Store 與裝置

購買 App、還原購買記錄與還原設定資料是三個不同環節。商店資訊可用來確認產品與相容性,不能取代連線參數。

App Store 與裝置

App Store

Shadowrocket 唯一的購買與安裝管道。核對時請確認官方圖示、開發者 Shadow Launch Technology Limited 與 App ID 932747118,不要只看搜尋結果中的名稱。購買與更新都透過 App Store 處理,詳細核對步驟請參閱正版確認。

App Store 與裝置

已購項目

查找原 Apple ID 購買記錄並重新下載 App 的入口,實際入口名稱可能隨系統介面變動。找不到記錄時,請先確認購買時使用的帳號及商店地區。還原 App 本身不會自動還原伺服器和規則資料,仍需檢查備份或同步結果。

App Store 與裝置

一次性買斷

指一次性購買用戶端 App;美國商店售價約為 2.99 美元,實際金額請以 App Store 頁面為準,各商店會以當地貨幣顯示。一次買斷用戶端 ≠ 線路方案,購買 App 不代表也取得伺服器或訂閱。相關連線資訊仍由使用者向既有服務商取得。

App Store 與裝置

裝置相容性

指 App Store 頁面列出的支援裝置與系統需求。Shadowrocket 主要用於 iPhone / iPad;Mac、Apple TV、Apple Vision 也可在同一商店頁的相容性欄確認,系統需求及是否支援通用購買均以 App Store 頁面標示為準。不要只憑裝置名稱推斷購買權益。

確認詞義後仍不清楚如何操作,可依快速入門核對完整流程;需要安裝或還原 App 時,請參閱App Store 正版下載說明。