Shadowrocket WireGuard 参数详解:Private Key、Public Key、Endpoint 与 MTU 怎么填

介绍 WireGuard 在 Shadowrocket 中的添加方式,逐项解释密钥、地址、Endpoint、DNS、MTU 等字段的含义,并说明服务商提供的配置如何对应填写。

本文速览

本文面向已经从自己的服务商处取得 WireGuard 配置的用户。先区分客户端密钥与服务端密钥,再把 Interface、Peer 中的地址、端口与 DNS 对应到 Shadowrocket,最后按握手、路由、域名解析和 MTU 的顺序排错。文中的地址仅用于说明格式,不能作为可连接的服务配置。

一、添加前先区分 Interface 与 Peer

Shadowrocket(小火箭)中的 WireGuard 连接需要一组相互对应的参数,不是只填一个服务器地址即可使用。常见的 WireGuard 配置文件包含 [Interface] 与 [Peer]:前者描述本机隧道接口,后者描述要连接的远端。拿到文件后,先按这两个区段分类,不要看到 Public Key 就直接复制到任意密钥输入框。

本文以 Home 中手动添加 WireGuard 为主。服务商如果提供的是 Subscribe 链接,应从你的服务商处获取,并按 Home → + → Type → Subscribe 导入;它和手动填写 WireGuard 参数是两条不同的配置路径。不要把订阅网址填到 Endpoint,也不要把一整段配置文本填入 Private Key。

2 个区段
Interface 描述本机,Peer 描述远端
32 字节
WireGuard 公钥与私钥各自的原始长度
UDP
Endpoint 对应的传输协议

密钥通常以 Base64 文本表示,标准编码常见长度为 44 个字符。长度只能用于发现明显的复制截断,不能证明密钥正确。WireGuard 不是以用户名、密码或 TLS 证书完成身份认证;服务端必须登记与本机 Private Key 配对的客户端 Public Key。

二、Private Key、Public Key 与 Preshared Key 怎么对应

Private Key 是本机身份的秘密材料;Peer 下的 Public Key 则用于识别远端。两者即使外观相近,也不能交换。若服务商页面另外展示“客户端 Public Key”,那是交给服务端登记的本机公钥,不是应填入远端 Public Key 的值。

配置字段填写含义常见错误
[Interface] PrivateKey填入客户端的 Private Key,完整保留 Base64 字符。复制成服务端私钥,或误用客户端公钥。
[Peer] PublicKey填入服务端的 Public Key。误填服务商页面上的客户端 Public Key。
[Peer] PresharedKey仅在服务商提供且服务端启用时填写附加共享密钥。服务端未配置却自行生成,或遗漏已要求的值。

复制密钥时不要带上 PrivateKey = 这样的字段名前缀,也不要加入引号、换行或尾随空格。如果配置来自二维码或导入文件,仍应确认它属于当前设备;多个设备复用同一组客户端身份可能导致服务端记录的 Endpoint 来回变化,表现为连接间歇中断。

三、Address、Endpoint 与 AllowedIPs 的区别

Address 是分配给客户端的隧道内地址,Endpoint 是客户端在公网或当前网络中实际联系的远端地址。它们回答的是不同问题:前者表示“隧道内本机使用哪个地址”,后者表示“加密 UDP 数据包发往哪里”。不要把 Endpoint 的公网 IP 填到本机 Address 中。

字段格式示例填写依据
Address10.66.0.2/32使用服务商为此客户端分配的地址与前缀,不自行选择。
Endpointvpn.example.com:51820包含服务端主机名或 IP,以及实际监听的 UDP 端口。
IPv6 Endpoint[2001:db8::10]:51820在单个 Endpoint 字符串中,IPv6 地址用方括号包裹。
AllowedIPs0.0.0.0/0, ::/0表示此 Peer 对应的 IPv4 与 IPv6 地址范围,不等于已经配置好应用层分流。

端口 51820 是常见示例,不是固定要求。服务商给出其他端口时必须照填,也不能因为某网络允许 TCP 443 就推断 UDP 443 一定可达。若编辑页把地址与端口分成两个输入框,应分别填主机名和数字端口,不把 :51820 一起放入地址框。

AllowedIPs 在 WireGuard 中参与 Peer 的地址选择及接收源地址约束;Shadowrocket 的 Global Routing 与 Config 则决定哪些请求送往所选代理。这两层不能混为一谈。配置出现 0.0.0.0/0 并不代表 Shadowrocket 中所有请求都已经绕过规则选择该连接。

四、在 Home 中添加并验证连接

先保留服务商提供的原始配置副本,再开始录入。下列路径以英文界面词说明;不同平台的字段排列可能不同,标准配置文件中的参数也不保证全部以同名输入框展示。某项未显示时应核对该平台的实际导入能力,不把它写进不相关字段。

  1. 选择类型

    进入 Home → + → Type → WireGuard,确认当前编辑的是 WireGuard,而不是 Subscribe 或其他协议类型。

  2. 填写身份

    按 Interface 的 PrivateKey 与 Peer 的 PublicKey 填写两端身份;服务商要求 Preshared Key 时一并填写。

  3. 填写地址

    把 Endpoint 的主机与端口对应到服务器地址、端口字段,再填服务商分配的本机隧道地址;DNS、MTU 按原配置处理。

  4. 保存并选择

    保存后回到 Home,选择刚添加的连接。检查 Home → Global Routing 的当前姿态,确认测试请求会使用该连接。

  5. 发起请求

    打开连接开关,按系统提示允许所需网络配置;访问一个已知可用的目标,并结合连接日志与收发流量检查,不只看开关是否亮起。

