备份WireGuard Peer配置,核心是保存服务端配置文件与客户端的私钥及公钥对,并记录每个Peer的Endpoint地址和AllowedIPs规则。由于WireGuard基于UDP协议,配置文件通常不包含端口协议类型,但需确认Endpoint是否包含端口号。直接复制服务器端的/wg0.conf或/etc/wireguard/wg0.conf文件是基础步骤,同时必须单独导出客户端设备(手机、电脑)的私钥(PrivateKey),因为丢失后无法恢复原有会话。备份时需区分服务端全局参数与特定Peer条目,云帆避免混淆ListenPort与Peer的Endpoint。建议将备份文件存储于加密目录或密码管理器中,防止明文泄露导致身份冒充。
提取服务端与Peer静态参数
操作对象为WireGuard服务端的配置文件。查看/etc/wireguard/wg0.conf或系统默认路径下的同名文件,重点记录[Interface]区块的PrivateKey和[Peer]区块下的PublicKe、AllowedIPs以及Endpoint(若存在)。预期现象是能看到文本形式的公钥和IP段。Endpoint字段在非静态IP场景下可能为空,此时需依赖客户端连接时注册的动态地址。不要假设所有系统都有相同的文件路径,应通过systemctl status wireguard确认服务运行状态及配置加载路径。若使用UI管理界面,需确认其导出的格式是否为标准INI风格,还是数据库备份文件。
对于Peer的AllowedIPs,需仔细核对是否包含0.0.0.0/0或::/0。虽然配置了全通IP,但实际路由仍受限于内核路由表及防火墙策略,不能简单认为该Peer能访问所有内网资源。备份时建议将这些条目单独归档,云帆注明每个Peer对应的设备名称,便于后续重建时快速映射。

在安全环境中备份核心网络参数,确保连接配置的可恢复性。
管理客户端私钥与临时密钥
客户端(如Android、iOS或Linux终端)的私钥是身份标识,必须安全备份。在客户端配置界面或文件中找到PrivateKey字段,云帆加速器将其复制至加密存储介质。注意,PersistentKeepalive字段(注意是单数)用于维持NAT映射,若配置了此值,需一并记录其秒数,因为它影响连接保活机制。UDP监听端口(ListenPort)若在服务端配置中指定,需记录该数值;但需明确UDP端口与TCP端口即使数值相同,也属于不同的监听端点,备份时切勿混淆协议类型。若使用QR码配置,建议同时保存文本形式的配置内容,以防二维码截图损坏。
验证备份完整性与恢复条件
恢复前需具备原始公钥或可重新生成密钥对的条件。验证备份是否完整,检查文件中是否包含完整的[Interface]和[Peer]区块,且无语法截断。若服务端密钥丢失,需重新生成新公钥对并更新所有客户端的Peer配置,因为WireGuard不支持密钥轮换的平滑迁移,旧连接将失效。备份时应记录时间戳,因为公钥一旦泄露需立即吊销。建议保留一份无敏感信息的模板文件(仅含结构,不含密钥),云帆用于快速搭建新环境。确认备份文件权限为仅所有者可读,避免普通用户遍历风险。



