Shadowrocket WireGuard 配置参数详解:PrivateKey、PublicKey、AllowedIPs 与 MTU

逐项解释在 Shadowrocket 中添加 WireGuard 时各参数的含义和填写来源,示例值全部为假值,并附常见填写错误的排查方法。

本文速览

WireGuard 配置首先要分清本机密钥、对端密钥、隧道地址和公网端点,再检查路由范围与 MTU。本文以已持有自己服务商配置或自管服务器资料的用户为前提,操作路径以 iPhone / iPad 上的 Shadowrocket(小火箭)为例;Mac / Windows / 安卓 / Linux 用户可按参数含义核对对应编辑页,不把移动端按钮位置直接套用到其他平台。读完可逐项检查配置来源,并区分握手、分流、DNS 与数据包大小问题。

一、先分清本机与对端,再填写参数

WireGuard 使用 UDP 传输,以密钥识别通信双方。它不是用户名与密码登录:本机持有自己的 PrivateKey,服务器登记与该私钥配对的本机 PublicKey;客户端的 Peer 则填写服务器的 PublicKey。双方的 PublicKey 不能因为名字相同就互换。

参数归属:本机 Interface 与远端 Peer

本机 Interface
  • PrivateKey:本机私钥,只保留在需要使用它的受信任设备上。
  • Address:分配给本机的隧道内部地址,不是服务器公网地址。
  • MTU:隧道接口的数据包大小上限,按配置与实际路径调整。
  • 本机 PublicKey:由本机私钥派生,交给服务器端登记。
远端 Peer
  • PublicKey:服务器的公钥,由服务器管理方提供。
  • Endpoint:服务器可访问的域名或 IP 与 UDP 端口。
  • AllowedIPs:这个 Peer 对应的 IP 前缀范围。
  • PresharedKey:双方约定的可选附加密钥,不能自行补一个值。

核对时始终问清“这是哪一端的参数”,不能把服务器配置文件中的 PrivateKey 直接当作客户端私钥。

如果服务方给的是完整客户端配置,应使用其中配套的密钥与 Address。若改为在本机重新生成密钥,必须同步更新服务器上登记的客户端 PublicKey;只修改手机里的 PrivateKey,会破坏原有配对。不要将完整配置截图或私钥粘贴到公开讨论区。

二、PrivateKey、PublicKey 与地址字段逐项对照

下面使用 WireGuard 配置文件的标准字段名解释含义,不代表每个平台的 Shadowrocket 编辑页都会原样显示所有字段。编辑页可能把 Endpoint 分成地址与端口,也可能把本地 IPv4、IPv6 分开填写;应按含义映射,不能仅凭字段排列顺序复制。

字段填写来源与含义常见错误
PrivateKey本机生成并完成服务器登记的配套私钥,或服务方分配的客户端私钥。填入服务器私钥、漏掉尾部字符,或复制时混入空格与换行。
PublicKeyPeer 中填写服务器公钥;服务器端另行登记客户端公钥。把客户端自己的公钥填进远端 Peer。
PresharedKey可选的预共享密钥;启用时两端必须完全一致。服务端未启用却自行填写,或误用 PrivateKey。
Address分配给本机的隧道地址与前缀,例如演示地址 192.0.2.2/32。使用服务器公网 IP,或把其他设备的内部地址直接复用。
Endpoint服务器公网地址与实际 UDP 端口,例如 example.com:51820。加入网页协议前缀,或认为所有服务器端口都是 51820。
DNS若配置包含此项,它是配套工具约定的 DNS 设置,不属于 WireGuard 握手本身。把 DNS 地址当作 Address,或只改此项就认定应用 DNS 已全部生效。

WireGuard 的 PrivateKey、PublicKey 和 PresharedKey 通常是 32 字节数据的 Base64 表示,常见文本长度为 44 个字符。但长度正确不等于密钥正确,也不等于两端已经配对。应逐字符核对原始资料,而不是补字符凑长度。

32 字节
WireGuard 密钥的原始长度
51820
本文演示 UDP 端口,并非必填固定值
2 组前缀
IPv4 与 IPv6 默认范围需分别考虑

三、在 Home 添加 WireGuard 并做首次验证

准备好本机 PrivateKey、分配的地址、远端 PublicKey、Endpoint,以及服务方要求的其他字段后,再进入编辑流程。Home 管理连接条目,Config 管理规则配置文件;把规则文件导入 Config,不等于已经创建了可用的 WireGuard 条目。

  1. 整理资料

    将原始配置保存在受保护的位置,分别标明本机与远端参数。记录原有 Global Routing 状态;若已有可用条目,保留它,不直接覆盖。

  2. 选择类型

    打开 Home → 右上角“+”→ Type → WireGuard。以下按字段含义填写;不同平台、界面布局中的可编辑项以实际显示为准。

  3. 填入参数

    将 Endpoint 对应到服务器地址与端口,将本机 PrivateKey、本地地址、远端 PublicKey 填到各自项目。只有原配置要求 PresharedKey 时才填写它。

  4. 保存并选择

    保存后回到 Home,选中刚创建的 WireGuard 条目。为减少规则干扰,可暂时将 Home → Global Routing 设为 Proxy,然后开启连接;系统若请求添加 VPN 配置,按系统提示确认。

  5. 分层验证

    先访问已知可用的目标,再观察是否有持续的数据收发。有服务器管理权限时核对最近握手与收发计数;验证完毕后,将 Global Routing 恢复为日常使用的状态。

四、AllowedIPs 与 Global Routing 不是同一层规则