排查时可短暂使用 Global Routing → Proxy,减少 Config 规则造成的变量;这仍不意味着系统所有类型流量都必然被接管。验证后切回日常使用的 Config,并检查实际启用的配置。Direct 不会用所选代理转发请求,不能用于验证 WireGuard 的出口;Scene 则应按已配置的场景条件检查,不能当成固定的全局代理姿态。

五、DNS、MTU 与 PersistentKeepalive 怎么设

DNS 决定域名查询交给哪个解析器,MTU 约束隧道接口承载的数据包大小,PersistentKeepalive 用于维持部分 NAT 映射。三者互不替代:修改 DNS 不能修复错误的 Public Key,降低 MTU 也不能让无法到达的 UDP Endpoint 开始响应。

DNS:先确认解析路径

标准 WireGuard 配置中的 DNS 是常见客户端扩展,并非 WireGuard 握手协议本身的字段。导入后应检查它在 Shadowrocket 当前 Config 与 DNS 设置中的实际作用,不假定文件里的 DNS 一定覆盖所有查询。若配置指定了隧道内部 DNS 地址,该地址通常要在隧道建立后才可达。

MTU:先沿用,再做单变量测试

沿用服务商配置或默认值

推荐

服务商给出 MTU 时先照填;未给出时先使用客户端默认行为,建立可重复的测试基线。

适合:首次添加、连接后网页与下载均正常

手动降低 MTU

只有在小请求可用、大请求停顿等现象稳定复现时,才逐步降低,例如由 1420 测试到 1380,每次仅改这一项。

适合:疑似路径 MTU 或封装开销问题的定向排查

结论:记录现象后再保留修改

使用同一网络、同一目标比较修改前后的打开结果与传输是否中断;降低 MTU 后没有改善就恢复原值,不把 1380 或 1420 当成所有网络通用的答案。

MTU 的合适值取决于底层路径和额外封装。盲目调小可能增加数据包数量;握手都未建立时,通常应先查密钥和 Endpoint,而不是反复调整 MTU。

PersistentKeepalive:处理空闲后的可达性

PersistentKeepalive = 25 表示按 25 秒间隔发送保活包,是常见的 NAT 场景示例,不是必填值或性能参数。标准 WireGuard 配置中设为 0 表示关闭定时保活。若服务商给出该项且当前客户端入口支持配置,应按要求填写;界面未提供时不要用端口、MTU 等字段代替。

六、按现象排查,不把连接开关当作握手结果

WireGuard 的有效握手通常由待发送数据触发。Shadowrocket 的连接开关开启,首先说明本地连接流程已启动,不足以证明远端身份验证、DNS 与目标访问全部正常。应主动发起请求,再结合可见日志;如果服务商能提供服务端握手记录,也可核对同一时刻是否收到该客户端的数据。

现象优先检查下一步操作
发起请求后仍无有效响应密钥对应关系、Endpoint、UDP 可达性核对服务端 Public Key、客户端公钥登记与监听端口,再换网络复测。
有握手记录但业务不通Address、AllowedIPs、服务端转发确认分配地址及回程路由,并检查请求是否确实选择此连接。
部分域名不可用DNS 与 Config 规则对照解析结果及规则命中,确认不是 Direct 或其他策略接走请求。
小请求正常,大传输停顿路径 MTU、丢包与目标状态固定目标逐项测试 MTU,保留对照记录,不同时修改 DNS。
切换网络后短暂中断新网络 UDP、Endpoint 解析及 On Demand分别在 Wi-Fi 与蜂窝网络手动测试,区分网络限制和自动连接条件。

回到 Config 排查时,先确认当前启用的文件,再看 Rule 的先后顺序。DOMAIN-SUFFIX 匹配域名后缀,IP-CIDR 匹配地址范围,GEOIP 依据地址地理信息匹配,FINAL 负责前面没有命中的请求;命中后执行对应策略。规则把请求送往 Direct 时,修改 WireGuard 密钥不会改变这次请求的出口。

七、保存配置与后续使用

首次验证完成后,保留一份受保护的原始配置,并记录当前使用的 Global Routing 姿态和有效 MTU。以后更换网络、更新订阅或调整 Config,出现异常时便可回到这组已知条件复测,而不是重新随机填写参数。服务商更换服务端 Public Key 或分配地址时,也应整体核对相关字段。

Shadowrocket 下载与首次设置

iPhone / iPad 版 App Store $2.99 一次性付费,Mac(Apple 芯片与 Intel)/ Windows / 安卓 / Linux 版免费。客户端买断 ≠ 线路套餐;订阅从你的服务商处获取。

下载 Shadowrocket