WireGuard 密钥不匹配，是指至少一条 peer 记录没有保存由对端当前私钥派生的公钥，或双方可选 PSK 不一致。仅凭没有回应无法判断哪端错误。应从可信本地观察建立双向公钥映射，比较预期的 peer 记录，找出陈旧的关系后才轮换或替换材料。

完整 VPN 指南覆盖更广的连接阶段；本文只处理 WireGuard 静态身份与可选 PSK 一致性。

关键要点

每端保存自己的私钥，并把对端公钥配置为 peer 身份。［1］

只比较公钥或受控指纹，绝不交换私钥来“核对”。

端点错误、UDP 阻断、路由或 AllowedIPs 问题都可能伪装成密钥故障。

当前握手证明该 peer 在当时使用的静态密钥映射相符。

PSK 不匹配属于另一条秘密状态核对；不能把原值显示出来目测比较。

WireGuard 密钥如何映射？

每个 WireGuard 接口都有静态私钥，其派生公钥作为接口身份。peer 段保存远端接口公钥。握手时，每端使用自己的私钥与已配置的远端公钥；协议不会发送一个可协商用户名来自动修复错误映射。［1］

白皮书把 peer 与公钥、允许 IP 地址关联。［2］所以同一接口同时有本地身份、每个远端的预期身份，以及分配给各 peer 的地址前缀。公钥配对正确时，错误地址映射仍可导致无数据。

可选 PSK 会增强公钥密码层。wg 手册定义私钥、peer 公钥、PSK、端点、允许 IP、保活与运行时字段。［3］双方 PSK 必须相同，但它是秘密；安全流程只能比较其受控来源或在本地计算的受控指纹，不能贴入聊天、工单、截图或命令输出。

A 端材料	预期关系	B 端材料
A 当前私钥	派生	A 实测公钥
A 为 B 配置的 peer 公钥	必须等于	B 实测公钥
B 为 A 配置的 peer 公钥	必须等于	A 实测公钥
A 为 B 配置的 PSK	必须来自同一秘密代次	B 为 A 配置的 PSK
A 为 B 设置的 `AllowedIPs`	把目标映射至 B	不是密钥比较

什么证据支持 WireGuard 密钥不匹配？

新导入配置在一端轮换密钥后从未握手，是强上下文；peer 公钥与预期远端在本机派生的公钥不等，则是直接证据。受控换钥后握手立即停止，也能缩小变化窗口。

反复发起却无回应并不专属密钥。UDP 可被阻断，端点可能错误，NAT 状态可过期，服务可能未监听或 peer 离线。服务器回应与握手失败指南说明为何可达性与身份验证要分开。

确切 peer 存在新鲜握手时，它在当时使用的静态密钥与可选 PSK 已一致。后续无数据应先使用握手后无数据计数流程，而不是猜测换钥。

七步密钥核对

步骤 1：读取密钥前标记两个端点

给端点使用无歧义标签，例如 laptop-2026 与 gateway-east，记录管理员、预期接口、peer 段、端点及客户端地址，但不要复制完整配置。许多所谓不匹配，其实是在比较旧设备记录与同名新设备。

固定失败尝试的时间，以及两端预期 peer 的最近握手值。如果多个 peer 共用同一网关，应按公钥和分配的地址前缀识别记录，而不是按列表位置。盘点期间不要重命名、删除或重新生成任何东西。密钥一旦改变，就会毁掉判断“配置分发、运行中的进程还是 peer 记录陈旧”所需的证据。

步骤 2：在本地派生两端公开身份

在 A 端使用可信 WireGuard 工具，派生或显示当前活动接口私钥对应的公钥，只把公开结果记入工作表；在 B 端本地重复。

不要把私钥复制到临时目录、shell 历史或在线解码器。无法安全显示活动公钥时，使用受支持的注册界面记录公开身份。

确认运行状态，不要假设磁盘文件已经加载。配置文件改过后，服务仍可能运行旧密钥；接口也可能由另一真源重建。把活动公钥与预期记录比较，全程不打印私钥。

到此停止：任一端无法建立可信的本地公开身份时，请获授权管理员提供公钥或指纹证明，不能索要私钥。

步骤 3：双向比较映射

读取 A 端为 B 保存的 peer 公钥，与 B 的本地公开身份比较；再读取 B 为 A 保存的公钥，与 A 的身份比较。这是两条独立边，一条可以最新，另一条仍陈旧。

比较	结果	解释
A 预期 B = B 实测	相同	A 的远端身份记录一致
A 预期 B ≠ B 实测	不同	A 的 peer 记录或 B 的预期身份陈旧
B 预期 A = A 实测	相同	B 的远端身份记录一致
B 预期 A ≠ A 实测	不同	B 的 peer 记录或 A 的预期身份陈旧
两边都相同	未显示静态公钥问题	检查 PSK、端点、路径与选路

不匹配只能指出一条不一致的边，不能自动判定责任人或机器。应在注册真源中确认哪一个公开身份获得授权：可能是设备合法换钥而服务器记录漏了更新，也可能是本地发生了未授权替换，成为陈旧的一方。条件允许时，在受保护的管理会话中逐字比较完整公钥。如果工单或口头核对无法安全传递完整公钥，就在两端用相同的、有文档记载的算法和编码计算密码学指纹，并标明所用算法；只看一个缩短的前缀，可能发生碰撞或抄错。

步骤 4：不泄露 PSK 地处理它

先确认两条 peer 记录是否都应使用 PSK。一端“存在”、另一端“缺失”，本身就已经不一致。如果双方都有，确认它们来自同一次受控的生成和分发。

