官方手冊 · 術語索引

Shadowrocket 術語表

先確認詞語出現的位置,再判斷它影響的內容。本文依介面、協定、規則、設定與購買分類,保留英文原文,說明操作用途及容易混淆之處。

  • 介面用語區分大小寫
  • 規則依序由上而下比對
  • 協定參數以現有資訊為準
01 / interface

介面與開關

這些名稱用於尋找功能入口、切換模式或查看連線狀態。模式選擇、系統連線開關與測試結果各自代表不同資訊。

介面與開關Home
Home 是檢視伺服器列表、選取目前使用的伺服器及操作連線開關的主要頁面。匯入項目後,須先確認已選取預期的伺服器,而不只是看到它出現在列表中。列表中有項目、開關已開啟、實際請求可正常使用,是三種須分別確認的狀態。
介面與開關Global Routing
Global Routing 用來決定請求採用哪種整體路由方式。設定、代理、直連分別對應介面中的 Config、Proxy、Direct:Config 依目前設定處理,Proxy 使用代理路徑,Direct 使用直連路徑。它不是伺服器協定選擇器;切換模式不會自動修正伺服器驗證參數。
介面與開關Config
Config 可指設定檔管理頁面,也可指 Global Routing 中依設定運作的模式。在頁面中檢視或編輯檔案,不代表該檔案已成為目前使用的設定。若要套用分流規則,須同時確認目前使用的設定檔及 Global Routing 的選擇。
介面與開關Proxy
Proxy 是 Global Routing 中的代理模式,會讓由此模式處理的請求採用代理路徑。它不能取代對伺服器位址、驗證資訊與可達性的查核。請留意它與規則策略 PROXY 的大小寫及使用位置不同;後者只表示符合規則後的處理方式。
介面與開關Direct
Direct 是 Global Routing 中的直連模式,表示以直連路徑處理請求。選擇 Direct 不等同於關閉系統 VPN 設定,也不代表伺服器項目已刪除。排查時可藉此比較代理與直連路徑的狀況,但單次測試無法證明所有目標都能連線。
介面與開關On Demand
On Demand 會在符合預設條件時觸發連線,實際行為同時受 App 設定與系統 VPN 設定影響。它不是保證連線始終可用的狀態指示器。手動中斷後若又自動連線,請檢查相關條件,再核對系統中的 VPN 設定。
介面與開關Connectivity Test
Connectivity Test 是檢查連線是否可用的測試入口,結果反映測試當下的網路與伺服器狀態。一次測試通過,不代表每個網域、App 或協定都能正常運作;測試失敗也無法單憑結果判定是驗證錯誤。應一併檢查目前使用的伺服器、Global Routing 與實際存取目標。
介面與開關Data
Data 用於檢視 App 記錄的流量使用情況,可協助觀察連線期間是否有資料傳輸。App 統計與服務商計費可能採用不同的範圍、週期及計算方式。查核剩餘流量時,請以服務商提供的帳戶紀錄為準,不要直接將本機數值視為帳單資料。
介面與開關Settings
Settings 是管理 App 設定的入口,實際選項以目前 App 顯示為準。遇到連線問題時,先記錄原有設定,再一次只調整一個相關選項。若同時變更多項設定,即使狀況改善,也難以判斷是哪一項發揮作用。
02 / protocols

協定

協定名稱決定參數的解讀方式,不代表速度等級。新增前先確認現有伺服器的協定類型,再逐項填入對應欄位。

