官方手冊 / 術語索引

Shadowrocket 術語表
介面、協定與規則關鍵字

先辨別設定所屬層級,再判斷需要修改的項目。本頁保留介面英文原文,並以中文說明用途、適用條件與容易混淆之處;可依分類跳轉,也可直接引用各術語的錨點。

介面原文 協定參數 規則語法

準備首次連線,請參閱使用教學;已有設定但連線異常,請依疑難排解手冊查找原因。以下關於伺服器與訂閱的說明,皆以使用者已有自己的訂閱或伺服器資訊為前提。

介面與開關

連線入口與路由模式

開關負責建立連線,Global Routing 則決定如何處理請求。開關已開啟、伺服器已選取、規則已生效,是三件需要分別確認的事。

Home
Home 是查看連線開關、已儲存的伺服器與目前選取項目的主要介面。清單中顯示伺服器,只代表項目已儲存,不代表驗證成功或已建立連線。首次使用時,請先確認選取的項目,再操作連線開關,並透過實際請求驗證結果。
Global Routing
Global Routing 用來選擇整體路由方式:設定、代理、直連分別對應 Config、Proxy、Direct。Config 依目前設定中的規則處理請求,Proxy 以代理方式處理,Direct 則直接連線。排查特定網站的比對結果時,應先記下目前模式,否則修改規則後可能看不到預期變化。
On Demand
On Demand 會依設定的網路或存取條件觸發連線,不代表用戶端能自動修復失效的伺服器。啟用前,請先完成一次手動連線測試,再逐項新增觸發條件。若關閉開關後又出現連線,請檢查 On Demand 的條件是否仍然符合。
Add Server
Add Server 是手動輸入既有伺服器參數的入口。先選擇協定類型,再依原始資訊填寫位址、連接埠與驗證參數;TLS、傳輸方式等其他設定也須與伺服器端一致。名稱通常僅供辨識,不能取代實際伺服器位址。
Connectivity Test
Connectivity Test 用來觀察指定測試條件下的連線可達性與回應時間。測試通過僅表示該次探測收到回應,不代表所有網站、UDP 請求或大型檔案傳輸都能正常運作。若測試結果與實際存取狀況不一致,應綜合測試方法、目標位址與連線記錄判斷。
Settings
Settings 集中顯示用戶端相關設定,實際項目請以目前平台及 App 內介面為準。排查時先記錄原始值,每次只變更一個相關選項,再以相同的驗證請求重新測試。不要將伺服器的協定參數與用戶端全域設定混在一起修改。
協定

協定類型與連線參數

協定名稱決定用戶端與伺服器的通訊方式,不直接代表連線速度。請依既有伺服器資訊選擇類型,不能只更改下拉選單就將一種協定轉換成另一種。

Shadowsocks
Shadowsocks 是一種代理協定,常見參數包括伺服器位址、連接埠、密碼與加密方式。加密方式必須與伺服器端一致,不能因名稱相似就替換。若原始資訊還包含外掛或其他傳輸參數,也須一併核對,不能只保留位址與密碼。
VMess
VMess 使用使用者識別碼等資訊進行驗證,也可搭配不同傳輸方式。匯入後應一併檢查使用者識別碼、連接埠、傳輸類型與 TLS 設定,而不只是核對伺服器名稱。若遇到驗證異常,也須確認裝置時間是否正確。
VLESS
VLESS 使用使用者識別碼進行驗證;協定類型與傳輸層安全設定應分開理解。填入正確的使用者識別碼,不代表可以省略 TLS、伺服器名稱或傳輸路徑等項目。連線失敗時,應逐項比對既有設定,而非反覆變更無關的 DNS 設定。
Trojan
Trojan 通常搭配 TLS 與密碼驗證使用,位址、連接埠、密碼與伺服器名稱須彼此相符。憑證驗證失敗與密碼錯誤是不同問題,應從錯誤記錄判斷。不要為了讓測試通過就直接略過憑證檢查;請先確認網域、裝置時間與伺服器端的憑證設定。
Hysteria2
Hysteria2 是以 QUIC 為基礎的代理協定,運作條件與 UDP 是否可連通有關。除了伺服器位址與驗證資訊,也應依既有設定核對 TLS 與相關參數。如果在某個網路無法連線、換網路後恢復,可將 UDP 傳輸條件列為排查方向,但不能只憑現象就認定原因。
WireGuard
WireGuard 使用金鑰組建立加密通道,常見設定還包含端點、通道位址與路由範圍。公開金鑰、私密金鑰與預先共用金鑰各有用途,不能互換填寫;私密金鑰應妥善保管。交握成功與目標位址是否依預期路由,是兩項需要分別驗證的結果。
HTTP / SOCKS5
HTTP 與 SOCKS5 是不同的代理協定類型,不能因為使用相同位址就任意互換。HTTP 代理會處理 HTTP 代理請求及 CONNECT 等情境;SOCKS5 則在建立連線時使用自己的交涉方式。驗證需求與 UDP 支援情況也會受伺服器端實作影響,請依既有伺服器說明設定。
規則關鍵字

