官方手冊 · 技術參考

Shadowrocket 協定詳解

protocol-reference

依現有伺服器選擇協定類型,再確認傳輸、驗證與加密參數。協定名稱不代表速度排名。

本頁供系統性查閱,著重說明協定的設計原因,以及設定不一致時可能發生的情況。首次新增現有訂閱、啟用連線與檢查結果,請先閱讀使用說明;熟悉基本操作後,再回到本頁核對欄位並處理特殊情況。

Shadowsocks VMess / VLESS Trojan HTTP / SOCKS5 WireGuard Hysteria2

以下內容均以使用者已有自己的訂閱或伺服器資訊為前提。Shadowrocket 提供全平台用戶端;本文的操作說明主要以 iPhone / iPad 為例,實際選項請以裝置介面與伺服器端設定為準。

先區分協定、傳輸與分流

layers

一次連線牽涉多項獨立決定

在 Shadowrocket 中選擇伺服器協定類型,只是決定用戶端與伺服器端採用哪一種通訊約定。應用程式發出的原始連線、用戶端封裝後的連線,以及伺服器端連往目標網站的連線,彼此相關,但並非同一段路徑。開啟網頁時的網域解析、建立連線、驗證與資料傳輸,也無法用單一協定名稱概括。理解這些層次,才能判斷該調整哪項設定,而不是連線失敗後不斷更換類型。

可以先將設定分成四層:協定規範驗證與資料封裝;傳輸決定封裝後的資料如何在兩端之間傳送;TLS 負責相關連線的加密與身分驗證;規則則決定特定目標連線是否使用這台伺服器。並非每種協定都會提供這四層的選項。例如 WireGuard 內建專屬的加密與交握機制,不應直接套用以 TLS 為基礎的伺服器欄位;VLESS 則須特別留意外層採用的安全機制。管理面板沒有同名欄位,不代表缺少必要的安全功能。

速度、耗電與協定之間沒有固定對照

協定的設計背景通常對應不同需求:精簡的應用程式代理、彈性的驗證與傳輸組合、通用代理協商、網路層通道,或適用於高延遲與封包遺失鏈路的資料傳輸。這些目標不能互相取代。低開銷協定在壅塞的線路上仍可能很慢;結構較複雜的協定,在伺服器位置較近、網路較穩定時,反而可能反應更快。因此,比較時必須固定伺服器位置、本地網路、目標資源與觀察時段,否則測得的結果多半反映的是線路差異。

在 iOS 上,耗電不只來自加解密運算,也包括無線模組持續運作、交握重試、背景保活、網域查詢與頻繁重新建立連線。短時間內大量連線失敗,可能比一條持續傳輸的連線更耗電。系統顯示 VPN 狀態,只代表通道介面正在運作,不能證明遠端伺服器已通過驗證,也不能證明所有流量都經過代理。應搭配目標請求、連線記錄及實際命中的規則觀察,別把圖示當成完整的連線狀態報告。

層次需要確認的問題常見檢查項目
協定兩端如何驗證並封裝資料Type、密碼、UUID、金鑰
傳輸協定資料透過什麼方式傳送TCP、UDP、WebSocket、路徑
安全如何加密並驗證對端身分TLS、Server Name、憑證
分流哪些目標使用這台伺服器Global Routing、規則順序

先確認伺服器端支援,再考慮選擇

在 Add Server(新增伺服器)中切換 Type(類型),不會讓既有伺服器自動改用另一種協定。協定類型、連接埠與憑證必須組成伺服器端實際支援的設定。即使位址相同,不同連接埠也可能連到完全不同的服務。匯入訂閱後若出現陌生類型,應先查閱既有服務的參數說明,不要只憑名稱相似就猜測選項。手動修改前請先保存原始設定並記下修改原因,方便還原至可驗證的狀態。

本文所說的選擇,是指在使用者已有的可用設定中,依用途挑選,並辨別哪些欄位不可混用。用戶端一次買斷 ≠ 線路方案。iPhone / iPad 版在 App Store 售價 $2.99,為一次性付費;Mac(Apple 晶片與 Intel)、Windows、Android、Linux 版免費。用戶端費用不包含遠端伺服器服務。取得方式請見全平台下載頁;本頁不提供或推薦訂閱與節點。

