手动填写 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 对应的字段。
| 字段 | 示例值 | 填写位置与核对方法 |
|---|---|---|
Address | 10.20.30.2/32 | 隧道内的本机 IPv4 地址。若同时分配了 IPv6,按界面对应字段分别填写。使用配置给出的前缀,不自行把 /32 改成 /24。 |
Endpoint | 198.51.100.20:51820 | 对端的 IP 或主机名,加 UDP 端口。界面若分列主机和端口,就分别填写 198.51.100.20 与 51820,不加 https://。 |
MTU | 1420 | 隧道接口可承载的最大内层 IP 包大小,单位为字节。外层 IP、UDP 和 WireGuard 封装还会占用传输空间,适用值取决于实际路径。 |
PersistentKeepalive | 25 | 对应应用内的 Keepalive 设置,单位为秒。用于在没有业务流量时维持 NAT 或防火墙的 UDP 状态,不是握手超时,也不是延迟测试频率。 |
表内数值只用于说明格式;示例 Endpoint 使用文档保留地址,不能用于连接。实际录入以自己的配置为准,尤其不要把示例端口当成协议要求。
Shadowrocket 手动添加 WireGuard
先准备当前设备的客户端配置。它如果同时列出多个 [Peer],不能从不同段落各抄一个值凑成一条记录;本文的手填步骤针对一个对端。
选择协议
打开 Home →「+」→ Add Server → Type → WireGuard。先确认协议类型,再填写参数,避免将 WireGuard 端口录入其他协议的记录。
填写对端
从同一个
[Peer]读取Endpoint和PublicKey。将主机和 UDP 端口填入服务器地址与端口位置,再填对端公钥。若Endpoint使用域名,保留配置中的域名,不把一次解析得到的 IP 当成固定值。填写本机
把
[Interface]的PrivateKey填入私钥字段,把隧道内Address填入客户端 IP 对应位置。若配置给了 IPv4 和 IPv6 地址,按字段分开录入,不把整行配置粘贴进单个输入框。核对可选项
按原配置核对
MTU、PersistentKeepalive和预共享密钥。没有提供的值不要从网上随意补齐。若原配置带有AllowedIPs,尤其是只列出少数网段时,先确认预期访问范围;它属于 WireGuard 的对端配置,不等于 Shadowrocket 的Config规则。保存并验证
保存后回到 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 会定期发包;没有这类问题且配置未要求时,不必为它增加后台流量。