AllowedIPs 是 WireGuard 的 IP 前缀集合:发送方向用于把目标地址关联到 Peer,接收方向用于校验解密后数据包的源地址是否属于该 Peer。它不接受域名规则,不能把 DOMAIN-SUFFIX,example.com,PROXY 填进去。

Shadowrocket 的 Global Routing 决定流量在应用分流层如何处理。即便 WireGuard 端的 AllowedIPs 覆盖了所有地址,也不会让 Global Routing 中选择直连的流量自动改走该条目。反过来,选择 Proxy 也不能修复服务器缺少转发路由的问题。

Config:按配置核对

推荐

按当前 Config 的规则与策略处理流量。检查 DOMAIN-SUFFIX、GEOIP、IP-CIDR 与 FINAL 的顺序和目标策略,确认需要的请求确实被交给 WireGuard 条目或包含它的策略组。

适合:连接验证完成后的日常规则分流。

Proxy:减少分流变量

在全局路由层选择代理路径,用于隔离 Config 规则造成的差异。仍须核对当前选中的条目、隧道范围与服务器可达性,不能理解为任何系统流量都必然进入远端。

适合:短时检查故障是否来自规则分流。

Direct:直连对照

在全局路由层选择直连路径。它可用于对照本地网络是否能访问同一目标,但直连成功不表示 WireGuard 配置正确。

适合:区分目标本身不可达与隧道路径故障。

若当前使用 Scene,应先核对场景实际采用的路由行为,再做对照测试。Settings → On Demand 管理按需连接条件,它不是 AllowedIPs,也不负责把某个域名写成代理规则;排查期间应记录其状态,避免自动连接条件干扰手动测试。

五、MTU 与 Keepalive:按现象调整,不套用固定值

MTU 控制隧道接口可承载的 IP 数据包大小。外层网络还要承载 WireGuard、UDP 与 IP 头部,因此隧道 MTU 不能简单照抄物理接口的数值。1420 是常见起点,但外层 IPv4 / IPv6、移动网络和其他封装都会影响实际可用大小。

观察到的现象优先核对调整方式
完全没有握手Endpoint、UDP 放行、密钥配对、PresharedKey先修正身份和可达性;MTU 通常不是首要检查项。
小请求成功,大页面或上传停滞路径 MTU、丢包与服务端转发记录原值,在编辑页支持时尝试从 1420 调低到 1380,再用同一目标重复测试。
闲置后恢复访问较慢NAT 映射超时、网络切换、服务器状态若双方配置条件允许,可评估 PersistentKeepalive,而不是不断重建密钥。
只有域名访问失败DNS 服务器可达性、解析结果与 DNS 路径区分解析失败和连接失败,不先改 MTU 或 PublicKey。

PersistentKeepalive = 25 表示在需要时以 25 秒间隔发送保活包,是处于 NAT 后客户端的一种常用设置,不是每条连接都必须开启的要求。它有助于维持映射,但会增加后台网络活动,不能解决端口被阻断或密钥错误。

每轮只改一个变量,并记录网络类型、原值、新值和复现步骤。若调低 MTU 后没有稳定改善,应恢复原值并继续检查;不要把一次网页加载成功当成通用结论。

六、演示配置的阅读方法与常见问题

下面是用于说明字段位置的标准 WireGuard 风格文本,不是 Shadowrocket 各平台的通用导入承诺。所有值均为演示假值;密钥刻意使用无效文本,域名与文档地址也不提供真实服务。它不能建立连接,不能直接保存为可用配置。

[Interface]
PrivateKey = DEMO_PRIVATE_KEY_NOT_VALID
Address = 192.0.2.2/32
MTU = 1420

[Peer]
PublicKey = DEMO_SERVER_PUBLIC_KEY_NOT_VALID
PresharedKey = DEMO_PRESHARED_KEY_NOT_VALID
Endpoint = example.com:51820
AllowedIPs = 0.0.0.0/0, ::/0
PersistentKeepalive = 25

实际填写时按自己的原始资料逐项核对。服务方没有提供 PresharedKey 就不要照抄演示行;没有分配 IPv6 地址或提供 IPv6 转发时,也不要因为演示里有 ::/0 就自行启用。MTU 与保活值同样需要按实际网络验证。

PublicKey 复制正确,为什么还是没有握手?

先确认它是服务器公钥,再让服务器管理方核对该 Peer 登记的是当前客户端公钥。随后检查 Endpoint 的实际 UDP 端口与 PresharedKey;格式无误只能排除输入格式错误,不能证明双方匹配。

能握手但网页打不开,下一步查什么?

先在 Home 确认选中的 WireGuard 条目,并以 Global Routing → Proxy 做短时对照。仍失败时检查服务端 IP 转发、出口路由与防火墙;仅域名失败再核对 DNS,只有大请求异常时再检查 MTU。

手机和电脑能直接复制同一份配置吗?

先核对服务方是否为每台设备分配独立 Peer。多台设备同时复用同一私钥和隧道地址可能导致远端端点来回变化;需要并行使用时,应分别登记设备公钥并分配地址,再各自填写配置。

订阅更新后参数变了,要手动改回去吗?

先确认条目是否由自己的订阅管理。更新可能重新写入服务端下发的参数;手动条目和订阅条目应分开辨认。向自己的服务方确认变更原因,再决定保留手动配置还是继续使用订阅维护的条目。

获取 Shadowrocket 与继续设置

iPhone / iPad 版在 App Store $2.99 一次性付费,系统要求以 App Store 页面标注为准;Mac(Apple 芯片 / Intel)/ Windows / 安卓 / Linux 版免费。到全平台下载页选择设备,再按教程完成基础设置;WireGuard 所需的服务资料由用户自行准备。

下载 Shadowrocket