Shadowsocks:精簡封裝與參數一致性

shadowsocks

設計重點是加密傳送代理資料

Shadowsocks 的基本概念,是將應用程式的代理請求加密後交由遠端伺服器處理,主要設定通常包括位址、連接埠、加密方法與密碼。相較於需要較多外層協商選項的組合,它的基本結構較精簡,適合用來理解代理協定最基本的兩端關係。不過,結構精簡不代表所有標示為 Shadowsocks 的設定都能互換:實際加密方法、協定版本、附加擴充功能與伺服器端實作,都會影響用戶端能否正確解析及通訊。

現代設定通常採用 AEAD(含關聯資料的驗證式加密)方法,同時保護機密性並偵測資料是否遭到竄改。加密方法不是可以任意調整的「速度檔位」,必須與伺服器端完全一致。伺服器端使用某種方法時,用戶端改成另一種,即使密碼相同也無法正常通訊。不同裝置對各種演算法的運算效率可能有所差異,但只有在伺服器端明確支援多種設定時,才應分別測試,不要在單一設定中任意更換演算法。

分別確認密碼、連接埠與擴充設定

手動新增時,先確認 Type 為 Shadowsocks,再逐項核對伺服器位址、連接埠、加密方法與密碼。密碼中的大小寫、符號及前後空格都會參與驗證相關運算,複製時尤其要留意換行與全形符號。有些較新的設定使用特定編碼與長度要求的金鑰資料,不可換成容易記憶的短句,也不能因為外觀看似一般密碼就刪除末尾字元。請保留服務供應商提供的完整原始內容。

連接埠只是伺服器上服務的入口編號,本身不代表使用哪種協定或是否啟用 TLS。設定使用常見的網頁連接埠,也不代表應額外啟用 TLS。若既有設定包含擴充或額外傳輸參數,還須確認用戶端能識別這些參數及其意義。匯入後只看到位址和密碼,不能據此認定所有資訊都已保留;應對照原始說明,尤其檢查只會出現在收合設定中的選項。

TCP 正常不代表 UDP 也正常

Shadowsocks 可用來傳送不同類型的流量,但 UDP 是否實際可用,取決於伺服器端是否啟用、網路是否允許,以及用戶端的相關選項。網頁能開啟但某個即時應用程式異常,可能是兩者對傳輸方式的需求不同。反過來說,開啟 UDP 相關選項,也無法讓只提供 TCP 服務的連接埠取得 UDP 能力。應先確認既有設定的支援範圍,再透過特定應用程式或可控請求驗證,不要只看列表中的單次測試結果。

在 iPhone 上,基礎 Shadowsocks 連線的封裝開銷通常較低,但實際耗電仍可能因重新連線與訊號微弱而增加。若從 Wi-Fi 切換到行動網路後,應用程式暫時沒有回應,應先觀察連線是否重新建立、遠端位址是否可連線,再檢查協定參數。不要只因為「切換協定後恢復」就認定另一種協定更省電;切換本身也可能清除舊連線狀態,並觸發新的網域解析與交握。

保留可還原的基準設定

訂閱中的 Shadowsocks 項目若能正常連線,可作為後續排查的基準,但不要隨意修改訂閱管理項目中的核心欄位。訂閱更新可能覆蓋手動修改,導致今天能用、下次更新後又恢復原值。需要比較參數時,可在清楚了解憑證用途的前提下建立獨立測試項目,並註明用途。分享排查資訊時,請隱藏密碼、金鑰及完整訂閱網址,只保留協定類型、欄位名稱與錯誤發生階段。

選擇 Shadowsocks 的合理前提,是已有參數完整且伺服器端支援的設定,並確認所需的 TCP、UDP 能力。選項較少不代表它必然適合所有情境;沒有整組 TLS 欄位也不代表應手動補上。先確認基本連線正常,再檢查規則、目標應用程式與網路切換狀況,便能避免把分流錯誤誤判為協定本身的問題。

