官方手冊 · 術語查閱

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

先確認名稱所在的介面,再閱讀對應說明。同一個 Config 可以指設定檔入口,也可以指 Global Routing 的一種模式;規則中的 PROXY 則不同於介面中的 Proxy 開關。

本頁適合用來對照 Shadowrocket 設定與設定檔內容。不同平台的入口位置可能不同;介面詞保留英文原文。所有匯入說明皆以使用者已有自己的訂閱或伺服器資訊為前提。

  • 5 類術語
  • 30 個查閱項目
  • 英文名稱保留原文

介面與開關

這類名稱會決定操作入口、連線處理方式或結果檢視方式。查閱時請區分「設定已儲存」、「連線已啟動」與「目標請求成功」這三種狀態。

介面與開關 / 01

Home

Home 是查看伺服器列表、目前選取項目與連線開關的介面。列表中出現項目只代表資訊已儲存,不表示該伺服器目前可以連線。初次使用時,請先核對選取的項目,再啟動連線並確認實際請求結果。

介面與開關 / 02

Global Routing

Global Routing 決定整體連線採用哪種處理模式:依設定檔規則處理為 Config,代理處理為 Proxy,直接連線為 Direct。Config 會依目前設定檔的規則分流;Proxy 採用代理方式,Direct 則直接連線。排查規則未生效時,請先確認沒有停留在其他模式。

介面與開關 / 03

Config

Config 可指設定檔管理入口,也可指 Global Routing 中依設定檔規則處理連線的模式。設定檔可包含 General、Rule 等區段;伺服器訂閱則主要用來管理伺服器項目。匯入伺服器列表後,仍須確認目前選用的設定檔。

介面與開關 / 04

On Demand

On Demand 會依預設條件觸發連線行為,建議在確認手動連線正常後再設定。它不會更新 Subscribe 內容,也無法補齊缺少的伺服器參數。如果連線自動啟動,除了查看 Home 的開關,也應檢查 On Demand 條件。

介面與開關 / 05

Connectivity Test

Connectivity Test 用來檢查目前測試方式與測試目標下的連線狀況,結果中的延遲通常以毫秒表示。延遲較低不代表下載速度一定較快;逾時也可能與測試目標或網路條件有關。排序前請保持測試條件一致,再以實際目標請求確認。

介面與開關 / 06

DNS

DNS 負責將網域名稱解析為 IP 位址,是建立連線前的重要環節。解析成功不代表後續路由或伺服器連線一定成功;解析失敗也不應直接歸因於訂閱失效。排查時請分別檢查網域解析、規則命中與連線結果,避免一次變更多項設定。

介面與開關 / 07

URL Rewrite

URL Rewrite 會依比對條件處理請求 URL,與決定連線方向的 Rule 屬於不同層面。適用範圍取決於請求類型及相關設定,並非所有請求內容都能直接讀取。設定前請先確認目標位址與比對範圍,不要將它視為通用的網頁內容篩選器。

協定

協定決定用戶端與伺服器如何交換資料。請依現有資料選擇對應類型;只更改協定名稱,卻沿用其他類型的參數,通常無法建立有效設定。

協定 / 08

Shadowsocks

Shadowsocks 是一種代理協定,常見必要資訊包括伺服器位址、連接埠、密碼與加密方式。加密方式須與伺服器端設定相符,不能只因密碼相同就省略核對。若現有資料還包含其他參數,也應完整保留,不要只複製位址。

協定 / 09

VMess

VMess 是一種具備使用者身分驗證的代理協定,使用者識別碼是連線參數之一。傳輸方式、路徑、Host 與 TLS 等資訊須依實際設定逐項核對,並非所有項目都採用相同組合。裝置時間明顯不準也可能影響驗證,排查時請一併確認系統時間。

協定 / 10

VLESS

VLESS 是一種代理協定,身分參數與傳輸、安全參數應分開理解。使用者識別碼正確,不代表 TLS、伺服器名稱或傳輸路徑也已設定相符。手動輸入時,請依使用者現有的完整資料設定,不要直接套用其他協定的欄位組合。

