Shadowrocket WireGuard 配置:PrivateKey、PublicKey 与 AllowedIPs 参数含义

逐项解释 WireGuard 在 Shadowrocket 中的字段:密钥对、Address、DNS、MTU、AllowedIPs 与 Endpoint,以及常见填错位置。

本文速览

本文适用于已经持有自己服务商提供的 WireGuard 配置、需要在 Shadowrocket 中核对参数的用户。先区分本机身份与远端身份,再检查隧道地址、目标网段和 UDP 端点,最后用 Global Routing 区分协议连接问题与规则选择问题。示例地址只用于解释字段,不能直接连接。

一、先分清 [Interface] 与 [Peer]

WireGuard 配置通常分为 [Interface] 和 [Peer] 两部分。前者描述本机隧道接口,后者描述通信对端。把配置录入 Shadowrocket 时,应按字段含义对应,而不是按复制顺序填写。以下界面操作以 iPhone / iPad 为例;其他平台的字段排列可能不同。

PrivateKey 属于本机;[Peer] 内的 PublicKey 属于远端。服务端也要登记本机对应的公钥,并为本机分配正确的地址。只有客户端本地填完字段,不代表服务端已经完成配对。

32 字节
WireGuard 原始私钥、公钥各自的长度
UDP
WireGuard 外层传输使用的协议
51820
本文示例端口,实际以已有配置为准

WireGuard 的私钥、公钥和可选预共享密钥通常以 Base64 文本表示,标准编码为 44 个字符,常以 = 结尾。长度相同不代表用途相同,也不能据此证明密钥有效。不要把这些字段当作密码、订阅地址或证书内容。

二、PrivateKey、PublicKey 与 PresharedKey 的对应关系

本机身份

PrivateKey
本机私钥,保留在本机配置中,不发送给排查人员。
本机 PublicKey
由本机 PrivateKey 派生,供服务端登记本机身份。
Address
服务端分配给本机的隧道地址,不是公网服务器地址。

更换本机 PrivateKey 后,服务端登记的本机公钥也要同步更换。

远端身份

[Peer] PublicKey
远端公钥,用于识别本机要连接的对端。
PresharedKey
可选的额外共享密钥;启用时两端必须一致。
Endpoint
远端可到达的地址和 UDP 端口。

已有配置没有 PresharedKey 时,不要自行生成一个填入。

最常见的填错方式,是把本机公钥填到远端 PublicKey,或把远端公钥当成本机 PrivateKey。这两类错误可能仍满足文本格式检查,但无法建立正确的加密会话。核对时应同时确认“这把密钥属于哪一端”和“它是公钥还是私钥”。

不要公开完整 WireGuard 配置。PrivateKey 与 PresharedKey 都属于敏感信息。需要提交问题时,保留字段名、错误提示及网络现象,删除密钥内容;若私钥已经泄露,应更换密钥并让服务端更新对应公钥。

三、Address、DNS 与 MTU 分别影响什么

Address 是隧道内部的本机地址,通常带有 CIDR 前缀,例如 10.66.0.2/32。它不是当前 Wi-Fi 的局域网地址,也不是 Endpoint。不要因为设备切换了 Wi-Fi,就把这个地址改成新的局域网地址。

字段示例或单位核对要点
Address10.66.0.2/32使用已分配地址;前缀长度不要自行扩大。
DNSDNS 服务器 IP 地址确认解析器可达,并核对 Shadowrocket 当前 DNS 设置。
MTU字节,例如 1420限制隧道内层 IP 包大小,不是连接速度。

DNS 和 Address 都不是 WireGuard 握手报文本身的身份字段。常见配置文件中的这些项目由客户端或配置工具处理。将文件内容映射到 Shadowrocket 时,不能假定文件中的每一项都会自动覆盖应用的全局设置;应同时核对 Settings → DNS 中实际使用的解析设置。

MTU 设得过大时,可能出现小请求有响应、较大传输停滞的现象,但同一现象也可能来自其他网络问题。外层为 IPv4 时,典型 WireGuard 封装开销为 60 字节;外层为 IPv6 时为 80 字节。在底层 MTU 为 1500 的条件下,1420 是兼顾 IPv6 外层的常见起点,并不适用于所有链路。

四、AllowedIPs 不等于 Global Routing

AllowedIPs 在 WireGuard 中参与对端与 IP 前缀的对应:发送时用于选择承载目标地址的对端,接收时用于验证解密后数据包的源地址。传统隧道工具还可能据此安装系统路由;Shadowrocket 作为规则代理客户端,还存在独立的流量选择层。

因此,AllowedIPs = 0.0.0.0/0, ::/0 表示对端覆盖 IPv4 和 IPv6 地址范围,不等于设备的所有请求已经被 Shadowrocket 选中并送往该对端。还需要检查连接开关、当前选中的连接、Global Routing 以及配置规则所使用的策略。

# 字段解释片段,不是可直接导入的完整连接配置。
# 以下地址是文档示例,不提供连接服务。
[Interface]
Address = 10.66.0.2/32
MTU = 1420

[Peer]
Endpoint = 192.0.2.10:51820
AllowedIPs = 0.0.0.0/0, ::/0
PersistentKeepalive = 25

