官方手冊 · 依名稱查閱

Shadowrocket 術語表

介面用語、協定名稱與規則關鍵字保留英文原文。先辨認術語所屬層級，再判斷應調整連線模式、伺服器參數或設定檔。

查閱操作步驟，請參考快速入門；需要完整規則片段，請前往設定欄位。取得 Shadowrocket 前，請先閱讀App Store 下載指南。

Interface / Switches

介面與切換選項

這些名稱描述操作入口或連線模式，不是伺服器協定，也不直接代表任何一條 Rule。

Global Routing: 這是用來選擇整體連線方式的設定，常見模式有三種：設定 Config、代理 Proxy、直連 Direct。需要依規則分流時，先確認是否選取 Config，再檢查目前使用的設定檔。若只編輯 Rule，卻維持 Proxy，通常無法達到預期的逐條規則分流效果。排查時先記下原本的模式，每次只變更一個選項，以免把模式差異誤判為伺服器故障。

Config: Config 既是設定檔管理入口，也會出現在 Global Routing 的模式選項中，實際含義取決於所在位置。作為管理入口時，可用來檢視、編輯與選取設定檔；作為連線模式時，表示依目前設定檔處理請求。匯入檔案不代表已設為目前使用的設定檔，操作後須再次確認選取狀態。

Proxy: Proxy 是 Global Routing 中的代理模式，主要透過目前選取的代理處理請求，仍須留意系統流量與略過設定。它不是 Shadowsocks、VLESS 等協定的統稱，也不代表伺服器一定可用。排查規則影響時，可暫時切換至此模式進行測試，完成後請還原原本設定。

Direct: Direct 是 Global Routing 中的直連模式，主要透過目前網路直接存取目標。可用來比對同一目標在目前網路中的存取狀況，但直連成功不代表代理伺服器參數正確。介面中的 Direct 與規則文字中的 DIRECT 屬於不同層級，修改其中一項不會自動改寫另一項。

On Demand: On Demand 會依預設的網路條件請求系統建立 VPN 連線，例如針對不同網路環境套用連線條件。它處理的是何時連線，不是某個網域應採用 PROXY 還是 DIRECT。啟用後也須核對系統 VPN 設定與觸發條件；手動關閉後的狀況同樣應依目前條件判斷。

Connectivity Test: 這是用來檢查伺服器連線狀況的測試入口，結果會因測試方式、目標位址與目前網路而異。顯示的延遲代表特定測試所花的時間，不等同於下載速度，也不保證所有目標都能存取。比較結果時請使用相同的測試方式；測試失敗後，仍須分別檢查位址、連接埠、驗證資料與實際請求。

Protocols

協定

協定決定連線如何建立。填寫 Add Server 時，請以既有伺服器資料為準，不要只憑名稱推測驗證、傳輸或憑證參數。

Shadowsocks: Shadowsocks 使用指定的加密方式與認證資料連線至伺服器，位址、連接埠、密碼與加密方式須相互吻合。匯入後若無法連線，請逐項核對這些欄位，而不只是檢查密碼。若既有資料包含額外傳輸參數，也須依伺服器的實際設定填寫，不要自行換成看似相近的選項。

VMess: VMess 使用使用者識別碼等參數進行驗證，常見設定資料也會指定傳輸方式與安全選項。UUID 正確不代表設定完整，Host、路徑或 TLS 設定不一致也可能造成連線失敗。匯入分享連結後，請對照原始資料檢查欄位，尤其不要把網頁 URL 的路徑直接當成傳輸路徑。

VLESS: VLESS 使用使用者識別碼進行驗證，協定本身不負責加密負載資料；連線安全取決於搭配的傳輸方式與安全設定。須一併核對伺服器資料中的傳輸類型、TLS 相關欄位與其他選項，不能只填入 UUID。若有欄位缺漏，應依既有資料補齊，不宜憑協定名稱猜測預設組合。

Trojan: Trojan 通常搭配 TLS 與密碼驗證建立連線，伺服器位址與憑證對應的名稱可能需要分別填寫。連線失敗時，請檢查密碼、連接埠、伺服器名稱與裝置時間；憑證驗證問題不能直接視為密碼錯誤。應優先修正名稱或憑證設定，不要把關閉驗證當成一般設定步驟。

