本文速览

适合已拿到 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、安卓及 Linux 版免费,安装包通过本站下载页获取。