本文适合已经从自己的服务商处取得 WireGuard 配置、准备在 Shadowrocket 中逐项核对参数的用户。先区分本端身份、隧道地址与远端 Peer,再说明 Allowed IPs 和应用规则的边界,最后按握手、小流量、大流量的顺序排查 MTU。示例地址只用于解释字段,不能作为可连接的服务器使用。
一、先区分本端 Interface 与远端 Peer
Shadowrocket(小火箭)中的 WireGuard 配置不能按“服务器地址加密码”的方式理解。WireGuard 用公钥识别通信对端:本端保存自己的 Private Key,并把对应的 Public Key 登记到远端;本端的 Peer 则填写远端 Public Key。两边的密钥关系必须相互对应,单独获得一个服务器地址并不足以建立有效隧道。
标准 WireGuard 配置文件通常分为 [Interface] 与 [Peer]。前者描述本端身份、隧道内地址等参数,后者描述通信对端及允许通过该对端传输的地址范围。Shadowrocket 的节点表单可能把这些字段拆成多个输入项,核对时应按含义映射,不要把完整文件直接粘进某一个密钥栏。
二、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,方括号用于区分地址中的冒号与端口分隔符。
- 主机名 Endpoint:需要先完成 DNS 解析,解析失败时还未进入 WireGuard 密钥核验阶段。
- 端口:以配置为准。把 51820 改成 443 并不会自动获得可用连接,也不会把 WireGuard 变成 HTTPS。
- UDP 可达性:当前 Wi-Fi、蜂窝网络、路由器与远端防火墙都可能影响 UDP;普通网页能打开不代表该 UDP 端口可达。
- 网络切换:从 Wi-Fi 切到蜂窝后若出现差异,应分别记录网络、Endpoint 地址族与测试结果,不要同时替换密钥。
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 IPs | 10.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 节点,优先进入节点编辑页核对,不要重复创建多个名称相似、参数不同的节点。
准备参数
从你的服务商处获取配置,分清 Interface 与 Peer,记录 Endpoint、端口、Address、Allowed IPs 和 MTU,密钥不抄进公开笔记。
选择协议
Home → 右上角「+」→ Type → WireGuard。按表单区分本端参数与 Peer 参数,不把整份配置粘到 Private Key。
逐项录入
录入本端 Private Key 与 Address,再录入 Peer 的 Public Key、Endpoint 对应地址和端口;其余选项按原始配置填写后保存。
选定节点
返回 Home,点选该服务器左侧圆点,检查 Global Routing。需要排除规则影响时,可短时切至 Proxy 验证,完成后恢复原有姿态。
验证流量
打开连接开关;首次提示添加 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
只有在路径条件与测试结果支持时再考虑。数值更大不等于速度更快,超过可承载范围反而可能导致分片、丢包或连接等待。
适合:已有稳定基线,并能控制测试条件的进阶调试
- 使用相同网络、相同目标和相同传输任务比较,不在调整 MTU 时同步更换 Peer 或 DNS。
- IPv6 的最小链路 MTU 为 1280;需要承载 IPv6 时,不应把继续降到 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 作对照 |
| 订阅更新后恢复原参数 | 节点是否由订阅管理 | 向服务商确认源配置,区分订阅节点与手动节点 |
订阅更新可能重新应用服务商下发的节点参数。若为了诊断手动修改了某个字段,应记录修改内容,并确认后续刷新是否覆盖它。不能因为本地暂时改好,就忽略源配置中的错误;也不要为了保留一次测试值而长期停止必要的配置更新。