本文适用于已经持有自己服务商提供的 WireGuard 配置、需要在 Shadowrocket 中核对参数的用户。先区分本机身份与远端身份,再检查隧道地址、目标网段和 UDP 端点,最后用 Global Routing 区分协议连接问题与规则选择问题。示例地址只用于解释字段,不能直接连接。
一、先分清 [Interface] 与 [Peer]
WireGuard 配置通常分为 [Interface] 和 [Peer] 两部分。前者描述本机隧道接口,后者描述通信对端。把配置录入 Shadowrocket 时,应按字段含义对应,而不是按复制顺序填写。以下界面操作以 iPhone / iPad 为例;其他平台的字段排列可能不同。
PrivateKey 属于本机;[Peer] 内的 PublicKey 属于远端。服务端也要登记本机对应的公钥,并为本机分配正确的地址。只有客户端本地填完字段,不代表服务端已经完成配对。
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,就把这个地址改成新的局域网地址。
| 字段 | 示例或单位 | 核对要点 |
|---|---|---|
| Address | 10.66.0.2/32 | 使用已分配地址;前缀长度不要自行扩大。 |
| DNS | DNS 服务器 IP 地址 | 确认解析器可达,并核对 Shadowrocket 当前 DNS 设置。 |
| MTU | 字节,例如 1420 | 限制隧道内层 IP 包大小,不是连接速度。 |
DNS 和 Address 都不是 WireGuard 握手报文本身的身份字段。常见配置文件中的这些项目由客户端或配置工具处理。将文件内容映射到 Shadowrocket 时,不能假定文件中的每一项都会自动覆盖应用的全局设置;应同时核对 Settings → DNS 中实际使用的解析设置。
MTU 设得过大时,可能出现小请求有响应、较大传输停滞的现象,但同一现象也可能来自其他网络问题。外层为 IPv4 时,典型 WireGuard 封装开销为 60 字节;外层为 IPv6 时为 80 字节。在底层 MTU 为 1500 的条件下,1420 是兼顾 IPv6 外层的常见起点,并不适用于所有链路。
- 先使用服务商给定的 MTU;未给定时,优先保留客户端默认值。
- 只有在连接已建立、部分传输异常时,再单独测试 MTU 调整。
- 每次只修改一个设置,使用同一目标复测,并记录修改前后的值。
四、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,还应以服务端支持和现有分配为准。
DOMAIN-SUFFIX,example.com,DIRECT:在规则模式下,使对应域名后缀使用 DIRECT。IP-CIDR,192.0.2.0/24,DIRECT,no-resolve:为示例 IPv4 网段指定 DIRECT,且不为此条规则主动解析域名。GEOIP,CN,DIRECT:根据所用 GeoIP 数据库匹配 IP 归属;匹配结果取决于数据库中的地址记录。FINAL,DIRECT:作为规则末尾兜底;实际策略应按自己的配置填写。
这些是 [Rule] 段的规则,不应粘贴进 AllowedIPs。规则按顺序匹配,前面的 DIRECT 规则已经命中时,后面的代理策略不会再接管该请求。
五、Endpoint 与 PersistentKeepalive 的填写边界
Endpoint 是本机首先需要通过当前网络访问的远端地址。它可以是 IP 地址或主机名,加上端口。标准配置中的写法为 192.0.2.10:51820;如果编辑界面将地址与端口分开,就分别填写,不要将整串内容重复放入两个字段。
- 地址字段不加
https://,不附带网页路径,也不粘贴订阅查询参数。 - 标准配置中 IPv6 端点应使用方括号,例如
[2001:db8::10]:51820,避免把地址中的冒号误认为端口分隔符。 - 确认远端监听的是配置指定的 UDP 端口。TCP 端口探测成功,不能证明同号 UDP 端口可达。
- 使用主机名时,先确认连接建立前就能解析它,避免依赖尚未建立的隧道内 DNS。
PersistentKeepalive 的单位为秒,用于按需发送保活数据以维持 NAT 或防火墙状态。25 是常见配置值,不是必须值;未设置或设置为 0 通常表示关闭周期保活。它不是连接超时,也不能修复错误的公钥或服务端未放行的端口。
切换 Wi-Fi 与蜂窝网络后才出现中断时,应记录切换时刻、能否重新建立连接及 UDP 可达性,再判断是否需要保活。不要用不断缩短保活间隔代替身份与端点检查。
六、在 Shadowrocket 中录入与分层验证
以下步骤以已有有效配置为前提。本站不提供、不销售、不推荐节点或订阅。若参数来自自己的订阅,先核对服务商提供的原始信息;订阅更新可能重新写入连接字段,因此排查前应记录当前值,避免手动修改被下一次更新覆盖。
-
选定协议
进入 Home →「+」→ Type → WireGuard。已有连接则从 Home 打开对应项目编辑,先确认 Type,不把其他协议的密码或标识填入 WireGuard 密钥字段。
-
核对身份
按本机与远端的对应关系填写 PrivateKey、远端 PublicKey,以及配置确实要求的 PresharedKey;同时确认服务端登记的是本机公钥。
-
核对地址
检查 Address、Endpoint 与端口。若编辑界面没有单列原配置中的某项,先确认该项在当前客户端中的承载位置,不要填入含义相近但不同的字段。
-
临时测试
保存并选中该连接,在 Home → Global Routing → Proxy 下测试同一个已知可访问目标,检查连接状态与日志,不把列表中的延迟结果当作完整业务验证。
-
恢复规则
测试结束后回到 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。若服务端确认更换了公钥、端口或地址分配,应同步更新对应字段,再从协议测试开始复查。