Shadowrocket WireGuard 配置参数详解:Private Key、Peer、Allowed IPs 与 MTU

逐项解释 WireGuard 节点在 Shadowrocket 里的字段:本端私钥与地址、Peer 公钥与 Endpoint、Allowed IPs 的取值,以及 MTU 填错时的表现。

本文速览

本文适合已经从自己的服务商处取得 WireGuard 配置、准备在 Shadowrocket 中逐项核对参数的用户。先区分本端身份、隧道地址与远端 Peer,再说明 Allowed IPs 和应用规则的边界,最后按握手、小流量、大流量的顺序排查 MTU。示例地址只用于解释字段,不能作为可连接的服务器使用。

一、先区分本端 Interface 与远端 Peer

Shadowrocket(小火箭)中的 WireGuard 配置不能按“服务器地址加密码”的方式理解。WireGuard 用公钥识别通信对端:本端保存自己的 Private Key,并把对应的 Public Key 登记到远端;本端的 Peer 则填写远端 Public Key。两边的密钥关系必须相互对应,单独获得一个服务器地址并不足以建立有效隧道。

标准 WireGuard 配置文件通常分为 [Interface] 与 [Peer]。前者描述本端身份、隧道内地址等参数,后者描述通信对端及允许通过该对端传输的地址范围。Shadowrocket 的节点表单可能把这些字段拆成多个输入项,核对时应按含义映射,不要把完整文件直接粘进某一个密钥栏。

32 字节
WireGuard 公钥与私钥各自的原始长度,配置通常使用 Base64 表示
UDP
WireGuard 的外层传输协议,不以 TCP 连接成功作为握手依据
51820
常见示例端口,并非所有服务的固定端口

二、Private Key、Address 与 Peer 各填什么

Private Key 是本端私钥,不是远端密码。它与本端 Public Key 成对。若替换了本端私钥,却没有让远端同步登记新的本端公钥,远端便无法按原有身份接受通信。不要为了“重新试一次”随意生成或替换密钥;应先核对服务商提供的配置是否完整、是否仍对应当前设备。

Address 是隧道内地址,不是 Endpoint。例如 10.66.66.2/32 表示本端在隧道中的 IPv4 地址及前缀。不要把服务器公网 IP、当前 Wi-Fi 地址或目标网站地址填进这里。如果服务商给出 IPv4 和 IPv6 两个地址,应按表单支持的输入方式分别填写,不能自行推导一个未分配的地址。

本端 Interface

Private Key
填写服务商配置中的本端私钥,保留 Base64 字符与末尾填充字符
Address
例如 10.66.66.2/32,仅作隧道地址格式示例
MTU
控制隧道接口允许的 IP 包大小,优先沿用配置值
DNS
若原始配置包含此项,需另核对 Shadowrocket 的 DNS 设置是否承接

Address、DNS 和 MTU 是配置层参数,不是用来替代密钥认证的信息。

远端 Peer

Public Key
填写远端公钥,不是本端公钥,也不是任何一方的私钥
Endpoint
例如 192.0.2.10:51820,地址与端口均为教学值
Allowed IPs
例如 0.0.0.0/0,具体范围依服务商配置与用途确定
Preshared Key
可选附加共享密钥;远端启用时,两端必须一致

原始文件中的紧凑写法如 PublicKey、AllowedIPs,对应这里按含义列出的字段。

Preshared Key 与 Private Key 不是同一项。前者是双方约定的附加共享秘密,后者只属于本端身份。原始配置没有提供 Preshared Key 时,不应自己填一个随机字符串。密钥的长度和外观相似,也不能说明字段可以互换。

三、Endpoint 的地址、端口与 UDP 条件

Endpoint 指向建立 WireGuard 通信的外层网络目的地。若表单将其拆为 Address 或 Server 与 Port,地址栏仅填主机名或 IP,端口栏填服务商给出的数字;不要添加 https:// 或网页路径。原始文件使用 IPv6 Endpoint 时,常见组合格式为 [2001:db8::10]:51820,方括号用于区分地址中的冒号与端口分隔符。

Persistent Keepalive 用于定期发送保活包,帮助维持 NAT 映射。配置中的 PersistentKeepalive = 25 表示以 25 秒为间隔的常见设置示例,不是所有网络必须使用的数值。它不能修复错误的 Public Key、未开放的远端端口或失效的账户权限。

四、Allowed IPs 不等于 Global Routing 分流规则

在 WireGuard 语义中,Allowed IPs 参与选择用于发送目标地址流量的 Peer,同时约束从该 Peer 接收的内层源地址。0.0.0.0/0 覆盖 IPv4 全部地址,::/0 覆盖 IPv6 全部地址;只填写前者并不自动覆盖后者。若服务商只给出一个私网网段,通常意味着该配置用于访问特定内网,不能自行扩大后就认为远端能够转发整个互联网。

Shadowrocket 还存在另一层决策:Global Routing 与 Config 规则先决定流量是否交给这个节点。即使 Peer 的 Allowed IPs 包含默认路由,命中 DIRECT 的流量也不会因此自动改走该节点。反过来,应用规则把目标交给 WireGuard,也不代表远端已经配置好相应的转发、路由和出口。

