OFFICIAL MANUAL · GLOSSARY

Shadowrocket
術語與規則速查

先判斷術語屬於哪個層級,再修改相應設定。本頁依英文介面用語、協定名稱與規則關鍵字說明其意義;若要依序操作,請參閱使用說明。

UI · 介面層 RULE · 規則層

注意大小寫:Proxy 是介面模式,PROXY 是規則策略;請勿將兩者視為同一處設定。

01 / INTERFACE & SWITCHES

介面與開關

介面入口用來整理操作,Global Routing 則決定整體處理模式。先確認入口與模式,再檢查具體規則是否符合。

UI

Home

Home 是查看伺服器項目與連線狀態的起點。連線前先確認目前選取的項目,再檢查 Global Routing;項目存在不代表已通過驗證或可以使用。需要新增資訊時,可從 Add Server 或匯入既有訂閱的流程開始。

UI

Global Routing

Global Routing 決定整體流量處理方式,分為 Config(設定)、Proxy(代理)及 Direct(直連)三種模式。Config 依目前設定判斷流量去向;另外兩種模式則分別選擇整體代理或直連路徑。排查前請記錄目前模式,避免將模式變更誤認為規則變動。

UI

Config

Config 可指設定管理介面,也可指 Global Routing 中依設定處理流量的模式,需依所在位置判讀。選擇此模式後,流量去向由目前生效的設定決定。匯入檔案不代表已啟用,請再確認目前設定及 Rule 內容。

UI

Proxy

Proxy 是 Global Routing 中使用代理路徑的模式,可用來檢查目前伺服器連線是否正常。若在 Proxy 模式下可以存取,但 Config 模式異常,應進一步檢查規則與解析設定。這不是規則項目中的大寫 PROXY;測試完成後,請恢復原本需要的模式。

UI

Direct

Direct 是 Global Routing 中使用直連路徑的模式,可用來觀察目前網路直接存取的情況。這不會刪除已儲存的伺服器或設定,也不等於關閉系統 VPN 狀態。診斷時應分別記錄路由模式、連線開關與目標存取結果。

UI

On Demand

On Demand 會依設定條件觸發連線行為,條件可能包括 Wi-Fi、行動網路或網域。若手動中斷後又自動連線,請先檢查是否仍有符合條件。調整時逐一確認條件與順序,並在實際切換網路後驗證,不要只看開關狀態。

UI

Settings

Settings 是管理應用程式相關設定的入口,具體選項請以目前 App 內的文字為準。遇到問題時先記錄原始值,再一次修改一個變數,避免同時變更多處而無法判斷原因。設定檔中的同類設定也應一併核對,不能只憑入口名稱判斷最終行為。

UI

Data

Data 用來查看流量與請求相關記錄,適合在實際存取後進行核對。流量數值增加只能表示有活動發生,無法單獨證明請求採用了預期策略。排查時請一併查看目標網域、符合的規則與連線結果;分享記錄前先移除敏感資訊。

02 / PROTOCOLS

協定

協定決定兩端如何建立連線與交換資料。選擇類型必須與既有伺服器資訊一致;名稱相近或欄位相似,不代表參數可以互換。

PROTOCOL

Shadowsocks

Shadowsocks 是需要兩端使用相同加密方式及憑證的代理協定。填寫時請核對地址、連接埠、密碼及伺服器要求的其他參數,不要只檢查密碼。匯入後若無法連線,請回頭逐項比對原始資料,而非任意更換加密方式。

PROTOCOL

VMess

VMess 使用身分資訊進行驗證,傳輸方式與 TLS 設定也會影響連線建立。伺服器地址、使用者識別碼、路徑及伺服器名稱可能各有不同用途,不能互相取代。驗證資訊正確但仍無法連線時,也請檢查裝置時間與相應傳輸參數。

PROTOCOL

VLESS

VLESS 將身分驗證與傳輸安全設定分開處理,使用者識別碼本身不代表連線已獲得完整保護。新增項目時,應一併核對傳輸類型、TLS 及伺服器指定參數。即使兩份資料使用相同地址與連接埠,也不要直接沿用其他協定的設定。

PROTOCOL

Trojan

Trojan 通常結合 TLS 與密碼驗證建立代理連線,憑證驗證是確認連線對象身分的重要環節。除了地址、連接埠與密碼,也應核對伺服器名稱及傳輸設定。遇到憑證錯誤時,先確認名稱、時間與設定來源,不應將略過驗證當作一般修復方式。

