主要頁面
Home
查看連線狀態、Global Routing、Connectivity Test 和 SERVER 清單的主要頁面。Not Connected 表示目前尚未建立連線，不能據此判定失敗原因。首次連線時，須依系統提示允許加入 VPN 設定，詳細步驟請見快速入門。
官方手冊 · 項目索引
Shadowrocket 術語手冊
介面名稱、協定參數與規則關鍵字，依用途分類查閱。
英文名稱對應應用程式介面或設定檔中的原文，中文說明其用途與適用範圍。請先確認目前調整的是整體模式、伺服器項目還是規則，避免混淆不同層級的設定。
介面與開關
連線入口與路由模式
先找到設定所在頁面，再確認它影響的是連線狀態還是流量處理方式。以下名稱以應用程式實際顯示為準。
整體路由設定
Global Routing
控制整體路由模式，可選擇設定、代理或直連，對應介面用語 Config、Proxy、Direct。這不是單一網站的規則，也不是伺服器協定類型。若分流結果不如預期，請先核對此處，再檢查目前使用的設定檔與規則順序。
三種路由模式
Config / Proxy / Direct
Config 依目前設定中的規則處理請求；Proxy 將適用流量交由所選代理處理；Direct 則採用直連模式。系統略過設定與其他網路設定仍可能影響實際路徑，因此模式不代表所有系統流量都一定遵循此路徑。詳細差異請見代理模式說明。
自動觸發連線
On Demand
依網路類型、Wi-Fi 或網域等條件控制 VPN 連線。這項設定決定何時連線，無法取代 Rule 來決定每個請求如何分流。若手動關閉後又重新連線，請檢查已啟用的觸發條件，以及目前網路是否符合條件。
新增伺服器項目
Add Server
依據自己已有的伺服器資訊手動新增連線項目。請先選擇正確的協定，再逐一核對位址、連接埠、驗證資訊與傳輸參數；欄位填滿不代表參數正確。若已有訂閱，可依匯入流程操作，不必將訂閱網址填入伺服器位址欄位。
診斷工具
Connectivity Test
依目前選用的測試方式檢查伺服器項目的連通性，不同方式涉及的網路環節可能不同。顯示測試結果只代表該項測試通過，無法保證 DNS、規則及每個目標網站都正常。若「測試正常但網頁無法開啟」，請繼續檢查解析結果與實際存取路徑。
代理協定
連線格式與參數範圍
協定名稱代表通訊方式，不代表線路品質。填寫參數時請以自己已有的伺服器資訊為準，不能只憑協定名稱推斷完整設定。
代理協定
Shadowsocks
使用約定的加密方式與憑證建立代理通訊的協定。用戶端的位址、連接埠、密碼和加密方式必須與伺服器端一致；若設定還包含額外傳輸參數，也須完整保留。更換加密方式不是通用的修復方法，隨意修改會造成兩端設定不符。
代理協定
VMess
需要驗證資訊，並可搭配不同傳輸設定使用的代理協定。除了位址與連接埠，也要核對 UUID、傳輸方式，以及啟用安全傳輸時所需的相關欄位。驗證過程可能受裝置時間影響，排查時可檢查系統日期與時間，但不能只因逾時就認定是時間問題。
代理協定
VLESS
將身分驗證與傳輸安全分開處理的代理協定；協定名稱本身不代表已啟用加密傳輸。使用時須一併檢查 UUID、傳輸方式及安全設定等欄位。不能只把協定名稱換成 VMess 就直接沿用設定，應依既有資訊重新核對各項參數。
代理協定
Trojan
通常搭配 TLS 與密碼驗證使用的代理協定。連線位址、驗證密碼及 TLS 驗證用的主機名稱各有用途，填寫時不可互相取代。若出現憑證或交握錯誤，請先核對主機名稱、憑證有效性及系統時間，不要關閉驗證來掩蓋設定錯誤。
代理協定
Hysteria2
以 QUIC 為基礎的代理協定，底層依賴 UDP 通訊。排查連線失敗時，除了位址、連接埠與驗證資訊，也應確認目前網路允許相應的 UDP 通訊，並核對 TLS 參數。選用此協定不保證傳輸速度，實際表現仍受網路路徑、壅塞及伺服器資源影響。
通道協定
WireGuard
以公開金鑰識別通訊對端的通道協定，設定會用到本機私密金鑰、對端公開金鑰、位址與端點等資訊。金鑰不是一般顯示名稱，私密金鑰也不應出現在排查截圖或公開記錄中。通道連線與網域解析是不同環節，建立通訊後仍須檢查 DNS 與路由設定。
代理協定
HTTP / SOCKS5
兩種不同的代理協定，不能因共用位址與連接埠欄位就認為可以互換。是否需要驗證、是否支援特定流量，以及傳輸是否受到加密保護，應以實際協定和伺服器端設定為準。HTTP 或 SOCKS5 代理的名稱本身不代表傳輸已加密。
規則關鍵字
比對條件與執行策略
閱讀規則時，先看比對對象，再看符合後的處理方式。規則通常依序由上而下判斷，較具體的條件應排在較廣泛的條件之前。
規則區段
Rule
設定檔中的 [Rule] 區段用來定義分流項目，常見結構包含規則類型、比對內容與策略。通常由第一條符合的規則決定處理方式，因此前面的廣泛規則可能會遮蔽後方的精確規則。修改後還須確認 Global Routing 設為 Config，且目前使用的是相應檔案。
精確網域比對
DOMAIN
比對指定的完整網域名稱，適用於只處理某個明確主機名稱的情境。例如 DOMAIN,example.com,DIRECT 不會自動涵蓋該網域下的所有子網域。比對內容只填網域名稱，不要連同完整網頁網址中的通訊協定、路徑和查詢參數一起填入。
網域後綴比對
DOMAIN-SUFFIX
比對指定網域及其子網域，例如 DOMAIN-SUFFIX,example.com,PROXY 可涵蓋 example.com 及其子網域。其範圍比 DOMAIN 廣，但並非比對任意文字子字串。若同一網域下有例外，請將較精確的規則排在這條之前。
網域關鍵字比對
DOMAIN-KEYWORD
檢查網域是否包含指定關鍵字，涵蓋範圍可能涉及多個互不相關的網域。它比對的是網域，不是網頁正文，也不是任意 URL 路徑。若只想涵蓋某個網站及其子網域，通常可優先考慮 DOMAIN-SUFFIX，以減少意外比對。
IP 歸屬比對
GEOIP
依目標 IP 在地理資料庫中的歸屬進行比對，不會根據頁面使用的語種或網域文字判斷。資料庫記錄、網域解析結果與內容傳遞網路都可能影響比對結果。這不等於目標服務的註冊地，也不能保證同一網站的所有請求都符合相同歸屬。
位址範圍比對
IP-CIDR / IP-CIDR6
分別使用 CIDR 表示法比對 IPv4 與 IPv6 位址範圍，例如 IP-CIDR,192.0.2.0/24,DIRECT。斜線後的前綴長度決定位址網段範圍，不是連接埠號碼。此範例位址僅供文件說明；實際規則應依需要比對的目標位址撰寫，並留意兩種位址族的差異。
後備規則
FINAL
處理前面所有規則都未符合的請求，通常放在規則清單末尾。FINAL,DIRECT 表示未符合其他規則時採用直連，而不是要求所有請求都直連。若將 FINAL 移到前面，後續規則可能失去比對機會，請先檢查順序，再檢查個別條件。
規則執行策略
PROXY / DIRECT / REJECT
PROXY 表示交由代理策略處理，DIRECT 表示直接連線至目標，REJECT 表示拒絕請求。這些大寫關鍵字是規則的處理結果，不是 Global Routing 三種模式的簡單替代名稱。符合 PROXY 後，仍須有可用的相應代理項目，才能完成後續連線。
訂閱與設定檔
項目來源與檔案結構
伺服器項目決定連線至何處，設定檔則決定如何處理請求。更新訂閱與切換設定檔是不同操作，不能互相取代。
匯入既有資訊
Subscribe
透過自己已有的訂閱網址取得或更新伺服器項目，詳細匯入步驟請見訂閱與伺服器匯入。訂閱內容可能在更新後變更，更新成功也不代表所有項目都能連線。網址可能含有存取憑證，排查時請勿公開完整連結；訂閱通常也不等於完整的分流設定檔。
伺服器清單區塊
SERVER
Home 中用來列出伺服器項目的區塊，每個項目都會保存相應協定、位址、連接埠及驗證等連線參數。項目名稱僅供辨識，無法用來判斷協定、實際位置或可用性。手動新增的項目與訂閱產生的項目，管理方式可能不同；更新前請先確認修改內容是否會被覆寫。
設定頁面與檔案
Config / .conf
Config 可指管理設定檔的頁面，.conf 則是常見的設定檔副檔名。檔案可包含 General、Rule、Host、URL Rewrite 等區段，實際效果取決於欄位內容與目前啟用狀態。儲存檔案不代表已切換並生效，請核對目前選取的設定檔及 Global Routing。
一般設定區段
General
[General] 用於宣告基本網路行為與通用參數，例如 DNS 設定。它與逐條比對請求的 Rule 區段用途不同，參數是否適用也須依目前設定與網路環境判斷。修改前請保留原值，一次只調整與問題相關的項目，方便比較結果及還原設定。
URL 處理區段
URL Rewrite
[URL Rewrite] 依運算式比對 URL，並執行相應的重寫或重新導向等操作，不能取代代理路由規則。比對範圍過廣可能改變無關請求，編輯前應先了解運算式與目標網址。HTTPS 請求可見的資訊及可處理範圍取決於連線條件，不要假設所有請求內容都能直接修改。
DNS 與網路
解析、回應與傳輸安全
網域解析、建立連線與實際傳輸內容是不同環節。解讀測試結果時應一併考量測試方式，不宜只用單一數值判斷整體網路狀態。
網域解析機制
DNS
將網域名稱解析為 IP 位址等記錄的機制，通常是存取網域前的重要環節。代理伺服器可以連線，不代表目標網域一定能正確解析。若網頁無法開啟但 Connectivity Test 有回應，請區分解析失敗、解析結果不適用、規則路徑錯誤與目標服務異常。
General 設定項目
dns-server
用於在 General 中指定 DNS 解析伺服器的設定項目，dns-server = system 表示採用系統的解析伺服器設定。實際解析路徑還會受其他 DNS 設定及網路環境影響。修改前請記下原值，修改後以同一網域重新測試，避免同時更動多個無關參數。
靜態主機對應
Host
[Host] 可為指定主機名稱設定靜態位址對應，例如 localhost = 127.0.0.1。靜態對應不會自動隨遠端服務的位址變更，錯誤或過期的記錄可能導致持續無法存取。它與傳輸設定中的 Host 欄位不屬於同一層級，不能只憑相同字詞判斷用途。
測試結果代表什麼
Latency
指特定測試方式下的回應耗時，不等於頻寬、下載速度或持續傳輸的穩定性。不同測試目標、網路類型與測試方法的結果不宜直接比較。排查時應維持測試條件一致，再搭配實際網頁存取與連線記錄判斷；單次逾時也無法單獨定位故障。
傳輸安全與主機名稱
TLS / SNI
TLS 用於保護傳輸並驗證通訊身分；SNI 則在交握時指出預期存取的主機名稱，讓伺服器選擇相應設定與憑證。連線位址可以與驗證用名稱不同，但必須符合既有伺服器的實際設定。交握失敗時請先核對名稱、憑證與時間，不要將略過驗證當作常規解法。