VMess 與 VLESS:驗證與外層安全

vmess-vless

名稱相似,安全職責不同

VMess 將使用者驗證與資料保護等功能納入協定設計,常見設定以 UUID 識別使用者,並搭配特定傳輸方式運作。VLESS 的協定層設計則較精簡,本身不提供與 VMess 相同的負載加密機制,通常依靠外層安全機制保護傳輸。兩者並非只把同一個開關換個名稱,也不能因為伺服器位址和 UUID 看起來相同,就直接在 Type 中互相替換。

VLESS 的精簡,主要是減少協定本身承擔的職責,不代表整條連線必然更輕量,也不代表預設已有加密保護。若外層使用 TLS,仍須進行相應交握與憑證驗證;若伺服器端採用其他支援的安全組合,則應依該組合完整填寫。看到某個加密欄位顯示為 none,不代表連線一定以明文傳輸;反過來說,選用 VLESS 也不會自動保證安全,必須一併檢查協定層與外層設定。

UUID 不是伺服器位址,也不是憑證名稱

UUID 是與使用者身分相關的欄位,應保留完整內容,包括連字號與所有字元。它通常對應伺服器端的使用者設定,不應填入密碼、路徑或 Host 欄位。伺服器位址用來指定連線目的地,UUID 用來識別通訊使用者身分;TLS 的 Server Name 則參與對端身分驗證及服務選擇。即使三個欄位都由同一份訂閱提供,也各自有不同用途,彼此替換並不能達成「相容」。

VMess 的驗證機制對時間有要求。若裝置時間明顯不正確,即使位址和 UUID 都正確,也可能連線失敗。檢查時應先確認系統日期與時區設定正確,不要盲目修改伺服器端欄位。舊版設定中也可能有額外驗證參數,是否適用取決於兩端實際支援情況。不要照搬舊教學中的固定數值;優先依原始設定匯入並保留訂閱可完整表達的參數。

檢查項目VMessVLESS
身分資訊確認 UUID 與驗證相關設定確認 UUID 及伺服器端要求的附加項目
協定層加密具備自身的資料保護機制不承擔相同的負載加密職責
外層參數依實際傳輸與安全設定填寫必須確認外層安全組合
轉換條件伺服器端必須提供相應入口,不能只修改用戶端 Type

WebSocket 路徑與 TLS 名稱應分別確認

若設定使用 WebSocket,路徑通常須包含正確的前置斜線,並符合伺服器端路由要求。路徑不是任意備註,隨意修改可能會把請求送到其他處理入口。Host 是應用層請求中的主機資訊;Server Name 則是 TLS 交握中的名稱相關設定。兩者有時相同,有時會因伺服器端部署方式而不同。應分別核對,不能只因為「看起來都是網域」就合併填寫。

連線位址可以是網域,也可能是 IP 位址。使用 IP 連線,不代表憑證應以該 IP 進行驗證;若憑證對應的是網域,通常仍須提供符合部署設定的 Server Name。遇到憑證名稱錯誤時,應核對名稱、憑證有效期限與系統時間,而非長期關閉驗證。關閉驗證會改變信任邊界,卻無法修正錯誤的 UUID、WebSocket 路徑或伺服器端路由。

比較效能時,必須保留完整組合

在 iOS 上比較 VMess 與 VLESS 時,應記下完整組合,例如協定、傳輸方式、安全機制與伺服器位置,而非只記錄兩個名稱。開啟網頁所需時間,可能主要花在 DNS 與 TLS 交握;持續下載則更受頻寬與壅塞影響。頻繁短連線、長連線與網路切換屬於不同負載,測試結論不一定相同。只有在既有服務提供可比較的入口時,才適合進行控制變因測試。

如需進一步了解欄位差異,請參閱VMess 與 VLESS 的加密、開銷與參數說明。實際選用時,完整且可驗證的設定,比理論上更精簡的名稱重要。匯入項目若出現無法識別的附加參數,應先確認目前用戶端與伺服器端的支援範圍,不要刪除陌生欄位後,就把剩餘內容視為等效設定。

