Shadowrocket WireGuard 配置详解:PrivateKey、PublicKey、Address 与 MTU 参数含义

逐项解释 WireGuard 节点的密钥对、Address、Endpoint、MTU、Keepalive 等字段的含义,并说明在 Shadowrocket 中手动添加时填写的位置与常见错位。

本文速览

手动填写 WireGuard 时,先区分本机与对端,再区分隧道内地址与外部连接地址。本文适合已经拿到当前设备专用配置的 iPad 或 iPhone 用户:按字段对应关系录入,保存后依次核对握手、路由和实际访问,最后才决定是否需要调整 MTU 或 Keepalive。

PrivateKey 与 PublicKey:先判断密钥属于谁

以客户端配置为准,[Interface] 描述本机,[Peer] 描述与本机通信的对端。两端各有自己的密钥对。Shadowrocket 中要填的是本机的 PrivateKey 和对端的 PublicKey,不是把同一对公私钥的两个值一起填进去。

客户端配置中的本机与对端

[Interface] 本机
  • PrivateKey 是当前设备的私钥。录入时保留原字符串,不删掉末尾的等号,也不要把字段名一并粘贴进去。
  • Address 是当前设备在隧道内使用的地址,通常由配置提供方分配,不是当前 Wi-Fi 给 iPad 分配的地址。
[Peer] 对端
  • PublicKey 用于识别对端。服务端反过来使用本机的公钥识别当前设备。
  • Endpoint 是发出 WireGuard UDP 数据包的目的地。若配置还包含 PresharedKey,应在对应字段填写同一份配置提供的值,不代替任何公钥或私钥。

不要把服务端配置当作客户端配置使用;向管理员核对设备身份时提供本机公钥,不发送私钥或预共享密钥。

Address、Endpoint 与 MTU 字段对照

WireGuard 配置中的 Address 与应用界面里用来填写服务器地址的 Address 可能同名。判断依据是字段所在的位置与用途:如果一个 Address 和 Port 配对,它接收的是 Endpoint 的主机部分;隧道内地址应填到客户端 IP 对应的字段。

字段示例值填写位置与核对方法
Address10.20.30.2/32隧道内的本机 IPv4 地址。若同时分配了 IPv6,按界面对应字段分别填写。使用配置给出的前缀,不自行把 /32 改成 /24。
Endpoint198.51.100.20:51820对端的 IP 或主机名,加 UDP 端口。界面若分列主机和端口,就分别填写 198.51.100.20 与 51820,不加 https://。
MTU1420隧道接口可承载的最大内层 IP 包大小,单位为字节。外层 IP、UDP 和 WireGuard 封装还会占用传输空间,适用值取决于实际路径。
PersistentKeepalive25对应应用内的 Keepalive 设置,单位为秒。用于在没有业务流量时维持 NAT 或防火墙的 UDP 状态,不是握手超时,也不是延迟测试频率。

表内数值只用于说明格式;示例 Endpoint 使用文档保留地址,不能用于连接。实际录入以自己的配置为准,尤其不要把示例端口当成协议要求。

UDP
WireGuard 的外层传输协议
51820
常见端口示例,服务端可配置为其他端口
0 秒
关闭 PersistentKeepalive

Shadowrocket 手动添加 WireGuard