政策允许在本地核实时，可以就地计算带密钥的或密码学指纹，并只通过获准渠道比较得到的受控标识。不要用快速且不加盐的哈希，作为公开低熵秘密的一般手段。最稳妥的运维方式往往是：通过秘密管理系统，把一个新生成的 PSK 重新部署到两条预期记录上，全程不显示它。

绝不要把 PSK 放在会留在历史记录、进程列表或支持消息中的命令行里。wg 状态显示存在预共享密钥，并不能证明两端的秘密值相同。

步骤 5：轮换前排除相似故障

确认端点地址与 UDP 端口通向预期接口。再完美的密钥映射，也无法回应发往旧主机的流量。用窄范围的防火墙和数据包计数确认握手发起是否到达、回应是否离开。

把预期 peer 与路由、AllowedIPs 对照。AllowedIPs 指南解释前缀如何绑定 peer。错误前缀可让有效握手之后无数据，重复或放错的 peer 记录也会让你查看错误计数。

确认双方运行的是预期的配置代次，重启、容器、网络命名空间或管理代理没有加载另一个文件。看不到远端证据时，不能从“无回应”推导密钥不匹配。

步骤 6：只修正确认陈旧的边

一旦登记的真源确认了获授权的公开身份，就通过受支持的配置渠道，更新不一致的远端 peer 记录。不要走复制远端私钥的捷径。按本地政策，把旧的公开记录和变更单号保留足够长的时间，以便回滚和审计。

如果本地私钥本身在未经授权的情况下被替换，或其保密性存疑，应将其作为安全事件处理。在获准环境中生成新的本地密钥对，只把新公钥分发给每个获授权的 peer，吊销旧身份，并核实没有遗留的陈旧 peer。这比修正一个笔误的范围更大，可能需要与管理员协调。

对于 PSK 不一致，通过获准的秘密渠道向双方部署同一个新秘密。除非所有者明确接受这项安全变更且协议政策允许，否则不要为了让隧道连通而临时删除 PSK。

步骤 7：分别验证身份与数据路径

发起一次获准的连接尝试，确认两端预期 peer 的最近握手时间都已更新。围绕一个小型数字地址探针记录新鲜的 TX/RX 增量。握手证明修复后的身份映射成立；计数变化和应用测试则分别证明后续阶段。

核实端点、分配的前缀和路由仍与标注的设备相符。修复密钥不应悄悄授权更宽的 AllowedIPs 或另一个客户端地址。按保留政策移除临时诊断访问和脱敏工作表。

如果公钥两端和 PSK 来源都相符，却仍没有握手，就停止重新生成密钥，回到端点可达性、服务状态和防火墙证据上。如果握手成功但数据不通，改按计数矩阵排查。

什么时候托管 VPN 应用比自管密钥更省事？

密钥不匹配是自己运行 peer 的维护成本。如果你只需要为自己的设备提供私人连接，AethoVPN 提供了一条不必做这类记账的途径：文档说明的步骤是用邮箱验证码继续，在 Windows、Linux 或 Android 上安装客户端（Mac 和 iPhone 通过官网设置向导获取配置，需 Pro 或 Premium 套餐），然后在应用中选择位置。这套流程不涉及导入或核对 WireGuard 密钥，所以你自己运行的 peer 之间出现不匹配，仍要在两端比对公钥来解决；也绝不要把私钥或 PSK 发给任何支持团队，包括 AethoVPN 的支持团队。可用邮箱创建账户，比较托管方式与自己维护密钥的差别。

总结

比较身份前，先标记确切的活动端点与 peer 记录。
在每端本地派生或显示公钥，不为诊断搬移私钥。
先比较 A 预期的 B 与 B 实测公钥，再反向比较。
把可选 PSK 当作独立的秘密分发检查。
排除端点、防火墙、进程代次、路由和 AllowedIPs 相似故障。
只修正确认陈旧的边，并把握手与数据作为两个门验证。

常见问题

能从“没有握手”判断哪端错误吗？

不能。密钥不匹配、端点错误、UDP 被阻、服务停止、NAT 过期或 peer 离线都可表现为沉默，需要两端可信观察。

WireGuard 公钥可以安全公开吗？

它不是秘密，但仍是稳定 peer 标识。只向预期管理员分享，不要连同完整拓扑公开。

可以直接比较双方私钥吗？

不可以。每把私钥都必须留在各自获授权的端点或秘密管理系统中；应在本地派生公钥，再比较公钥。

当前握手能否排除密钥不匹配？

它能排除该 peer 在当次握手使用的静态身份和可选 PSK 不匹配，但不能证明其他 peer 或后续数据路由正确。

怎样确认 PSK 相同？

确认共同秘密来源，或使用批准的就地指纹流程。“PSK 已设置”不能证明相等，原值也不能复制到诊断资料。

WireGuard 失败时是否应重建两端密钥？

不应。大范围轮换会破坏证据、扩大分发面；只在材料陈旧或泄露政策要求时轮换。

应向支持人员提供什么？

提交脱敏端点标签、时间、软件版本、最近握手观察、双向公钥对照或批准指纹及首个断点；勿提交私钥、PSK、完整配置或 dump。

免责声明：本文仅提供一般技术排障信息。只通过授权系统处理密钥材料，疑似私钥泄露应作为安全事件处置。

来源：

WireGuard, "Protocol & Cryptography": https://www.wireguard.com/protocol/
WireGuard, "WireGuard: Next Generation Kernel Network Tunnel": https://www.wireguard.com/papers/wireguard.pdf
WireGuard Tools, "wg(8)": https://git.zx2c4.com/wireguard-tools/tree/src/man/wg.8

Sources checked 2026 年 9 月 12 日。

延伸阅读：

WireGuard 密钥不匹配：两端公钥对应关系与安全诊断方法