设置层级具体示例解决的问题
Peer 的 Allowed IPs10.20.0.0/16指定该 Peer 对应的内层地址范围,不是域名规则
Peer 的默认路由范围0.0.0.0/0, ::/0覆盖两种 IP 地址族,仍需远端具备相应转发能力
Config 的域名规则DOMAIN-SUFFIX,example.com,DIRECT决定匹配域名的流量使用 DIRECT 策略
Config 的地址规则IP-CIDR,192.0.2.0/24,DIRECT按目标 IPv4 网段选择策略,不修改 Peer 密钥

Global Routing 中的 Proxy 用于代理路由,Direct 用于直连,Config 依据当前配置规则,Scene 按已配置的场景工作。排查时先记录当前姿态;若在 Direct 下测试外部网站,结果不能用于证明 WireGuard 节点已经可用。使用 Config 时,应核对测试目标实际命中的规则与策略。

五、在 Shadowrocket 中按顺序录入与验证

以下按 iPhone / iPad 的 Home 节点编辑流程说明。先保留服务商原始配置与当前可用配置,逐项录入;界面字段的排列可能变化,但本端与 Peer 的对应关系不变。若已有订阅导入的 WireGuard 节点,优先进入节点编辑页核对,不要重复创建多个名称相似、参数不同的节点。

  1. 准备参数

    从你的服务商处获取配置,分清 Interface 与 Peer,记录 Endpoint、端口、Address、Allowed IPs 和 MTU,密钥不抄进公开笔记。

  2. 选择协议

    Home → 右上角「+」→ Type → WireGuard。按表单区分本端参数与 Peer 参数,不把整份配置粘到 Private Key。

  3. 逐项录入

    录入本端 Private Key 与 Address,再录入 Peer 的 Public Key、Endpoint 对应地址和端口;其余选项按原始配置填写后保存。

  4. 选定节点

    返回 Home,点选该服务器左侧圆点,检查 Global Routing。需要排除规则影响时,可短时切至 Proxy 验证,完成后恢复原有姿态。

  5. 验证流量

    打开连接开关;首次提示添加 VPN 配置时按系统提示操作。运行 Connectivity Test,再验证一个小网页和一个较大传输,分别记录结果。

Connectivity Test 的成功仅能说明所选测试方法对应的连通情况,不能代替隧道内业务验证。系统显示 VPN 已连接也不等于远端已完成有效握手。若界面或可用日志提供握手时间、发送量与接收量,可结合观察;不应把只有发送计数增长理解为双向通信已经正常。

六、MTU 填错的表现与单变量调整方法

MTU 限制隧道接口中的 IP 包大小,单位是字节。WireGuard 在内层 IP 包外增加加密与 UDP/IP 封装,外层路径还可能经过其他隧道,所以不能直接照搬物理网卡常见的 1500。1420 是常见配置值,不是任何网络下都正确的答案;实际可用值取决于外层地址族与路径承载能力。

典型的 MTU 或路径 MTU 发现异常现象是:握手与少量数据似乎正常,小网页能打开,但较大的响应、上传或持续传输停住。此现象也可能来自丢包、DNS、远端限制或应用超时,因此只能作为排查线索。若连握手都没有建立,优先检查密钥、Endpoint 与 UDP,而不是先改 MTU。

沿用配置 MTU

推荐

先使用服务商明确给出的数值,保留一个可比较的基线。原始配置未指定时,先保留客户端默认行为,不凭网络速度猜值。

适合:首次录入、尚未确认存在大包传输问题

降低 MTU 对照

若原值为 1420,可在保持其他参数不变的前提下,用 1380、1280 作分次诊断对照。每次保存并重新连接,不能把测试值直接视为最终最佳值。

适合:小流量正常、较大传输反复停滞的情况

提高 MTU

只有在路径条件与测试结果支持时再考虑。数值更大不等于速度更快,超过可承载范围反而可能导致分片、丢包或连接等待。

适合:已有稳定基线,并能控制测试条件的进阶调试

七、按故障阶段定位,不把所有问题归为密钥错误

排查应从外到内:先确认 Endpoint 可解析且配置正确,再确认 UDP 通信与身份参数,随后检查内层地址、路由、DNS 和应用分流。不要一次改五个字段;即使连接恢复,也无法知道真正有效的改动,还可能留下错误的地址范围或不必要的保活设置。

观察到的现象优先核对下一步
Endpoint 主机名无法解析主机名拼写、当前 DNS、网络接入先恢复名称解析,不改 Private Key
未见有效握手或双向流量UDP 端口、远端 Public Key、本端密钥登记、Preshared Key与服务商逐项核对,避免直接提交私钥
握手正常但目标不可达Address、Allowed IPs、远端转发、Global Routing 与规则确认目标地址确实由此节点承载
IP 访问正常但域名失败DNS 解析、DNS 请求的实际路由单独检查解析链路,不先重建 Peer
小请求正常,大传输停滞MTU、路径丢包、远端限制固定其他条件,逐次降低 MTU 作对照
订阅更新后恢复原参数节点是否由订阅管理向服务商确认源配置,区分订阅节点与手动节点

订阅更新可能重新应用服务商下发的节点参数。若为了诊断手动修改了某个字段,应记录修改内容,并确认后续刷新是否覆盖它。不能因为本地暂时改好,就忽略源配置中的错误;也不要为了保留一次测试值而长期停止必要的配置更新。

下载 Shadowrocket