PROTOCOL

HTTP

HTTP 作為伺服器類型時,指的是 HTTP 代理,並非要在網址列輸入網頁連結。伺服器欄位通常填寫主機名稱或 IP,連接埠與驗證資訊則分別設定。代理連線是否使用 TLS,與目標網站是否使用 HTTPS 是兩回事,應依既有設定分別核對。

PROTOCOL

SOCKS5

SOCKS5 透過代理伺服器轉送連線,並可依伺服器設定使用使用者名稱與密碼驗證。協定名稱本身不代表連線已加密;支援 UDP 與否也需兩端及網路條件配合。填寫資料時應確認驗證要求,不能將空白密碼視為所有伺服器都適用的預設值。

PROTOCOL

Hysteria2

Hysteria2 以 QUIC 為基礎,透過 UDP 承載連線,因此網路是否支援 UDP 會影響交握與傳輸。檢查時先核對地址、驗證資訊與 TLS 參數,再確認網路條件。單憑某項 TCP 測試成功,無法證明此協定的連線路徑也正常。

PROTOCOL

WireGuard

WireGuard 使用公私鑰與對等端設定建立通道,不採用一般使用者名稱與密碼的填寫方式。介面地址、私鑰、對等端公鑰及相關路由參數都需一併核對。私鑰屬於敏感憑證,提交診斷資訊或分享設定時應移除,不要公開整份設定。

03 / RULE KEYWORDS

規則關鍵字

規則會在同一行中定義「比對什麼」及「符合後如何處理」。以下內容僅用來說明語法,並非可直接取代既有設定的完整設定檔。

RULE

Rule

Rule 是設定中用來決定流量去向的比對規則,通常依由上而下的順序判斷。較具體的條件應放在較廣泛的條件之前,兜底規則則放在末尾。新增規則後,請搭配實際請求記錄確認符合結果,不要只因語句看起來正確就結束驗證。

RULE

DOMAIN

DOMAIN 依完整網域名稱比對,適合只處理特定主機名稱。它不會自動將該網域的所有子網域納入同一條件。網域欄位不應包含網址協定、路徑或查詢參數,例如以下規則只適用於指定網域。

DOMAIN,example.com,PROXY
RULE

DOMAIN-SUFFIX

DOMAIN-SUFFIX 依網域後綴比對,可涵蓋指定網域及其子網域。它的涵蓋範圍比單一 DOMAIN 條件更廣,適合統一處理一組相關網域。修改前請確認子網域是否也需要相同策略,避免連例外請求一併符合。

DOMAIN-SUFFIX,example.com,PROXY
RULE

DOMAIN-KEYWORD

DOMAIN-KEYWORD 依網域中包含的關鍵字比對,不要求關鍵字位於固定的後綴位置。這可能涵蓋名稱相近但無關的網域,使用範圍應盡量精確。若能明確指定完整網域或後綴,通常更容易檢查比對範圍。

DOMAIN-KEYWORD,adservice,REJECT
RULE

IP-CIDR

IP-CIDR 依 IPv4 網段比對,斜線後的前綴長度決定地址範圍。範例網段僅用來說明區域網路地址的直連規則,不適用於所有網路。IPv6 地址應使用相應的 IP-CIDR6 規則,修改前請先確認目標地址類型。

IP-CIDR,192.168.0.0/16,DIRECT
RULE

GEOIP

GEOIP 依 IP 地理資料庫的分類結果比對目標地址,不會根據網頁語言或使用者所在地判斷。資料庫分類與實際服務部署可能不一致,因此不能用來證明網站身分。分流結果不如預期時,請對照實際解析地址與規則順序進行檢查。

RULE

FINAL

FINAL 用來處理未符合前述規則的流量,是設定中的兜底規則。它通常放在規則末尾,所選策略會影響所有未涵蓋條件的請求。若大量流量進入 FINAL,請先檢查前面的條件是否過於狹窄或有所遺漏,而非立刻更換伺服器。

FINAL,PROXY
POLICY

PROXY / DIRECT / REJECT

這三個大寫名稱是規則符合後的處理策略:PROXY 使用代理路徑,DIRECT 直連,REJECT 拒絕請求。它們不負責定義比對條件,也不同於 Global Routing 的介面模式。判讀規則時,應一併查看關鍵字、比對內容與末尾策略。

