VPN 基础

WireGuard公钥配置示例的具体操作说明


WireGuard公钥配置示例的具体操作说明(shadowrocket)

以下是WireGuard对等端公钥配置的完整可落地操作说明,所有步骤都符合官方原生实现的通用规则,不需要依赖第三方修改的特殊版本,普通用户也可以按流程完成配置。

适用范围与前置准备

本操作说明适用于所有官方原生WireGuard实现,包括Linux内核模块、基于wireguard-go的用户空间版本,以及全平台官方适配的桌面、移动端客户端,所有对等端的公钥配置逻辑完全统一,不存在传统VPN的服务端和客户端强制区分限制。

操作前需要确认你拥有对应WireGuard网卡的修改权限,Linux环境下需要管理员权限,桌面端客户端需要系统授予的网络配置修改权限,不要在公共共享设备上操作私钥相关内容。

网络设备:WireGuard公钥:配置示

日常桌面环境下用户开展WireGuard公钥配置的实操场景

正式修改配置前,先把当前正在运行的WireGuard配置文件完整导出,存储到非系统临时目录的独立文件夹中,标注好备份时间,避免后续配置出错后无法快速恢复原有网络状态。

公钥配置分步操作

首先生成本地节点的专属密钥对,生成后把私钥设置为仅当前操作用户可读,绝对不能对外分发私钥内容,只需要把对应的公钥发送给需要对接的对端节点管理员即可。

打开本地节点的WireGuard配置文件,在Peer配置段落中填入对端节点公开的公钥内容,注意不要误填入本地自己的公钥,否则两端的公钥校验会直接失败,隧道无法建立。

如果你的本地节点处于NAT内网之后,需要主动维持和公网对端的长连接,可以在对应Peer段落中添加PersistentKeepalive配置项,设置合理的发送间隔,不需要额外修改其他底层网络参数。

填写AllowedIPs字段时要注意,这个字段同时承担两个作用:一是决定本地哪些目标地址的流量会走WireGuard隧道转发,二是校验从隧道收到的数据包的源地址是否合法,shadowrocket不要随意填写过大的网段范围,避免和本地原有局域网路由规则冲突。

配置后的合规验证步骤

配置完成后先不要直接启用隧道,使用官方提供的只读查询命令,查看当前配置加载的所有对等端公钥列表,确认你刚填入的对端公钥字符完全正确,没有出现输错、漏输的情况。

提前测试两端的UDP连通性,确认对端填写的监听UDP端口可以正常访问,注意UDP和TCP的同号端口是完全独立的监听端点,不能用TCP端口的连通性测试结果,直接判定WireGuard的UDP端口可用。

先小范围测试隧道连通性,尝试访问对端隧道内的内网地址,确认公钥校验通过、小火箭VPN数据包可以正常收发,再逐步调整路由规则,不要直接全量切换所有流量,避免影响现有正常业务的访问。

异常回滚与恢复方法

如果配置完成后原有公网或者局域网访问出现异常,直接停止当前修改后的WireGuard实例,导入之前提前备份的原有配置文件重新加载,就可以完全恢复到操作之前的网络状态。

如果出现隧道完全不通、日志提示公钥校验失败的情况,先核对两端的公钥是否交叉填写正确,确认本地存的对端公钥和对端本地生成的公钥完全一致,不需要直接删除原有Peer配置。

隐私与安全编辑组 - shadowrocket
介绍浏览器隐私、账号保护与数据传输,区分工具能力和使用边界。
查看更多文章
连接指南

从一个连接问题开始

遇到路由器NAT会话超时相关问题,可从“确认通信方向并使用部署支持的恢复方式”开始阅读。调整保活前应确认不是账号期限造成的断线,需要结合具体环境判断。