協定Shadowsocks
Shadowsocks 是一種代理協定,常見設定包含伺服器位址、連接埠、加密方式與密碼。加密方式須與伺服器端一致,不可只因名稱相似就替換。若服務商另有提供其他參數,也應一併核對,不能只複製位址與連接埠。
協定VMess
VMess 使用使用者識別碼等參數進行驗證,設定中也可能包含傳輸方式與 TLS。使用者識別碼正確,只能表示驗證資訊的其中一部分已核對,並不代表傳輸層設定相符。匯入後若無法連線,請比對原始資訊並檢查相關欄位,不要反覆切換 Global Routing。
協定VLESS
VLESS 是一種代理協定,使用者識別碼、傳輸方式與安全層參數須分別核對。協定名稱本身不代表連線已具備哪些加密或憑證驗證條件。使用時應以伺服器端提供的完整參數為準,不要直接套用其他設定的安全選項。
協定Trojan
Trojan 通常搭配 TLS 使用,驗證密碼與憑證相關參數都會影響連線。伺服器連線位址與 TLS 驗證所用的名稱可能用途不同,請依現有設定填寫。若出現憑證驗證錯誤,先檢查名稱、裝置時間及伺服器端憑證狀況,不應將略過驗證當成一般處理方式。
協定Hysteria2
Hysteria2 是以 QUIC 為基礎的代理協定,網路是否可使用 UDP 會影響連線狀況。驗證資訊、TLS 與其他相關參數也須符合伺服器端設定。支援此協定不代表目前的網路路徑一定可用;排查時應分開檢查網路條件與欄位設定。
協定WireGuard
WireGuard 是使用公開金鑰驗證的通道協定,設定包含本機金鑰、對端公鑰、對端位址及允許的位址範圍等資訊。允許的位址範圍會影響哪些目標經由通道傳輸,不只是驗證參數。私密金鑰應妥善保管;分享螢幕截圖或診斷文字前,務必先移除。
協定HTTP / SOCKS5
HTTP 與 SOCKS5 是兩種不同的代理協定,請在 Add Server 中依伺服器實際類型選擇。兩者的驗證方式、網域解析處理及 UDP 支援不可混為一談。支援某種代理協定,也不代表連線預設採用加密傳輸;須另外核對相關設定。
03 / rules

規則關鍵字

一條規則通常由比對類型、比對目標與處理策略組成。規則依序檢查,因此較具體的規則應放在適用範圍較廣的規則之前。

規則關鍵字DOMAIN
DOMAIN 用於比對完整網域名稱,適合只處理特定主機名稱。例如 DOMAIN,example.com,DIRECT 指向 example.com,不會自動涵蓋所有子網域。網域規則的目標是主機名稱,不應在此欄位填入包含路徑的完整網頁網址。
規則關鍵字DOMAIN-SUFFIX
DOMAIN-SUFFIX 依網域後綴比對,可同時處理指定網域及其子網域。例如目標設為 example.com 時,也會涵蓋 www.example.com。它不是任意字串包含比對;若要比對網域中的某段字元,應了解 DOMAIN-KEYWORD 的用途。
規則關鍵字DOMAIN-KEYWORD
DOMAIN-KEYWORD 會檢查網域是否包含指定的關鍵字串,涵蓋範圍可能遠大於單一網域。例如關鍵字 example 可能符合多個不同後綴的網域。撰寫規則時應評估誤判範圍,不宜使用過短或常見的字串作為精確網站識別。
規則關鍵字GEOIP
GEOIP 依目標 IP 在位址資料庫中的地區分類進行比對,不是用來辨識頁面內容所用的文字、網域後綴或使用者所在地。資料庫紀錄可能與服務實際營運地點不同,也可能因位址變動而受影響。若要穩定處理特定網域,不應只依地區分類推測比對結果。
規則關鍵字IP-CIDR / IP-CIDR6
IP-CIDR 比對 IPv4 位址範圍,IP-CIDR6 比對 IPv6 位址範圍;斜線後的數字表示網路前綴長度。例如 IP-CIDR,192.168.0.0/16,DIRECT 表示一段 IPv4 範圍。檢查目標時也須留意位址類型;只設定 IPv4 規則不代表已涵蓋相應的 IPv6 連線。
規則關鍵字FINAL
FINAL 是前面的規則都未符合時採用的預設規則,通常應放在規則列表末尾。例如 FINAL,PROXY 表示其餘請求交由 PROXY 處理。若將預設規則提前,後面的規則可能就沒有比對機會;排查時須一併檢查規則內容與排列位置。
規則關鍵字PROXY / DIRECT / REJECT
這些是規則中的處理策略:PROXY 使用代理路徑,DIRECT 使用直連路徑,REJECT 拒絕請求。策略說明符合規則後如何處理,不負責指定比對條件。PROXY 本身也不包含伺服器憑證;實際代理路徑仍取決於目前有效的伺服器或設定中的策略安排。
04 / configuration