協定 / 11

Trojan

Trojan 通常搭配 TLS 使用;密碼用於驗證,伺服器名稱與憑證驗證則關係到安全連線的建立。連線位址與憑證對應的網域可能用途不同,不能只根據顯示名稱判斷。遇到憑證錯誤時,請先核對網域、系統時間與伺服器端設定,不要直接放寬驗證。

協定 / 12

Hysteria2

Hysteria2 是以 QUIC 為基礎的代理協定,連線需要網路允許相關 UDP 通訊。位址、連接埠、驗證資訊與 TLS 參數都須與伺服器端設定一致。若更換網路後結果不同,請先檢查網路如何處理 UDP,再判斷是否為項目參數問題。

協定 / 13

WireGuard

WireGuard 使用公私鑰建立加密通道,設定包含本機金鑰、對端公鑰、通道位址與對端連線位址。允許的位址範圍會影響哪些流量進入通道,並非一般的顯示備註。私鑰屬於敏感資訊,分享設定或提交排查資料前應先移除。

協定 / 14

HTTP / SOCKS5

HTTP 與 SOCKS5 是不同的代理協定,即使伺服器位址和連接埠相同,也不代表兩者可以互換。是否需要使用者名稱、密碼,以及是否有額外的安全傳輸設定,應以現有伺服器資料為準。代理協定名稱本身不能證明整段傳輸都已加密。

規則關鍵字與策略

先看比對條件,再看末尾的策略。規則通常依序處理;前面的規則已命中的連線,不會因後面出現更具體的規則就自動重新選擇。

規則關鍵字與策略 / 15

規則

一條規則會將比對條件與處理策略連結起來,說明「哪些連線要如何處理」。例如網域條件符合後,可交由 PROXY、DIRECT 或 REJECT 處理。排查時應同時核對規則順序與 Global Routing,不能只確認檔案中是否寫有目標網域。

規則關鍵字與策略 / 16

DOMAIN

DOMAIN 用來比對完整網域名稱,適合單獨處理特定主機。加入 DOMAIN,example.com,DIRECT 不代表也會涵蓋 www.example.com。規則中應填寫網域名稱本身,不要加上 URL 的通訊協定前綴或頁面路徑。

規則關鍵字與策略 / 17

DOMAIN-SUFFIX

DOMAIN-SUFFIX 依網域後綴比對,可涵蓋指定網域及其子網域。例如 DOMAIN-SUFFIX,example.com,PROXY 會將該網域範圍內的連線交由代理處理。比對依據是網域邊界,不是在任意網址文字中搜尋一段字串。

規則關鍵字與策略 / 18

GEOIP

GEOIP 依據 IP 地理位置資料庫比對目標位址。資料庫中的地理位置不等於網頁語言、網域後綴或網站營運者所在地,資料變更也可能影響比對結果。與網域規則混用時,請留意規則排列順序及解析後的實際目標 IP。

規則關鍵字與策略 / 19

IP-CIDR / IP-CIDR6

IP-CIDR 用於比對 IPv4 位址範圍,IP-CIDR6 用於比對 IPv6 位址範圍,斜線後的前綴長度會決定涵蓋範圍。範例 IP-CIDR,192.168.0.0/16,DIRECT 用來指定本機位址範圍直接連線。只設定 IPv4 條件時,不要假設 IPv6 連線也會符合。

規則關鍵字與策略 / 20

FINAL

FINAL 用來處理先前未符合規則的連線,通常放在 Rule 區段末尾作為備援。例如 FINAL,DIRECT 表示其餘連線直接送出。若將它提前,後續規則可能無法參與比對,因此調整設定後請檢查整個區段的順序。

規則關鍵字與策略 / 21

PROXY / DIRECT

PROXY 表示將符合條件的連線交由代理處理,DIRECT 表示直接連線至目標。大寫策略識別字與 Global Routing 中的 Proxy、Direct 介面詞屬於不同層級:前者用於單條規則,後者決定整體處理模式。DIRECT 也不代表應用程式已停止運作。