比對條件與處理策略

規則前半部說明「比對什麼」,策略部分說明「如何處理」。以下的 example.com 等位址僅用於說明語法,不是可供連線的伺服器資訊。

DOMAIN / DOMAIN-SUFFIX / DOMAIN-KEYWORD
DOMAIN 比對完整網域名稱;DOMAIN-SUFFIX 比對指定網域及其子網域;DOMAIN-KEYWORD 比對網域中包含的關鍵字。例如 DOMAIN-SUFFIX,example.com,PROXY 會將符合範圍的請求交由 PROXY 處理。網域欄位不是完整 URL,不應填入通訊協定前綴或頁面路徑。
IP-CIDR / IP-CIDR6
IP-CIDR 比對 IPv4 位址範圍,IP-CIDR6 用於 IPv6;範圍由位址與斜線後的前綴長度共同表示。例如 IP-CIDR,192.168.0.0/16,DIRECT 說明一個 IPv4 網段的處理方式。這些規則比對的是位址,而非網域名稱;確認比對結果時,須參考實際目標 IP。
GEOIP
GEOIP 依 IP 資料庫中的地理區域資訊比對目標位址,例如 GEOIP,CN,DIRECT。資料庫記錄、DNS 回傳的位址,以及目標使用的內容傳遞網路,都可能影響結果。此規則無法精確判定網站營運者所在地,也不應取代對特定網域的規則檢查。
FINAL
FINAL 指定未符合前面規則時採用的最終策略,通常放在規則清單末尾。例如 FINAL,PROXY 會將其餘請求交由 PROXY 處理。若前面已有範圍較廣的規則符合,請求不會因為末尾寫了 FINAL 就重新選擇策略。
PROXY / DIRECT / REJECT
這三個大寫關鍵字是規則中的策略:PROXY 交由代理處理,DIRECT 直接連線,REJECT 拒絕請求。它們與 Global Routing 中的 Proxy、Direct 介面選項屬於不同層級。看到某條 REJECT 規則符合時,應檢查該規則的用途,而不是立即將狀況歸因於伺服器逾時。
Rule
Rule 是由比對條件與處理策略組成的規則,通常依設定順序逐條檢查,並由符合的項目決定處理方式。較具體的例外規則應放在可能涵蓋它的廣泛規則之前。修改後先儲存並確認目前的 Config,再以相同的目標請求檢查比對結果,避免同時修改多個項目而難以判斷。
訂閱與設定

匯入、解析與驗證內容

伺服器項目儲存連線參數,訂閱負責取得或更新內容,而 Config 則包含規則等設定。匯入成功只完成其中一個步驟,仍須確認選取狀態並測試實際存取。