先准备当前设备的客户端配置。它如果同时列出多个 [Peer],不能从不同段落各抄一个值凑成一条记录;本文的手填步骤针对一个对端。

  1. 选择协议

    打开 Home →「+」→ Add Server → Type → WireGuard。先确认协议类型,再填写参数,避免将 WireGuard 端口录入其他协议的记录。

  2. 填写对端

    从同一个 [Peer] 读取 Endpoint 和 PublicKey。将主机和 UDP 端口填入服务器地址与端口位置,再填对端公钥。若 Endpoint 使用域名,保留配置中的域名,不把一次解析得到的 IP 当成固定值。

  3. 填写本机

    把 [Interface] 的 PrivateKey 填入私钥字段,把隧道内 Address 填入客户端 IP 对应位置。若配置给了 IPv4 和 IPv6 地址,按字段分开录入,不把整行配置粘贴进单个输入框。

  4. 核对可选项

    按原配置核对 MTU、PersistentKeepalive 和预共享密钥。没有提供的值不要从网上随意补齐。若原配置带有 AllowedIPs,尤其是只列出少数网段时,先确认预期访问范围;它属于 WireGuard 的对端配置,不等于 Shadowrocket 的 Config 规则。

  5. 保存并验证

    保存后回到 Home,选中刚添加的记录并开启连接。用一个本应交给该对端的目标发起实际请求。只看到系统 VPN 标识,说明系统启用了 VPN,不等于 WireGuard 已与对端完成握手。

Global Routing:区分连接故障与规则未命中

先确认测试目标实际经过 WireGuard。AllowedIPs 用于 WireGuard 的对端地址匹配及接收校验;Home → Global Routing 则决定 Shadowrocket 是否把请求交给代理。两层设置不能相互代替。若服务端只访问特定私网,测试目标也应选该私网内已知可用的服务,而不是任选一个公网网站。

Config

推荐

按当前配置文件的规则处理请求。检查目标是否命中预期规则,并确认该规则的出站策略最终选中了这条 WireGuard 记录。若请求命中 DIRECT,访问成功也不能证明 WireGuard 可用。

适合:已确认规则走向后的日常使用和复测。

Proxy

临时把由 Shadowrocket 接管的测试请求交给当前所选代理,排除 Config 规则的影响。先记下原来的选项,测试完成后恢复。如果相同目标在 Proxy 下可用、切回 Config 后不可用,优先核对规则及其出站策略。

适合:短时验证同一目标是否因规则走了不同出站。

握手、MTU 与 Keepalive 常见问题

排查时保持同一网络、同一记录和同一测试目标,每次只改一项。先查能否与对端通信,再看域名解析、数据传输大小和空闲后的恢复情况。不同阶段的故障不适合用同一个参数处理。

连接开关打开了,为什么对端还是没有握手记录?

先发起一个确实会经过该对端的请求,再核对 Endpoint 的主机和 UDP 端口。请对端管理员确认当前设备的公钥已登记,并核对客户端填写的对端公钥和可选预共享密钥。如果仅在某个 Wi-Fi 下失败,用同一记录在另一已授权网络复测,区分配置问题与该网络的 UDP 可达性问题。不要先调 MTU 或 Keepalive。

能访问已知 IP 的服务,域名却打不开,先查什么?

先核对配置指定的 DNS 服务器是否在当前路由下可达,以及目标是否需要私有 DNS 才能解析。使用已知支持按 IP 访问的服务进行对照;不要直接拿 HTTPS 网站的 IP 替换域名测试,因为证书和站点识别也可能因此失败。

小请求正常,大页面或文件传输卡住,要改 MTU 吗?

在同一网络、同一出站下复现“小请求成功、较大传输反复停滞”,再检查路径 MTU。若原值是 1420,可记录原值后单独试用较小的 1380,重新连接并复测同一个资源;没有改善就恢复原值。这里的两个数值仅用于说明对照方法,不是所有网络的固定配置。

刚连时能访问,空闲一段时间后才断,要开 Keepalive 吗?

先确认问题发生在同一网络、连接仍开启时,而不是切换 Wi-Fi 或系统断开 VPN 之后。如果初次握手和持续传输都正常,仅空闲后出现回包失败,可按配置提供方建议试用 25 秒,在相同空闲时长后复测。Keepalive 会定期发包;没有这类问题且配置未要求时,不必为它增加后台流量。

获取 Shadowrocket 与配置教程

iPhone / iPad 版在 App Store 获取,$2.99 一次性付费,系统要求以 App Store 页面标注为准。Mac(Apple 芯片 / Intel)/ Windows / 安卓 / Linux 版免费,安装包从本站下载页获取。

下载 Shadowrocket