Shadowrocket術語手冊
依介面名稱、協定與規則語法查詢詞彙。英文保留 App 中的原始寫法，中文說明用途與適用範圍；操作步驟請搭配教學閱讀，遇到連線問題則查看排查手冊。
INTERFACE & SWITCHES
介面與開關
先確認設定所在的位置。相似的英文詞彙，可能分別代表頁面、運作模式或規則的處理結果。
- Home
- 用來查看伺服器項目與訂閱群組、選取連線對象及操作連線開關的介面。匯入後，先確認項目確實出現在此處，再核對目前選取的項目；匯入成功只代表參數已儲存，不代表伺服器已可連線。開啟連線開關後，還須透過實際請求確認網路是否如預期運作。
- Global Routing
- 控制整體流量處理模式的設定，可選擇 Config、Proxy 或 Direct。排查規則未生效時，應先確認此處的設定，而非立刻重寫規則；模式不同，同一份設定可能產生不同的請求路徑。此設定與連線開關是兩個不同面向，選好模式不代表已建立連線。
- Config / Proxy / Direct
- 三種模式分別代表依設定處理、整體使用代理連線，以及整體直接連線；介面名稱維持為 Config、Proxy、Direct。需要依規則分流時使用 Config；暫時切換至 Proxy 或 Direct 有助於比較連線路徑，但測試後應恢復原本的選項。這些首字母大寫的介面用語，不要與規則中的全大寫策略關鍵字混淆。
- On Demand
- 依設定條件觸發 VPN 連線行為的選項，用來控制何時建立或恢復連線。它處理的是連線觸發條件，不負責判斷特定網域應套用哪條規則。若手動關閉後連線又恢復，請檢查 On Demand 的條件，而非一再操作連線開關。
- Add Server
- 依既有伺服器資訊建立連線項目的入口；先選擇與伺服器一致的協定，再填寫相應欄位。位址、連接埠與驗證資訊是不同參數，不能只憑顯示名稱判斷填寫是否正確。傳輸方式、TLS 與其他選填欄位，也應依據使用者既有的伺服器說明核對，不宜任意嘗試不同組合。
- Connectivity Test
- 用來檢查項目在目前網路與所選測試方式下的連線能力。結果只反映此次測試涵蓋的路徑，不能證明所有網站或傳輸方式都正常。測試成功但實際請求失敗時，還需檢查 Global Routing、DNS 與目標規則；測試逾時也不能直接斷定驗證資訊有誤。
PROTOCOLS
協定
協定規定用戶端與伺服器如何通訊。協定名稱相同不代表參數也相同，新增時應逐項核對使用者既有資訊。
- Shadowsocks
- 用來在用戶端與伺服器之間傳輸代理流量的協定，連線所需的伺服器位址、連接埠、加密方式與密碼都必須相符。加密方式是協定參數，不能只因名稱相近就互換。若既有資訊包含額外傳輸設定，也需一併核對；修改顯示名稱無法修正參數不一致的問題。
- VMess
- 具有身分驗證機制的代理協定，常見連線資訊包括使用者識別資訊、傳輸方式與安全設定。伺服器位址可連線，只能證明部分網路路徑正常；驗證或傳輸參數不一致仍可能導致連線失敗。裝置時間明顯不準也可能影響驗證，請先確認系統時間正確，再排查其他欄位。
- VLESS
- 一種輕量代理協定，傳輸保護方式取決於實際設定的安全層，不能只憑協定名稱判斷連線的保護方式。使用者識別資訊、傳輸方式及相關安全參數都必須與伺服器一致。若匯入項目後仍無法連線，應回到原始伺服器說明核對欄位，而非直接改成另一種協定。
- Trojan
- 通常搭配 TLS 使用的代理協定，驗證資訊與憑證相關設定都會影響連線是否成功。伺服器位址、TLS 使用的名稱，以及憑證涵蓋的網域可能各有不同用途，應分別核對。遇到憑證錯誤時，先檢查名稱、裝置時間與伺服器憑證；不應將關閉驗證當成一般修復方式。
- Hysteria2
- 以 QUIC 為基礎的代理協定，底層通訊依賴 UDP，因此網路是否允許相應的 UDP 流量相當重要。實際表現也會受到不同連線路徑上的壅塞、封包遺失、伺服器資源與參數設定影響，不能只憑協定名稱判斷速度。若一般網頁可以開啟，但此項目持續逾時，應將底層 UDP 是否可連線納入檢查。
- WireGuard
- 以金鑰建立加密通道的 VPN 協定，設定通常包括本機位址、對端公鑰、端點與允許的位址範圍。通道建立不代表所有目標都自動具備正確路由，還需檢查路由範圍與 DNS。私鑰屬於敏感資訊，分享排查資料時應遮蔽私鑰及其他可用於驗證的內容。
RULE KEYWORDS
規則關鍵字
規則通常依序檢查，第一條符合的規則會決定處理結果。關鍵字描述比對條件，行末的策略則說明符合後如何處理。
- DOMAIN
- 依完整網域名稱精確比對，適合指定單一主機名稱的情況。例如
DOMAIN,example.com,DIRECT只適用於 example.com，不會自動涵蓋其所有子網域。若目標還有獨立的 API 或靜態資源網域，也需分別考量；不能因主頁比對成功，就認定整個頁面的請求路徑都相同。
- DOMAIN-SUFFIX
- 依網域後綴比對，可涵蓋指定網域及其子網域。例如
DOMAIN-SUFFIX,example.com,PROXY可用於 example.com 及其子網域，但不會比對任意包含 example.com 字串的主機名稱。新增涵蓋範圍較大的後綴規則前，應先確認前面是否已有更精確的例外規則。
- DOMAIN-KEYWORD
- 比對網域中包含的指定字串，範圍通常比完整網域或後綴比對更廣。這類規則可能同時符合多個互不相關的網域，因此不宜直接將短字串當成精確條件。若發現流量意外分流，應檢查是否有範圍過廣的關鍵字規則，以及它是否排在更精確的規則之前。
- GEOIP
- 依據 IP 地理資料庫中的歸屬資訊比對目標位址，結果會受資料庫內容與解析所得 IP 影響。這不是裝置的即時定位，也不能保證準確反映伺服器的實際位置。使用分散式服務時，解析出的位址可能隨網路變動，因此不能只憑網域印象判斷 GEOIP 規則是否應該符合。
- IP-CIDR / IP-CIDR6
- 分別依 IPv4 與 IPv6 網段比對，斜線後的前綴長度決定涵蓋範圍。例如
IP-CIDR,192.168.0.0/16,DIRECT描述一段 IPv4 私有位址範圍，並非只比對單一位址。撰寫網段規則時也要考量 IPv6 路徑，避免只檢查 IPv4 就以為所有請求都已涵蓋。
- FINAL
- 前面的規則都未符合時使用的預設規則，通常放在規則清單末尾。
FINAL,DIRECT代表其餘請求直接連線，FINAL,PROXY則代表其餘請求使用代理連線。修改此規則會影響大量未被具體規則涵蓋的請求，因此應先了解現有規則，再調整預設策略。
- PROXY / DIRECT / REJECT
- 常見的規則策略關鍵字，分別代表使用代理連線、直接連線及拒絕請求。規則末尾的 PROXY 不代表某台固定伺服器的名稱，實際使用的連線對象仍取決於目前的選擇與設定。DIRECT 也不代表用戶端完全停止處理；它描述的是該請求的連線路徑，DNS 等行為仍須配合設定判斷。
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,DIRECT若範例中的目標請求先符合其他規則，後續相同類型的規則就不會再決定該請求的策略。完整排查流程請見規則分流與連線排查。
SUBSCRIPTION & CONFIGURATION
訂閱與設定
訂閱用來管理連線項目，設定則用來管理處理方式。匯入、更新、選用與連線是不同操作，應分別確認結果。
- Subscribe
- 用來匯入及更新一組伺服器項目的訂閱類型，連結來自使用者既有的服務提供者。連結可能含有用於識別帳戶的敏感參數，應妥善保管，不要完整放入截圖或公開的排查紀錄。訂閱成功匯入，只代表用戶端已取得並辨識內容；之後仍需選取項目、進行測試並確認實際連線。
- 伺服器項目
- 儲存在用戶端的一組連線參數，通常包括伺服器位址、連接埠、協定與驗證資訊，也可能包含傳輸與 TLS 設定。項目顯示名稱只是方便辨識的標籤，不代表伺服器位置、速度或可用狀態。修改由訂閱產生的項目前，應先保留紀錄，因為後續訂閱更新可能會取代相關參數。
- Config
- 作為介面名稱時，指用來管理規則與相關網路設定的設定檔；作為 Global Routing 選項時，則表示依目前設定處理請求。設定檔與伺服器訂閱用途不同，更新其中一項不代表另一項也已更新。檔案匯入後不等於已選用，排查時應確認目前實際使用的是哪一份。
- 訂閱更新
- 重新向訂閱連結提出請求，並依回傳內容更新對應項目的操作；這與透過 App Store 更新 Shadowrocket 是兩回事。更新失敗可能發生於連結存取、伺服器回應或內容辨識階段，應依階段逐一排查，而非直接刪除現有群組。更新後需再次確認目前選取的項目，尤其要留意原項目是否已移除或參數是否有所變更。
DNS & NETWORK
DNS 與網路
分開檢查網域解析、伺服器連線與目標存取。某個環節成功，不代表其他環節也正常。
- DNS
- 將網域名稱解析為 IP 位址等記錄的系統，是許多網路請求建立連線前的步驟。解析失敗時，請求可能尚未進入連線目標的階段；解析成功後，仍可能遇到連接埠無法連線、驗證失敗或目標服務錯誤。排查時應區分「沒有解析結果」與「已有結果但無法連線」，兩者需要檢查的設定不同。
- 系統 DNS／自訂 DNS
- 系統 DNS 通常來自目前網路提供的解析設定；自訂 DNS 則是使用者明確指定的解析器。實際採用哪條解析路徑，也可能受到設定檔、網域規則與網路環境影響，不能只看填入哪個位址。更換解析器後，應以相同目標重新測試，並考量快取是否仍沿用先前的結果。
- DNS over HTTPS
- 透過 HTTPS 傳送 DNS 查詢的方式，常縮寫為 DoH。它改變的是解析請求的傳輸方式，而非代理協定。解析端點本身也必須能夠連線，端點網域的解析與連線路徑同樣需要正確。改用 DNS over HTTPS 不會自動修復伺服器驗證、規則選擇或目標網站故障。
- 延遲／逾時
- 延遲表示特定測試等待回應的時間，實際意義取決於測試方式；逾時則表示在限定時間內未取得預期回應。延遲較低不代表持續傳輸速度較快，也不能證明所有目標都能存取。比較結果時應保持測試方式、網路與目標一致，否則數值通常無法直接比較。
- TCP / UDP
- 兩種常見的傳輸層協定：TCP 提供有序且可靠的位元組串流，UDP 傳送資料報，其可靠性機制可由上層協定實作。某項 TCP 測試成功，不代表同一網路中的 UDP 通訊也可用；使用 QUIC 等傳輸方式時，更要區分兩者。排查時應先確認目前協定依賴哪種底層通訊，再決定測試對象。