片段特意省去了密钥。0.0.0.0/0 只覆盖 IPv4;::/0 覆盖 IPv6。若只写 10.66.0.0/24,其含义是这个对端只对应该网段,不能据此期待它承载任意公网目标。是否配置 IPv6,还应以服务端支持和现有分配为准。

这些是 [Rule] 段的规则,不应粘贴进 AllowedIPs。规则按顺序匹配,前面的 DIRECT 规则已经命中时,后面的代理策略不会再接管该请求。

五、Endpoint 与 PersistentKeepalive 的填写边界

Endpoint 是本机首先需要通过当前网络访问的远端地址。它可以是 IP 地址或主机名,加上端口。标准配置中的写法为 192.0.2.10:51820;如果编辑界面将地址与端口分开,就分别填写,不要将整串内容重复放入两个字段。

  1. 地址字段不加 https://,不附带网页路径,也不粘贴订阅查询参数。
  2. 标准配置中 IPv6 端点应使用方括号,例如 [2001:db8::10]:51820,避免把地址中的冒号误认为端口分隔符。
  3. 确认远端监听的是配置指定的 UDP 端口。TCP 端口探测成功,不能证明同号 UDP 端口可达。
  4. 使用主机名时,先确认连接建立前就能解析它,避免依赖尚未建立的隧道内 DNS。

PersistentKeepalive 的单位为秒,用于按需发送保活数据以维持 NAT 或防火墙状态。25 是常见配置值,不是必须值;未设置或设置为 0 通常表示关闭周期保活。它不是连接超时,也不能修复错误的公钥或服务端未放行的端口。

切换 Wi-Fi 与蜂窝网络后才出现中断时,应记录切换时刻、能否重新建立连接及 UDP 可达性,再判断是否需要保活。不要用不断缩短保活间隔代替身份与端点检查。

六、在 Shadowrocket 中录入与分层验证

以下步骤以已有有效配置为前提。本站不提供、不销售、不推荐节点或订阅。若参数来自自己的订阅,先核对服务商提供的原始信息;订阅更新可能重新写入连接字段,因此排查前应记录当前值,避免手动修改被下一次更新覆盖。

  1. 选定协议

    进入 Home →「+」→ Type → WireGuard。已有连接则从 Home 打开对应项目编辑,先确认 Type,不把其他协议的密码或标识填入 WireGuard 密钥字段。

  2. 核对身份

    按本机与远端的对应关系填写 PrivateKey、远端 PublicKey,以及配置确实要求的 PresharedKey;同时确认服务端登记的是本机公钥。

  3. 核对地址

    检查 Address、Endpoint 与端口。若编辑界面没有单列原配置中的某项,先确认该项在当前客户端中的承载位置,不要填入含义相近但不同的字段。

  4. 临时测试

    保存并选中该连接,在 Home → Global Routing → Proxy 下测试同一个已知可访问目标,检查连接状态与日志,不把列表中的延迟结果当作完整业务验证。

  5. 恢复规则

    测试结束后回到 Home → Global Routing → Config,确认 Config 中启用的配置以及目标命中的策略。若自动重连干扰测试,同时检查 Settings → On Demand。

On Demand 控制符合条件时的自动连接行为,不替代 AllowedIPs 或 [Rule]。排查期间如果停用它,应记下原设置,完成测试后再恢复,避免把自动重连误判成手动开关未生效。

Config

推荐

按照当前配置规则决定流量处理方式。规则可能选择 DIRECT,也可能选择使用 WireGuard 的策略;并不是所有未匹配请求都会自动走代理,最终行为取决于 FINAL。

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

Proxy

以代理姿态处理流量,可用于减少规则分流对测试的影响。当前选择仍须指向待测连接,且不会绕过系统流量范围、远端权限或 WireGuard 参数约束。

适合:临时判断故障是否与规则选择有关。

Direct

以直连姿态处理流量,可作为本地网络的对照条件。此时目标可以访问,不能证明 WireGuard 配置正确,因为测试可能没有经过该连接。

适合:确认目标在当前本地网络下的直连表现。

七、按现象缩小问题范围

不要仅凭“连接开关已打开”判断 WireGuard 已完成握手。开关表示客户端连接状态,远端身份匹配、UDP 往返和具体目标的数据传输仍需分别验证。以下是排查顺序,不是仅凭单一现象就能确定的故障结论。

观察到的现象优先核对下一步
无法建立有效通信两端公钥登记、PresharedKey、Endpoint、UDP 端口请自己的服务商核对服务端监听与对端登记状态。
指定 IP 可达,域名失败DNS 可达性与实际解析路径使用同一目标对照域名解析结果,避免比较不同服务。
小请求正常,大传输停滞路径 MTU、丢包及远端限制保留其余设置,仅调整 MTU 后重复同一项测试。
Proxy 正常,Config 异常当前配置、命中规则与策略选择检查目标是否被 DIRECT 或其他策略提前匹配。
订阅更新后参数变化更新前后的字段与服务端分配核对订阅源返回内容,不反复覆盖服务商已变更的参数。

向自己的服务商反馈时,提供系统平台、所用网络类型、发生条件、已核对的字段名和去敏后的错误记录。不要发送 PrivateKey 或 PresharedKey。若服务端确认更换了公钥、端口或地址分配,应同步更新对应字段,再从协议测试开始复查。

Shadowrocket 官方下载