訂閱與設定

伺服器項目負責連線參數,設定檔負責規則與相關行為。兩者可以搭配使用,但匯入其中一項不代表所有設定都已完成。

訂閱與設定Subscribe
Subscribe 是透過訂閱取得及更新伺服器項目的機制,訂閱連結請向你的服務商取得。更新訂閱可能變更項目名稱、數量或連線參數,不代表本機所有分流規則也會同步更新。連結通常包含存取憑證,轉傳或公開前請先移除敏感資訊。
訂閱與設定Add Server
Add Server 是新增伺服器資訊的入口,Type 須符合你現有伺服器使用的協定。位址、連接埠、驗證資訊與傳輸參數應一併核對,不要混用不同項目的欄位。手動新增完成後,還須返回 Home 選取該項目並測試連線。
訂閱與設定設定檔
設定檔包含規則及相關設定,與只提供伺服器項目的訂閱並非同一概念。匯入檔案後,請確認是否已設為目前使用的設定檔,並核對 Global Routing 是否選用 Config。遠端更新與本機修改也可能互相影響,調整前建議先保存原有內容,以便還原。
訂閱與設定DNS
DNS 會將網域名稱解析為 IP 位址;解析成功與後續連線成功是兩個不同階段。若無法透過網域存取,但直接使用 IP 測試時結果不同,可將解析過程列為檢查方向,但不能據此直接判定原因。變更 DNS 設定前,請先記錄原有值,並確認目前設定中是否另有相關項目。
訂閱與設定URL Rewrite
URL Rewrite 會對符合條件的 URL 套用改寫規則,與只決定連線路徑的規則分流不同。它可能變更請求目標或處理方式,因此須同時了解比對條件與改寫動作。涉及加密請求時,也須具備相應的處理條件;並非加入一行規則就一定會生效。
05 / app store

App Store 與購買

App 購買、伺服器服務與設定資料是不同事項。Shadowrocket 僅於 Apple 平台發行,唯一取得管道為 App Store。

App Store 與購買App Store 正版查核
購買前請核對開發者 Shadow Launch Technology Limited、與本站一致的官方圖示,以及產品頁上的 App ID 932747118。只憑名稱相似或搜尋排序,無法取代這三項查核。iPhone 與 iPad 是主要使用裝置;Mac、Apple TV、Apple Vision 的相容性、系統需求及購買適用條件,均以 App Store 頁面標示為準。
App Store 與購買一次買斷
一次買斷是購買用戶端的付款方式,現行價格與購買適用條件以 App Store 頁面標示為準。用戶端一次買斷 ≠ 線路方案,付款購買 App 不會自動取得伺服器連線資料。使用前仍須備妥既有訂閱或伺服器資訊,相關資料請向你的服務商取得。
App Store 與購買已購項目
已購項目是 App Store 帳號中的購買紀錄,可在重新安裝或更換裝置時用來查找已購買的 App。請確認目前使用的商店帳號是否為原購買帳號;實際還原條件以 App Store 頁面標示為準。重新取得 App 不代表本機設定、伺服器資訊及其他資料也會自動還原。

需要查核商店入口或還原流程?請查看正版查核說明與已購項目還原步驟。其他連線問題可繼續參閱FAQ。