Hysteria2: Hysteria2 以 QUIC 為基礎，通常透過 UDP 傳輸連線；驗證方式與相關參數應以既有伺服器資料為準。協定名稱中的數字是名稱的一部分，不代表本頁所述的 Shadowrocket App 版本。UDP 是否受到目前網路限制會影響連線狀況，因此 TCP 測試成功不代表此連線也能正常建立。

WireGuard: WireGuard 透過公鑰識別通訊對端，設定通常包括本機私鑰、對端公鑰、Endpoint、位址與 Allowed IPs。其欄位不能當成一般的位址加密碼伺服器項目來理解，金鑰也不應出現在公開截圖或排查紀錄中。Allowed IPs 涉及該通道設定的流量範圍，不能只憑此推斷 Shadowrocket 中其他規則的執行結果。

SOCKS5: SOCKS5 是代理請求協定，可轉送 TCP 連線，並在用戶端與伺服器雙方支援時處理 UDP。名稱本身不代表傳輸已加密，是否需要使用者名稱與密碼則由伺服器設定決定。檢查項目時，請分別確認驗證要求與 UDP 支援情況，不要直接套用 HTTP 代理欄位。

Rule / Policy

規則關鍵字與策略

Rule 會依序檢查條件，符合條件後採用指定策略。條件回答「比對什麼」，策略回答「如何處理」。

[Rule]
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,DIRECT

此處的 example.com 僅用於說明語法。請將具體條件放在前面，並將 FINAL 放在末尾；範例中的 PROXY 仍須對應使用者既有且可用的伺服器。

DOMAIN: DOMAIN 會比對完整網域名稱，例如 DOMAIN,example.com,DIRECT 僅適用於 example.com 本身。它不會自動涵蓋 www.example.com 等所有子網域，也不會比對網頁路徑。若要涵蓋子網域，請使用 DOMAIN-SUFFIX，不要任意在完整網域後加上萬用字元。

DOMAIN-SUFFIX: DOMAIN-SUFFIX 會比對指定網域及其子網域，例如 example.com 與 www.example.com。條件中只填寫網域名稱，不包含 https://、連接埠或網頁路徑。若要讓特定子網域採用不同策略，請將較明確的 DOMAIN 規則放在此後綴規則之前。

DOMAIN-KEYWORD: DOMAIN-KEYWORD 會依網域名稱中出現的字串進行比對，例如關鍵字 example 可能符合多個不同網域。其範圍通常比指定後綴更廣，容易涵蓋名稱相近但用途不同的目標。撰寫前請先確認所需涵蓋範圍；若能明確描述目標，應優先使用更精確的條件。

GEOIP: GEOIP 會依 IP 地理位置資料庫比對目標位址，例如 GEOIP,CN,DIRECT。結果描述的是目標 IP 在資料庫中的歸屬，不是訪問者的位置，也不能直接代表網站的營運主體。網域解析結果與資料庫內容都會影響判斷，因此不適合用來取代所有精確的網域規則。

IP-CIDR: IP-CIDR 會依 IPv4 位址範圍進行比對，例如 192.168.0.0/16 代表一個網路範圍，斜線後的數字是前綴長度，不是連接埠。IPv6 位址範圍使用 IP-CIDR6，不應直接套用 IPv4 範例。若要在網域請求中比對目標位址，也須考量解析流程與規則選項的影響。

FINAL: FINAL 為未符合前面規則的請求指定最終策略，通常放在 Rule 區段末尾。它不需要網域或位址條件，例如 FINAL,DIRECT。若提早放置，後面的規則通常無法再處理未符合條件的請求；排查規則順序時，請先確認這一行的位置。

PROXY: PROXY 是規則文字中的代理策略，表示符合條件的請求會透過代理處理；實際使用的伺服器取決於目前選擇與設定。它不是協定類型，也不包含位址、連接埠或驗證資料。請保留大寫寫法，並與 Global Routing 介面中的 Proxy 區分：前者是單條規則的結果，後者是整體連線模式。

DIRECT: DIRECT 是規則文字中的直連策略，表示符合條件的請求會直接連線至目標。連線仍會受到目前網路、DNS 與目標服務狀態影響，不代表請求一定成功。區域網路位址範圍常使用此策略，但應依實際網路範圍填寫條件，避免將過大的位址範圍設為直連。

