本文適合已取得服務商提供的 WireGuard 設定,並需要在 Shadowrocket 中核對參數的使用者。先分辨本機與遠端身分,再檢查隧道位址、目標網段及 UDP 端點,最後透過 Global Routing 區分協定連線問題與規則選擇問題。範例位址僅供說明欄位,無法用來連線。
一、先區分 [Interface] 與 [Peer]
WireGuard 設定通常分為 [Interface] 和 [Peer] 兩個部分。前者描述本機隧道介面,後者描述通訊對端。將設定輸入 Shadowrocket 時,應依欄位意義逐一對應,而不是照複製順序填寫。以下操作以 iPhone / iPad 為例;其他平台的欄位排列可能不同。
PrivateKey 屬於本機;[Peer] 內的 PublicKey 屬於遠端。伺服器端也必須登錄本機對應的公鑰,並為本機配置正確的位址。只在用戶端填妥欄位,不代表伺服器端已完成配對。
WireGuard 的私鑰、公鑰及選用的預共享密鑰通常以 Base64 文字表示,標準編碼為 44 個字元,結尾常是 =。長度相同不代表用途相同,也不能據此證明密鑰有效。請勿將這些欄位當成密碼、訂閱網址或憑證內容。
二、PrivateKey、PublicKey 與 PresharedKey 的對應關係
本機身分
- PrivateKey
- 本機私鑰,保留在本機設定中,不要傳給協助排查的人員。
- 本機 PublicKey
- 由本機 PrivateKey 推導而來,供伺服器端登錄本機身分。
- Address
- 伺服器端分配給本機的隧道位址,不是公網伺服器位址。
更換本機 PrivateKey 後,也必須同步更新伺服器端登錄的本機公鑰。
遠端身分
- [Peer] PublicKey
- 遠端公鑰,用來識別本機要連線的對端。
- PresharedKey
- 選用的額外共享密鑰;若有啟用,兩端必須一致。
- Endpoint
- 遠端可連線的位址與 UDP 連接埠。
現有設定若沒有 PresharedKey,請勿自行產生並填入。
最常見的填錯方式,是將本機公鑰填入遠端的 PublicKey,或將遠端公鑰誤填為本機的 PrivateKey。這兩種錯誤可能仍通過文字格式檢查,卻無法建立正確的加密連線。核對時應同時確認「密鑰屬於哪一端」以及「它是公鑰還是私鑰」。
請勿公開完整的 WireGuard 設定。PrivateKey 與 PresharedKey 都是敏感資訊。需要回報問題時,請保留欄位名稱、錯誤訊息及網路狀況,並刪除密鑰內容;若私鑰已外洩,應更換密鑰並請伺服器端更新對應公鑰。
三、Address、DNS 與 MTU 各自的作用
Address 是隧道內部的本機位址,通常會帶有 CIDR 前綴,例如 10.66.0.2/32。它不是目前 Wi-Fi 的區域網路位址,也不是 Endpoint。請勿因裝置切換 Wi-Fi,就將這個位址改成新的區域網路位址。
| 欄位 | 範例或單位 | 核對重點 |
|---|---|---|
| Address | 10.66.0.2/32 | 使用已分配的位址;請勿自行擴大前綴長度。 |
| DNS | DNS 伺服器 IP 位址 | 確認解析器可連線,並核對 Shadowrocket 目前的 DNS 設定。 |
| MTU | 位元組,例如 1420 | 限制隧道內層 IP 封包大小,並非連線速度。 |
DNS 和 Address 都不是 WireGuard 握手封包中的身分欄位。常見設定檔中的這些項目由用戶端或設定工具處理。將檔案內容對應至 Shadowrocket 時,不能假設檔案中的每個項目都會自動覆寫 App 的全域設定;也應核對 Settings → DNS 中實際使用的解析設定。
MTU 設定過大時,可能出現小型請求有回應、較大傳輸卻停滯的情況,但相同現象也可能是其他網路問題所致。外層使用 IPv4 時,WireGuard 封裝的典型額外負擔為 60 位元組;外層使用 IPv6 時則為 80 位元組。在底層 MTU 為 1500 的情況下,1420 是兼顧 IPv6 外層的常見起始值,但不適用於所有網路鏈路。
- 先使用服務商指定的 MTU;若未指定,優先保留用戶端預設值。
- 只有在連線已建立但部分傳輸異常時,再單獨測試調整 MTU。
- 每次只修改一項設定,使用相同目標重新測試,並記錄修改前後的數值。
四、AllowedIPs 不等於 Global Routing
在 WireGuard 中,AllowedIPs 用來對應對端與 IP 前綴:傳送時據此選擇承載目標位址的對端,接收時則用來驗證解密後封包的來源位址。傳統隧道工具也可能依此安裝系統路由;Shadowrocket 作為規則代理用戶端,另有獨立的流量選擇層。
因此,AllowedIPs = 0.0.0.0/0, ::/0 表示對端涵蓋 IPv4 與 IPv6 位址範圍,不代表裝置的所有請求都已由 Shadowrocket 選取並送往該對端。還必須檢查連線開關、目前選取的連線、Global Routing,以及設定規則所使用的策略。
# 欄位說明片段,並非可直接匯入的完整連線設定。
# 以下位址僅為文件範例,不提供連線服務。
[Interface]
Address = 10.66.0.2/32
MTU = 1420
[Peer]
Endpoint = 192.0.2.10:51820
AllowedIPs = 0.0.0.0/0, ::/0
PersistentKeepalive = 25
此片段刻意省略密鑰。0.0.0.0/0 僅涵蓋 IPv4;::/0 涵蓋 IPv6。若只設定 10.66.0.0/24,表示這個對端只對應該網段,不能因此預期它會承載任意公網目的地。是否設定 IPv6,也應以伺服器端支援情況及既有配置為準。
DOMAIN-SUFFIX,example.com,DIRECT:在規則模式下,讓符合的網域後綴使用 DIRECT。IP-CIDR,192.0.2.0/24,DIRECT,no-resolve:將範例 IPv4 網段指定為 DIRECT,且不因這條規則主動解析網域。GEOIP,CN,DIRECT:依據所使用的 GeoIP 資料庫比對 IP 所屬地區;比對結果取決於資料庫中的位址記錄。FINAL,DIRECT:作為規則末尾的預設處理;實際策略請依自己的設定填寫。
這些是 [Rule] 區段的規則,不應貼入 AllowedIPs。規則會依序比對;若前面的 DIRECT 規則已符合,後續的代理策略便不會再接手處理該請求。
五、Endpoint 與 PersistentKeepalive 的填寫原則
Endpoint 是本機首先需要透過目前網路存取的遠端位址,可以是 IP 位址或主機名稱,並附上連接埠。標準設定的寫法為 192.0.2.10:51820;若編輯介面將位址與連接埠分開,請分別填寫,不要把整串內容重複放進兩個欄位。
- 位址欄位不需加上
https://,也不要附加網頁路徑或貼上訂閱查詢參數。 - 標準設定中的 IPv6 端點應使用方括號,例如
[2001:db8::10]:51820,避免將位址中的冒號誤認為連接埠分隔符號。 - 確認遠端正在監聽設定指定的 UDP 連接埠。TCP 連接埠探測成功,不能證明相同編號的 UDP 連接埠可連線。
- 使用主機名稱時,先確認它能在連線建立前解析,避免依賴尚未建立的隧道內 DNS。
PersistentKeepalive 的單位是秒,用來視需要傳送保活資料,以維持 NAT 或防火牆狀態。25 是常見設定值,並非必要值;未設定或設為 0 通常代表停用定期保活。它不是連線逾時設定,也無法修正錯誤的公鑰或伺服器端未開放的連接埠。
若只在 Wi-Fi 與行動網路切換後發生中斷,請記錄切換時間、能否重新建立連線及 UDP 可達性,再判斷是否需要保活。不要以不斷縮短保活間隔取代身分與端點檢查。
六、在 Shadowrocket 中輸入設定並分層驗證
以下步驟以已有有效設定為前提。本網站不提供、不銷售也不推薦節點或訂閱。若參數來自自己的訂閱,請先核對服務商提供的原始資訊;訂閱更新可能會重新寫入連線欄位,因此排查前應記錄目前數值,避免手動修改被下次更新覆蓋。
-
選擇協定
前往 Home →「+」→ Type → WireGuard。若已有連線,請從 Home 開啟對應項目進行編輯,先確認 Type;不要將其他協定的密碼或識別資訊填入 WireGuard 密鑰欄位。
-
核對身分
依照本機與遠端的對應關係,填入 PrivateKey、遠端 PublicKey,以及設定確實要求的 PresharedKey;同時確認伺服器端登錄的是本機公鑰。
-
核對位址
檢查 Address、Endpoint 與連接埠。若編輯介面沒有獨立列出原始設定中的某個項目,請先確認該項目在目前用戶端中的對應位置,不要填入意義相近但不同的欄位。
-
暫時測試
儲存並選取該連線,前往 Home → Global Routing → Proxy,以相同的已知可連線目標進行測試,並檢查連線狀態與記錄。不要把清單中的延遲結果視為完整的服務驗證。
-
恢復規則
測試結束後,返回 Home → Global Routing → Config,確認 Config 中啟用的設定及目標符合的策略。若自動重新連線影響測試,也請檢查 Settings → On Demand。
On Demand 控制符合條件時的自動連線行為,不能取代 AllowedIPs 或 [Rule]。排查期間若停用此功能,請記下原設定,測試完成後再恢復,避免將自動重新連線誤判為手動開關未生效。
Config
建議依目前的設定規則決定流量處理方式。規則可能選擇 DIRECT,也可能選擇使用 WireGuard 的策略;並非所有未符合規則的請求都會自動經由代理傳送,最終行為取決於 FINAL。
適用情境:協定驗證完成後,依日常規則分流。
Proxy
以代理模式處理流量,可減少規則分流對測試的影響。仍須確認目前選取的策略指向待測連線,而且此模式不會繞過系統流量範圍、遠端權限或 WireGuard 參數限制。
適用情境:暫時判斷故障是否與規則選擇有關。
Direct
以直連模式處理流量,可作為本機網路的對照條件。此時目標可以連線,不代表 WireGuard 設定正確,因為測試可能未經過該連線。
適用情境:確認目標在目前本機網路中的直連狀況。
七、依據現象縮小問題範圍
不要只憑「連線開關已開啟」就判定 WireGuard 已完成握手。開關代表用戶端的連線狀態;遠端身分是否相符、UDP 是否雙向可達,以及特定目標的資料傳輸狀況,仍須分別驗證。以下是排查順序,不代表可僅憑單一現象確定故障原因。
| 觀察到的現象 | 優先核對項目 | 下一步 |
|---|---|---|
| 無法建立有效通訊 | 兩端的公鑰登錄、PresharedKey、Endpoint、UDP 連接埠 | 請聯絡自己的服務商,核對伺服器端監聽狀態與對端登錄資訊。 |
| 指定 IP 可連線,網域名稱失敗 | DNS 可達性與實際解析路徑 | 以相同目標比對網域解析結果,避免比較不同服務。 |
| 小型請求正常,大量傳輸停滯 | 路徑 MTU、封包遺失及遠端限制 | 保留其他設定,只調整 MTU,再重複相同測試。 |
| Proxy 正常,Config 異常 | 目前使用的設定、符合的規則與策略選擇 | 檢查目標是否已先符合 DIRECT 或其他策略。 |
| 訂閱更新後參數變更 | 更新前後的欄位與伺服器端配置 | 核對訂閱來源傳回的內容,不要反覆覆寫服務商已變更的參數。 |
向自己的服務商回報時,請提供系統平台、使用的網路類型、發生條件、已核對的欄位名稱及已去除敏感資訊的錯誤記錄。請勿傳送 PrivateKey 或 PresharedKey。若伺服器端確認已更換公鑰、連接埠或位址配置,請同步更新對應欄位,再從協定測試開始重新檢查。