Trojan、HTTP 與 SOCKS5:不同的代理界線

proxy-boundary

TLS 是 Trojan 的重要組成部分

Trojan 的常見設計會將代理協定放在 TLS 連線之內,並使用密碼進行身分驗證。理解 Trojan 時,應同時留意外層 TLS 是否正常,以及內層驗證資訊是否相符。伺服器位址可連線,只代表能嘗試建立連線;憑證驗證成功,也不代表密碼一定正確。這種分層設計可能讓錯誤表現為交握失敗、驗證後中斷或特定目標無法連線,排查時須辨別問題發生在哪個階段。

手動設定 Trojan 時,位址、連接埠、密碼與 Server Name 都可能是必要資訊。伺服器憑證必須在有效期限內,名稱也須符合預期身分,裝置系統時間同樣應正確。密碼中的特殊符號應原樣保留,不可用 UUID 取代。若服務供應商另有提供傳輸擴充參數,須確認目前入口確實需要這些設定,不要只因為另一組伺服器也使用 TLS,就複製它的 WebSocket 路徑。

HTTP 代理的能力取決於入口實作

HTTP 代理透過 HTTP 語意處理請求,常見的 CONNECT 方法用於建立通往目標位址的通道。請分清楚「透過代理存取 HTTPS 網站」與「用戶端至代理入口本身使用 TLS」:前者描述目標連線,後者描述代理這一段連線。一般 HTTP 代理可以轉送 HTTPS 的 CONNECT 請求,但不代表傳往代理入口的驗證資訊與協商內容會自動受到 TLS 保護。

因此,若既有服務要求使用受 TLS 保護的代理入口,應依用戶端對應類型與安全選項填寫,不能因為目標網站是 HTTPS 就省略入口安全設定。使用者名稱與密碼也屬於代理驗證欄位,不是目標網站的登入資訊。一般 HTTP CONNECT 主要用於 TCP 通道,不應預設它能承載所有 UDP 應用程式。某個網頁正常,只能證明該次請求所需的能力已具備。

SOCKS5 是協商協定,本身不提供傳輸加密

SOCKS5 定義用戶端向代理伺服器請求連線的協商流程,可包含使用者名稱與密碼驗證,也定義 UDP 關聯機制。但協定本身不負責加密整段代理連線。是否有額外保護,取決於它所處的網路環境或外層通道。設定好 SOCKS5 使用者名稱與密碼,只能表示驗證方式已有對應參數,不能據此推斷驗證資訊與負載在網路傳輸時一定受到加密保護。

UDP 關聯能否運作,還會受到伺服器端實作、防火牆與位址可達性影響。即使 SOCKS5 規格包含這項能力,實際入口也可能未啟用。也須確認網域在哪裡解析:用戶端可能先將網域轉成 IP 再向代理提出請求,也可能將網域交由遠端處理,實際方式取決於設定與請求路徑。解析結果不同會改變目標位址,進而影響存取行為,不能簡單歸因為 SOCKS5 比其他協定慢。

類型重要欄位不可預設成立的結論
Trojan密碼、TLS、Server Name憑證通過就代表驗證成功
HTTP入口位址、驗證方式、入口安全機制存取 HTTPS 就代表代理這一段已加密
SOCKS5驗證、UDP 支援、解析路徑設定密碼就自帶傳輸加密

在可控環境中選擇通用代理

HTTP 與 SOCKS5 常見於組織內部代理、測試環境或使用者自行維護的服務。若既有環境明確指定入口類型,Shadowrocket 的工作是正確設定該入口,而不是改用名稱較複雜的協定。在不受信任的網路上傳送敏感驗證資訊前,應確認用戶端至代理入口這段連線具備哪些保護。應用程式與目標網站之間的端對端 TLS 仍然重要;它與代理入口安全分別提供不同層面的保護。