REJECT: REJECT 是拒絕策略，符合條件的請求不會繼續建立一般的目標連線。它不是 Proxy 的替代伺服器，也不是自動修復網路故障的選項。若網頁有部分資源無法載入，請檢查相關網域是否符合拒絕規則，再判斷條件是否過於寬泛或順序是否不恰當。

Subscription / Configuration

訂閱與設定檔

伺服器清單解決「連線到哪裡」，設定檔則整理「如何處理請求」。匯入其中一類資料，不代表另一類也已準備就緒。

SERVER: 伺服器項目記錄建立連線所需的資料，包括位址、連接埠、協定與驗證參數，實際欄位會依協定而異。伺服器可用是建立連線的前提，顯示名稱則只是方便辨識的標籤。單一分享連結與訂閱都可能建立伺服器項目，但更新方式不同；手動編輯後也須留意訂閱更新是否會覆寫變更。

設定檔: 設定檔是整理 General、Rule、Host 與 URL Rewrite 等設定的文字檔，各區段用途不同。它不等同於伺服器訂閱，檔案中出現 PROXY 也不代表已包含可用的伺服器資料。編輯前請保留可還原的副本，儲存後在 Config 確認目前使用的檔案，並檢查 Global Routing 是否採用 Config。

General: General 是設定檔中的一般設定區段，常見欄位包括 DNS 與略過行為，例如 dns-server = system。欄位值須依各自語法填寫，不能套用 Rule 的逗號分隔格式。每次修改一項後，先確認影響再調整其他欄位，方便找出問題並還原。

Host: Host 區段用來設定特定主機名稱與位址的對應，例如 localhost = 127.0.0.1。它處理的是名稱與位址的關係，不是指定 PROXY 或 DIRECT 的規則。固定對應可能在目標位址變更後失效，因此若某個網域持續無法正常存取，也應檢查是否存在舊的對應設定。

URL Rewrite: URL Rewrite 依指定模式處理請求 URL，作用不同於 Rule 對連線策略的選擇。規則通常須同時說明比對模式、目標與處理方式；正規表示式中的句點等字元也須正確跳脫。HTTPS 請求的可見範圍會受加密與相關設定限制，不能只憑一條 Rewrite 就假定所有位址都能處理。

System / Account

系統與帳號

請區分 App 購買、系統授權與網路資料。重新取得 App 不等同於還原伺服器；系統顯示已連線，也不代表目標存取已通過驗證。

DNS: DNS 會將網域名稱解析為 IP 位址，解析失敗可能導致網頁無法開啟或特定目標存取異常。DNS 與代理伺服器驗證屬於不同環節，調整解析設定無法修正錯誤密碼或失效的伺服器。排查時先記錄目前的 DNS 設定，再配合連線模式與網域規則，判斷解析請求實際採用的路徑。

VPN 設定: 首次開啟連線開關時，系統可能會詢問是否允許加入 VPN 設定，用來儲存與管理 Shadowrocket 的網路連線。此系統項目不等同於伺服器資料，也不代表已有可用線路。若項目遭刪除，請再次從 App 發起連線並完成系統授權，再另外確認伺服器與目標是否可存取。

Apple ID: Apple ID 用於 App Store 購買與辨識已購項目，目前的商店地區會影響 App 是否顯示及所列幣別。購買前請確認 App Store 目前使用的帳號，不要只根據裝置的 iCloud 登入狀態判斷。Shadowrocket 僅能透過 App Store 取得，系統需求與裝置相容性請以 App Store 頁面標示為準。

已購項目: 已購項目是 App Store 中查閱購買紀錄並重新取得 App 的入口，名稱與所在位置可能隨系統介面而異。更換裝置或重新安裝時，請使用原購買帳號核對紀錄；重新取得 App 不會自動還原 App 內的訂閱與設定檔。確認正版時，也請核對開發者 Shadow Launch Technology Limited、官方圖示與 App ID 932747118。

iCloud 同步: iCloud 同步會透過雲端在裝置間儲存或傳送 App 資料，實際同步範圍以 Shadowrocket 內顯示的選項為準。它與 App Store 購買紀錄是兩套不同機制，啟用同步也不代表每項資料都已完成備份。更換裝置前，請確認同步狀態與必要資料是否可還原，並妥善保管訂閱網址及驗證參數。

繼續查閱規則與設定參考 →

返回術語分類 ↑