Subscribe
Subscribe 指透過使用者既有的訂閱網址取得並更新伺服器項目的機制。訂閱回傳的內容可能是一組連線資訊,不一定包含完整規則與 DNS 設定。請妥善保管連結中的存取憑證;排查時不要公開完整網址。更新失敗也不代表已儲存的所有項目會立即失效。
SERVER
SERVER 對應用戶端連線所使用的遠端伺服器項目,通常包含協定、位址、連接埠與驗證資訊。中文說明中的「節點」在此指這類連線項目,不是訂閱本身。項目名稱與地區標籤主要供辨識,實際連線條件仍應以參數與測試結果為準。
Config
Config 可以指儲存規則、DNS 等設定的設定檔,也可以指 Global Routing 中依設定處理請求的模式。檔案存在、檔案已選取,以及整體模式採用 Config,是不同狀態。修改前先保留原設定,儲存後確認目前使用的項目,再驗證目標請求的規則比對結果。
DNS
DNS 會將網域名稱解析為 IP 位址;解析過程與建立代理連線並非同一件事。網域無法存取時,應區分解析逾時、回傳位址異常與伺服器連線失敗。調整 DNS 前先記錄原設定,並以相同網域重新測試;單次解析成功,也不能證明後續連線或路由一定正確。
延遲
延遲表示依指定方法與目標進行一次測試的回應時間,通常以毫秒顯示。數值較小不代表頻寬一定較高,也無法反映長時間傳輸、封包遺失或所有服務的使用體驗。比較結果時,應盡量使用相同網路與測試方法,並搭配實際存取驗證。
URL Rewrite
URL Rewrite 依比對運算式變更 URL 的處理方式,與選擇代理或直連出口的路由規則不同。是否生效取決於比對條件、請求類型與相關設定,不能假設它能讀取所有加密請求的完整內容。修改時先限定目標範圍,並保留原設定以便還原。
Scan QR Code
Scan QR Code 用來辨識 QR Code 中儲存的連線或設定內容,本身不是獨立的代理協定。掃描後仍須核對協定、位址、驗證資訊與其他參數,並確認內容來自自己的既有設定。QR Code 也可能包含敏感憑證,不應直接公開截圖。
安裝與平台

取得管道與安裝檔類型

Shadowrocket 是適用於多平台的閉源商業應用程式。iPhone / iPad 版透過 App Store 取得,費用為 $2.99,一次性付費;Mac(Apple 晶片與 Intel)、Windows、Android、Linux 版免費。各平台的取得方式與系統安全性設定請參閱下載頁。

App Store
App Store 是 iPhone / iPad 版的取得管道,系統需求以 App Store 頁面標示為準。請在產品頁核對開發者 Shadow Launch Technology Limited、官方圖示與 App ID 932747118。如需取得 App,請前往下載頁的 iPhone / iPad 區段查看商店連結與說明。
已購項目
已購項目是透過 Apple 帳號尋找已取得 App 的位置;更換裝置或重新安裝時,請使用原購買帳號尋找 Shadowrocket。iPhone 與 iPad 可透過同一購買帳號重新取得;是否顯示下載選項也會受裝置相容性與商店狀態影響。若再次出現購買提示,請先確認目前用於商店購買的帳號,不要直接重複付款。
Apple 晶片 / Intel
這兩項代表 Mac 的處理器類型,可在「關於這台 Mac」中確認後,選擇對應的 dmg 安裝檔。本網站下載頁分別提供 Apple 晶片版與 Intel 版,安裝檔由本站的 /dl/shadowrocket/ 路徑提供。首次開啟若提示無法驗證開發者,確認來源後,請在「隱私權與安全性」中選擇「仍要打開」;其他提示請參閱安裝安全性設定說明。
deb / rpm / AppImage
以下是 Linux 的不同套件格式:Debian / Ubuntu 通常使用 deb,Fedora 等發行版通常使用 rpm;AppImage 則須視執行環境而定。下載 AppImage 後須授予執行權限;使用套件管理器安裝時,也應依所選格式操作。請先在Linux 下載區段選擇本站安裝檔,再依安裝表檢查權限與相依套件。

術語說明可協助找到設定位置,但不能取代操作流程。請繼續閱讀首次連線教學,或依疑難排解手冊中的症狀逐項檢查。