規則關鍵字與策略 / 22

REJECT

REJECT 會拒絕符合條件的連線,本身不會判斷頁面內容。若同一網域同時承載多項功能,條件設得太寬可能導致登入、圖片或其他正常請求一併失敗。新增規則後請測試目標行為;若影響範圍過大,應縮小條件或還原變更。

繼續閱讀訂閱與伺服器管理手冊 →

訂閱與伺服器欄位

匯入只是將資料寫入用戶端,不保證欄位完整或伺服器可用。以下操作皆以使用者已有相關資訊為前提;連結、QR Code 與設定檔都可能包含驗證憑證。

訂閱與伺服器欄位 / 23

Subscribe

Subscribe 用來透過現有連結取得並管理伺服器列表;訂閱連結不是一般網頁網址。更新時,遠端內容可能新增、移除或修改項目,因此本機列表變動不一定是用戶端出錯。連結中的 token 等參數通常具有存取權限,不應放進公開截圖或排查紀錄。

訂閱與伺服器欄位 / 24

Add Server

Add Server 是手動輸入伺服器參數的入口,應先選擇與現有資料相符的協定類型。更換協定後,必要欄位也可能不同,不能只填位址就儲存。完成後請逐項核對連接埠、驗證與傳輸設定,再為項目加上方便辨識的備註。

訂閱與伺服器欄位 / 25

伺服器位址與連接埠

位址指定連線目標,可以是網域名稱或 IP;連接埠則指定目標上的服務位置。顯示名稱僅供辨識項目,不能取代實際位址;網頁 URL 也不適合直接貼入位址欄位。手動輸入時請檢查多餘空格、全形符號,以及是否誤將路徑一併複製。

訂閱與伺服器欄位 / 26

驗證與 TLS 欄位

密碼、使用者名稱或使用者識別碼用於驗證;TLS 與伺服器名稱等參數則用於安全傳輸及伺服器身分驗證。兩者解決的問題不同,填寫其中一類不能取代另一類。遇到錯誤時請逐欄核對,避免以關閉憑證驗證來掩蓋位址或名稱不符的問題。

訂閱與伺服器欄位 / 27

Scan QR Code 與剪貼簿匯入

Scan QR Code 會讀取 QR Code 中的設定資料;剪貼簿匯入則讀取已複製的分享內容,兩者只是輸入方式不同。QR Code 或分享連結可能代表單一伺服器,也可能包含其他設定,請先確認內容類型。匯入後仍須核對結果,並避免在共用裝置上長期保留含有憑證的內容。

取得與正版核對

Shadowrocket 支援 iPhone、iPad、Mac、Windows、Android 與 Linux。iPhone / iPad 版從 App Store 取得;Mac 提供 Apple 晶片與 Intel 兩種版本。電腦與 Android 安裝檔由本站下載頁提供,下載路徑為本站 /dl/。

取得與正版核對 / 28

App Store 與應用程式 ID

請在 App Store 核對 iPhone / iPad 版的開發者 Shadow Launch Technology Limited、官方圖示與應用程式 ID 932747118。僅名稱相近不足以確認正版,系統需求請以 App Store 頁面標示為準。應用程式 ID 是產品識別資訊,不是目前帳戶的購買記錄。

取得與正版核對 / 29

已購項目

已購項目是 App Store 帳戶中的購買記錄,可在更換裝置或重新安裝時用來尋找已取得的應用程式。復原時請使用原購買帳戶,並確認目前商店是否提供該項目。重新下載用戶端與復原伺服器資訊是兩回事,操作前仍應妥善保存自己的設定。

取得與正版核對 / 30

用戶端授權與連線服務

iPhone / iPad 版在 App Store 售價 $2.99,為一次性付費;Mac / Windows / Android / Linux 版免費。用戶端一次買斷 ≠ 連線服務方案;取得應用程式不代表也取得伺服器或訂閱。本站不提供、不販售、不推薦節點或訂閱,只說明如何匯入及管理使用者現有的資訊。