就 iPhone 的速度與耗電而言,Trojan 的 TLS 交握、連線重複使用情況,以及通用代理的回應品質都可能造成影響,但不能據此為三者排出固定名次。若需求涉及即時影音或其他 UDP 應用程式,應先確認整條傳輸路徑都支援。若只是使用組織指定的 TCP 代理,應優先維持設定簡潔、身分驗證明確及憑證驗證完整,避免為不存在的能力反覆調整參數。

WireGuard:金鑰、位址與通道範圍

wireguard

從網路層通道理解設定

WireGuard 的用途是建立加密 IP 通道,而非只為某個應用程式連線定義代理請求。因此,設定中會出現介面位址、對端公鑰、Endpoint 與路由範圍等網路層概念。它與 Shadowsocks、Trojan 的欄位配置不同是正常的,不應把私鑰填成一般密碼,也不能把介面位址當作伺服器位址。先分清本機介面、遠端對端與通道內的目的位址,才能正確理解流量如何傳送。

WireGuard 採用固定的現代密碼學組合,減少雙方需要協商的演算法選項。使用者通常不必在用戶端挑選一長串加密演算法,但仍須妥善管理金鑰。Private Key 是本端私鑰,只應用於對應裝置或設定;Peer 的 Public Key 用來識別對端,不是自己的公鑰。若設定包含 Preshared Key,兩端必須一致。它是額外的共用資料,不能取代公私鑰關係,也不是通用密碼。

Endpoint 與介面位址不可互換

Endpoint 說明如何在目前網路中找到遠端,通常包含主機名稱或 IP 位址與連接埠。介面位址則是通道內本端使用的位址,通常帶有前綴長度。若將內部位址填入 Endpoint,用戶端可能會嘗試連線至通道建立前根本無法連線的目標。若設定同時包含 IPv4 與 IPv6,還須確認目前網路與伺服器端都支援相應能力,不能只因其中一種位址存在,就認定另一種也可用。

在 WireGuard 中,Allowed IPs 與路由選擇及對端允許的位址範圍有關,並不等同於簡單的網站允許清單。將 WireGuard 作為 Shadowrocket 中的一種出站類型使用時,還須區分通道位址範圍與用戶端外部的規則系統:外層規則先決定特定連線是否選用這個出站,出站內部再受自身能力與設定限制。未經確認,不要把完整通道設定中的路由結論直接套用到整個用戶端。

保活與 MTU 解決的是不同問題

行動網路經常透過 NAT 維持位址對應。Persistent Keepalive 在需要時以週期性資料維持對應,但頻率並非越高越好。沒有必要的保活會增加無線活動並影響待機耗電;間隔過長則可能無法符合特定網路維持對應的需求。應依伺服器端與網路的實際要求設定,不要照抄固定秒數。若只有長時間閒置後的首次請求失敗,才值得優先檢查位址對應、保活與重新交握流程。

MTU 決定通道內可承載的封包大小上限。通道封裝會增加額外負擔,若未妥善處理路徑上的限制,可能出現小型請求正常、大型資源卡住的情況。此時降低 MTU 可能有所幫助,但不是所有速度問題都能歸因於 MTU。應先確認故障是否與封包大小或特定目標相關,再一次調整一個變因。任意把 MTU 調得很小會增加封包數量與額外負擔,不一定能提高實際傳輸量或降低耗電。

切換行動網路時觀察交握與路由

WireGuard 有處理對端位址變動的機制,但在 iOS 上實際能否恢復,仍取決於目前網路是否允許傳送 UDP、用戶端通道狀態及伺服器端回應。Wi-Fi 正常、行動網路失敗時,應先比較 UDP 可達性與位址類型,不要直接重新產生金鑰。金鑰錯誤通常不會只在一種本地網路下發生。若連線已建立但內部資源仍無法存取,則繼續核對通道位址、允許範圍、伺服器端轉送與回程路徑。

適合已掌握完整 WireGuard 設定,且需要存取自行維護的網路或既有通道服務的使用者。可以匯入設定檔,不代表所有網路層條件都已具備,尤其是伺服器端轉送與內部 DNS。耗電情況也應依實際用途評估:持續傳輸與長時間待機是不同的測試情境。記錄網路類型、保活設定與重新連線狀況,比單純比較用戶端執行時間更有參考價值。

