本文重點

適合已取得 WireGuard 用戶端設定,準備手動新增至 Shadowrocket 的讀者。先透過 [Interface] 和 [Peer] 區分本端與對端,再確認目標流量是否應經由通道傳送。若連線異常,依序檢查握手、目標 IP、網域解析和封包大小,不必一次修改多個參數。

從 Home 新增 WireGuard

以下以 iPhone / iPad 為例。開始前,請向既有服務的管理員確認手上的設定是指派給目前裝置的用戶端設定,而非伺服器設定或其他裝置的設定。兩者可能都有 [Interface] 和 [Peer],但金鑰與位址的歸屬不同。

  1. 在 Home 點選右上角的 +,進入 Add Server,並在 Type 中選擇 WireGuard。
  2. 依照原始設定填寫本端位址、金鑰和對端連線參數。如果介面將主機和連接埠分開,請將 Endpoint 拆成兩欄填寫;主機欄不要再加上連接埠。
  3. 儲存後返回 Home,選取剛新增的 WireGuard 項目並開啟連線開關。如果系統提示新增 VPN 設定,請依裝置指示確認;開啟開關只代表已啟用本機連線,不表示已與對端完成握手。
  4. 前往管理員確認會經由此項目轉送的目標。若使用 Global Routing 的 Config,請先確認規則沒有將該目標分配至 DIRECT 或其他出站。
用戶端資料欄位填寫選擇出站目標請求檢查回應

PrivateKey、PublicKey 和 Endpoint 欄位歸屬

以下欄位名稱沿用常見 WireGuard 用戶端設定檔的寫法,用來辨識參數用途,不代表各平台表單標籤都相同。範例位址使用文件專用保留位址,並非可用線路。

本端:[Interface]

PrivateKey
目前裝置的私鑰。請使用指派給本端的完整值,不要在此填入本端公鑰,也不要刪除結尾的 =。
Address
指派給本端的通道位址,例如 192.0.2.10/32。請保留原有的前綴長度,不要填入伺服器的公網位址。
DNS
原始設定指定的解析器。例如解析器位於遠端私有網路時,也要確認前往該解析器的請求能經由相應路徑傳送。
MTU
通道介面的最大傳輸單位,以位元組計。若原始設定有指定值,請先沿用;未指定時,先維持用戶端的預設設定。

管理員需要登記的是本端公鑰,不是本端私鑰。

對端:[Peer]

PublicKey
對端的公鑰,用戶端會以此識別遠端。不要從本端私鑰推導公鑰後填入此欄。
Endpoint
對端可連線的位址和 UDP 連接埠,例如 192.0.2.20:51820;若單一欄位要填 IPv6,請使用 [2001:db8::20]:51820 格式。
AllowedIPs
分配給此對端的位址前綴,例如 198.51.100.0/24;這不是本端的 Address,也不要填入網域名稱。
PresharedKey
選填的預共享金鑰。若原始設定有此項目,必須與對端的對應設定一致;不能以任何公鑰代替。
PersistentKeepalive
保活間隔,單位為秒。只有在設定要求或需要維持 NAT 對應時才使用;例如 25 表示每 25 秒傳送一次保活封包。

51820 是常見的範例連接埠,並非固定值;請使用對端實際監聽的 UDP 連接埠。

若更換了 PrivateKey,請管理員同步更新對端登記的本端公鑰。只在用戶端更換金鑰而未更新對端,即使位址和連接埠完全正確,也無法完成握手。排查時請勿傳送含有 PrivateKey 或 PresharedKey 的設定原文或截圖。

AllowedIPs 與 Global Routing 的分工

AllowedIPs 用來決定 WireGuard 將哪些出站目標位址交給該對端,也會用於檢查從該對端收到的內層封包來源位址。Global Routing 則決定 Shadowrocket 是否讓某個連線使用此出站。兩者都必須符合:將目標網段加入 AllowedIPs 不會修改 Shadowrocket 的分流規則;規則選擇了 WireGuard,也不會自動將目標加入該對端的位址範圍。

/32
單一 IPv4 位址
/128
單一 IPv6 位址
0.0.0.0/0
所有 IPv4 位址
::/0
所有 IPv6 位址

結論:先確認目標 IP,再調整前綴

例如目標不在 198.51.100.0/24 範圍內時,請先確認是否應經由對端傳送,不要為了通過測試就直接改成 0.0.0.0/0。若網域同時回傳 IPv4 和 IPv6 位址,請確認實際使用的是哪種位址。

握手失敗、網域無法連線與 MTU 排查

測試時固定使用相同目標和網路,每次只修改一項。如果 Endpoint 填的是網域名稱,必須在通道建立前就能解析;只能透過通道存取的 DNS 解析器,無法解決首次連線時的解析需求。

狀況檢查步驟
送出目標請求後仍未完成握手如果用戶端沒有顯示握手狀態,請管理員查看對端最近一次握手時間。確認 Endpoint 的主機和實際 UDP 連接埠、對端公鑰及預共享金鑰是否正確,並確認對端已登記本端公鑰。一般網頁可以瀏覽,不代表該 UDP 連接埠可連線。
已完成握手,但目標 IP 仍無法連線確認應用程式選用的出站、目標是否位於本端 AllowedIPs 範圍內,以及對端是否已為本端通道位址設定正確的前綴與回程路由。握手成功不代表目標網段的轉送已設定完成。
目標 IP 可連線,但網域無法存取先確認網域能否解析、解析器是否可連線,再比對回傳的位址與分流結果。不要只用瀏覽器直接存取 HTTPS IP 位址作為判斷依據:憑證和網站選擇也可能造成連線失敗。
小型請求正常,大型回應卻一直卡住確認不是目標服務異常後,再測試路徑 MTU。記錄原始值,例如暫時將 1420 調整為 1380,並用相同請求重新測試。這個差值僅供定位問題,不是通用建議;若沒有改善,請恢復原值。

Shadowrocket 全平台取得方式

iPhone / iPad 可從 App Store 取得,價格為 $2.99,一次性付費;開發者為 Shadow Launch Technology Limited,系統需求以 App Store 頁面標示為準。Mac(Apple 晶片與 Intel)、Windows、Android 和 Linux 版免費,安裝檔請從本站下載頁取得。