04 / SUBSCRIPTION & CONFIGURATION

訂閱與設定

伺服器項目儲存連線參數,設定檔整理處理規則,購買記錄則確認 App 的取得資格。三者應分開管理,不能互相取代。

INPUT

Add Server

Add Server 用來手動新增使用者已有的伺服器資訊,第一步是選擇與資料相符的協定類型。接著分別填寫地址、連接埠、驗證資訊與傳輸參數,並留意多餘空格及字元大小寫。儲存後還須測試連線;成功儲存只代表項目已寫入,不表示遠端驗證已通過。

INPUT

Subscribe

Subscribe 用來匯入並更新使用者已有的伺服器項目,訂閱連結需向你的服務提供者取得。更新項目不代表會自動選取其中某一項,也不表示所有項目都可用。連結可能包含身分憑證,請勿公開;更新失敗時,先保留原有可用資訊,再檢查原始連結。

CONFIG

.conf

.conf 是整理設定內容的檔案格式,可包含 General、Rule、Host 等區段。不同區段分別處理整體行為、規則與對應關係,並不等同於伺服器訂閱。匯入前先閱讀內容並保留原設定,匯入後再確認啟用狀態;完整架構請參閱系統教學。

CONFIG

URL Rewrite

URL Rewrite 依比對條件改寫或處理請求 URL,與決定連線路徑的 Rule 位於不同作用層級。排查目標地址變更時,也應檢查是否有相關改寫條件。它不是解決所有存取失敗的通用選項,不熟悉的規則應先確認用途,再決定是否啟用。

SYNC

iCloud 同步

iCloud 同步是在適用的設定與權限下,透過 iCloud 同步相關應用程式資料的機制,實際同步範圍請以 App 內選項為準。同步不等於恢復購買項目,也不會影響伺服器服務的有效性。移轉前先確認同步已完成,並另外保留重要設定,避免將單次同步當成完整備份。

APP STORE

已購項目

已購項目是 App Store 中查找已購買 App 的入口。更換裝置或重新安裝時,請先確認使用原購買帳號。恢復 App 不代表所有本機設定都會一併恢復,伺服器資訊仍須另外核對。系統需求與購買適用範圍請以 App Store 頁面標示為準,操作方式請參閱已購項目恢復說明。

05 / CONNECTION & DIAGNOSTICS

連線與診斷

將問題拆分為解析、連線、驗證、規則與實際存取等階段。某個步驟成功只能作為局部證據,不代表整條存取路徑都已完成驗證。

DIAGNOSTICS

DNS

DNS 會將網域名稱解析為 IP 地址,是建立許多連線前的步驟。網域解析成功但無法存取,問題可能出在後續連線或驗證階段;解析失敗也不能直接歸因於伺服器無法使用。修改 DNS 設定前先記錄原值,再搭配請求記錄檢查,避免同時變更規則與伺服器設定。

DIAGNOSTICS

Connectivity Test

Connectivity Test 用來檢查項目在指定測試方式與目標下是否連通,結果僅適用於當次測試條件。測試成功不代表所有目標服務都能存取;測試失敗也須配合協定與網路環境判斷。測試後仍應實際存取目標,並核對 Global Routing 與符合的策略。

DIAGNOSTICS

延遲

延遲是在特定測試方式下測得的回應時間,不是下載頻寬,也不能直接代表長時間連線的穩定性。不同測試目標、網路連線與測量時間都會造成差異,不宜直接混在一起排序。比較時請保持測試條件一致,並搭配實際請求是否成功判斷。

SYSTEM

VPN 設定授權

VPN 設定授權是系統允許 App 建立相應網路設定的步驟,首次連線時可能需要使用者確認並完成裝置驗證。授權後顯示連線狀態,不代表遠端伺服器一定可連線。若無法開始連線,先檢查系統授權;若已連線但存取異常,再排查伺服器、解析與規則。

CONNECTION

伺服器

伺服器項目會儲存遠端地址、協定及驗證參數,使用者也常將單一連線項目稱為節點。項目名稱只是方便辨識的標籤,無法證明實際地址、功能或狀態。排查時請依原始資料核對參數,並分別驗證連線、驗證資訊與目標存取情況,不要只看名稱或單次延遲結果。