Hysteria2:QUIC、壅塞與頻寬預期

hysteria2

以 UDP 上的資料傳輸為設計基礎

Hysteria2 以 QUIC 相關機制建構代理傳輸,著重於高延遲、封包遺失等鏈路條件下的資料傳送。QUIC 運作於 UDP 之上,但這不代表應用程式資料沒有可靠性保障,也不代表所有流量都會以一般即時資料報處理。這套機制可負責可靠傳輸、流量控制與加密。使用者應區分底層使用 UDP,與目標應用程式原本使用 TCP 或 UDP 這兩件事。

這類設計可能改善某些鏈路上的使用體驗,但實際效益取決於伺服器端能力、路徑條件與網路政策。若目前網路不支援 UDP,再適合高封包遺失環境的協定也無法憑空建立連線。即使 UDP 可達,路徑限速、裝置資源與伺服器頻寬仍會形成上限。因此,不應把 Hysteria2 當成勾選後就能提升速度的開關,也不能把一次較快的下載結果當作適用於所有網路的結論。

驗證與 TLS 欄位仍須完整設定

手動填寫時,應核對協定類型、伺服器位址、連接埠、驗證資訊與 Server Name。Hysteria2 不可視為與名稱相近的其他協定使用相同設定格式,匯入時應確認用戶端識別出的類型正確。憑證驗證仍負責確認對端身分;連線逾時與憑證錯誤應分別排查。遇到前者,優先檢查網路可達性與連接埠;遇到後者,則核對名稱、憑證鏈、有效期限與裝置時間。

若既有設定包含混淆參數,必須與伺服器端設定一致,包括是否啟用及相應的驗證資料。混淆不是加密強度滑桿,也不是每個入口都需要的功能。任意增加設定會讓兩端無法理解彼此的資料。既有訂閱可以匯入時,應優先保留完整參數;手動重建時,先整理欄位清單,並確認每個非預設選項的來源,不要把網路文章中的範例值當成目前伺服器的要求。

頻寬欄位不代表測速結果

某些設定會涉及上行與下行頻寬預期,可能依兩端設定影響壅塞控制方式或傳送行為。填入更大的數字不會增加電信業者提供的頻寬,反而可能造成排隊、封包遺失,或影響同一網路上的其他服務。上行與下行也不能互換:家用網路的上下行能力通常不對稱,應依目前鏈路可持續提供的能力設定,而不是照抄伺服器標示的連接埠速率。

若用戶端介面或既有設定使用頻寬數值,應先確認單位,區分每秒位元與每秒位元組。也要確認伺服器端是否接受用戶端提供的頻寬提示,以及目前組合實際採用的壅塞控制方式。網路類型改變時,原本適合 Wi-Fi 的預期值未必適用於行動網路。缺乏測量依據時,優先保留服務供應商提供的設定或支援的預設行為,不要為了追求列表中的數字而頻繁調高。

在 iOS 上同時觀察傳輸量與無線活動

在 iPhone 上,高傳輸量代表更多資料處理與無線傳輸,不能只因下載完成得較快,就直接判定更耗電或更省電。應考量完成相同任務所需的總時間、總傳輸量、是否頻繁重試及裝置信號狀況。連續測速本身就會造成明顯負載,不適合用來推估待機表現。測試時請固定螢幕亮度、網路與資源,並避免其他應用程式同時大量傳輸。

評估視訊通話、遊戲與檔案下載時,指標也各不相同:持續下載著重傳輸量,即時互動則更在意延遲波動與封包遺失後的恢復能力。能充分利用頻寬的設定,可能讓同一網路上的互動請求排隊。若下載時網頁與通話明顯變差,應檢查頻寬預期是否過高、上行是否已滿載,而非只看下載速度。分層檢查方式請參閱速度變慢時的本地網路、協定與線路排查。

串連協定參數與規則分流

fields-and-rules

位址、名稱、路徑與憑證各有用途

跨協定最常見的問題,通常不是漏掉某個進階開關,而是把不同層級的欄位填在同一個位置。伺服器位址用來找到遠端入口,連接埠用來選擇服務;Server Name 參與 TLS 名稱協商與身分驗證;Host 可能屬於特定應用層傳輸;Path 則指定某個傳輸處理路徑。這些欄位可能剛好使用相同文字,但意義並不相同。發生錯誤時,應先依欄位用途理解設定,不要只憑外觀複製。

憑證也有不同類別:密碼、UUID、Private Key 與 Public Key 不可混用。訂閱連結本身可能含有存取憑證,應像密碼一樣妥善保管,不要貼在公開截圖或排查紀錄中。匯入後部分欄位空白,可能是來源格式、編碼或用戶端支援範圍所致,不應立刻用另一台伺服器的值補上。應對照自己的原始資訊,確認是否匯入完整項目;必要時,重新取得同一設定的正確格式。

Global Routing 決定是否使用協定

Global Routing(全域路由)中的 Config(設定)、Proxy(代理)、Direct(直連),代表用戶端處理流量的模式,並非三種伺服器協定。Config 依設定檔規則決定處理方式;Proxy 以代理模式處理連線;Direct 則以直連模式處理連線。因此,某項協定設定測試正常,但目標應用程式處於 Direct 模式時,仍不會如預期使用代理。反過來說,切換至 Proxy 後恢復正常,也可能只是避開了錯誤規則,而非修復協定。

介面選項處理方式排查重點
Config依目前設定的規則選擇策略確認目標命中了哪條規則
Proxy以代理模式處理連線比對差異是否由規則造成
Direct以直連模式處理連線確認本地網路的基本連線能力

規則由上而下比對,命中第一條後即停止

以下是用來說明規則順序的 Shadowrocket .conf 規則片段,不包含伺服器資訊,也不能單獨組成可用的代理設定。DOMAIN-SUFFIX 依網域後綴比對,IP-CIDR 依位址網段比對,GEOIP 依位址地理資料庫判斷,FINAL 則接收前面未命中的連線。PROXY 代表代理策略,DIRECT 代表直連策略。範例中的 example.com 僅為保留的示範網域,不代表需要存取或設定的實際服務。

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

若較寬泛的規則排在前面,後面的具體規則可能永遠不會命中。例如,前面的規則已涵蓋目標所在的位址範圍,之後再新增一條網域規則,結果未必會改變。網域規則也仰賴用戶端處理時掌握網域資訊;只有 IP 資訊的連線,不一定能如預期命中網域後綴規則。GEOIP 依據目標 IP 與本地資料庫的比對結果判斷,並非用來識別訪客身分。

DNS 與 UDP 應分開驗證

DNS 決定網域解析出哪些位址,協定則決定選定的連線如何抵達遠端,兩者彼此影響,但不能混為一談。目標網域解析失敗時,更換 UUID 通常無法解決問題;若解析到無法連線的位址,即使伺服器交握正常,網頁仍可能無法開啟。排查時應分別記錄解析是否成功、取得哪種位址類型,以及該連線最後命中哪項策略,避免把所有狀況都簡化成「節點連不上」。

UDP 支援也須從應用程式、用戶端、出站協定、伺服器端與網路路徑逐項確認,不能只看某一個開關。On Demand(隨選連線)控制用戶端何時依條件建立或維持連線,不會改變伺服器協定類型,也無法修復驗證參數。若問題只在自動連線或切換網路時發生,應將觸發條件與協定交握分開觀察。三種模式的日常使用方式請參閱Global Routing 說明,規則關鍵字請查閱術語表。

依現有條件選擇,再分層排查

decision-and-check

先列出限制條件,不要先替協定排名

選擇應從現有可用設定開始。先確認目前網路是否允許 UDP、伺服器端提供哪些協定與傳輸組合、目標應用程式是否需要 UDP,以及更重視持續下載、互動回應或待機後恢復。若只有一組明確可用的伺服器設定,正確的選擇就是使用相符的用戶端類型,無須為了某個協定名稱重新拼湊欄位。若有多組入口,先排除目前網路無法承載的組合,再比較實際任務表現。

需要存取自行維護的內部網路,且已有完整位址與金鑰設定時,可了解 WireGuard 的路由與介面範圍;已有精簡的加密代理設定時,可先確認 Shadowsocks 的加密方法與 UDP 能力;若依賴特定傳輸部署,應留意 VMess、VLESS 的完整外層組合;已有 TLS 代理入口時,核對 Trojan 的憑證與密碼;組織指定使用通用代理時,則依 HTTP 或 SOCKS5 的實際能力設定。使用 Hysteria2 的前提之一,是目前網路路徑能正常承載所需的 UDP 通訊。

將「無法連線」拆解成可觀察的階段

第一步,確認本地網路基本可用,並選定一個可自行驗證的目標請求。第二步,核對伺服器網域能否解析、位址類型是否合適,以及入口連接埠與傳輸方式是否相符。第三步,檢查交握:使用 TLS 的設定要確認名稱、憑證與系統時間;使用金鑰或 UUID 的設定則要核對憑證是否完整。第四步,在驗證成功後,確認目標請求是否成功,以及規則是否真的選到該出站。每次只修改一個變因,並保留失敗狀況。

Connectivity Test(連線測試)可作為排查線索,但單次結果不能取代完整的應用程式驗證。測試可能只涵蓋特定請求、目標或連線階段。列表中有回應,不代表目標影片、UDP 應用程式及內部網域都正常;測試失敗也不一定代表所有服務都無法連線。應盡量使用與實際故障相同的目標與流量類型,並記錄故障是立即發生、等待逾時,還是開始傳輸後才中斷。

狀況優先檢查暫時不要急著修改
始終無法開始交握位址、連接埠、TCP / UDP 可達性規則細節、頻寬預期
憑證驗證失敗Server Name、時間、憑證鏈UUID、規則順序
網頁正常,即時應用程式異常UDP 完整路徑、目標規則重建所有伺服器項目
只有大型資源卡住路徑、封包遺失、MTU 相關跡象任意更換驗證資訊
只有在 Config 模式下異常規則命中、策略、DNS協定類型

分開記錄速度與耗電

測試速度時應固定目標資源、本地網路與伺服器入口,分別觀察首次回應與持續傳輸,避免把快取命中誤認為協定改善。測試耗電則應固定任務量、螢幕使用情況與訊號條件,並留意待機期間是否反覆重新連線。系統電池統計反映一段時間內的整體活動,無法直接區分每次協定交握的耗能。不要以幾分鐘內的電量百分比變化精確排名,也不要為了排查待機耗電而持續進行高負載測速。

切換網路後才出現的問題,應分別記錄 Wi-Fi 與行動網路的差異,包括位址類型、UDP 可達性及閒置後的恢復情況。只有特定目標異常時,應優先檢查該目標的 DNS、路由與服務狀態,不要立刻更換整個協定。若多組設定在同一個本地網路中同時失敗,換網路後卻恢復正常,應優先調查本地網路路徑,而非假設多組憑證同時失效。依此判斷能減少缺乏依據的設定變更。

保留原始設定與可重現的步驟

訂閱更新後若出現變化,應先比較項目是否被取代、傳輸欄位是否改變,以及手動編輯是否遭到覆蓋。不要把舊設定的憑證直接拼接到新入口。記錄最小重現步驟時,只需寫明裝置網路、協定組合、錯誤階段、目標類型及已驗證的對照結果,並隱藏完整訂閱網址與憑證。訂閱匯入後內容空白的檢查方式,請參閱訂閱匯入自我檢查;其他常見狀況請見常見問題。

測試完成後,請還原日常使用的 Global Routing 模式,並復原暫時放寬的設定。可用、完整且能說明的設定,比無法重現的單次速度結果更適合作為長期選擇依據。若要重新依步驟檢查匯入與連線,請返回使用說明;需要取得用戶端時,請使用全平台下載頁。iPhone / iPad 的系統需求以 App Store 頁面標示為準,本頁不依協定名稱推斷裝置相容性。