deploy.stack/WireGuardVPN/wg-easy/readme.md

wg-easy 运维工具

运维场景：在已有的、手动配置的 WireGuard 服务上叠加一个 Web UI 管理工具。
核心思路：让 wg-easy 接管你现有的 WireGuard 接口（如 wg0）的配置管理权。 这意味着需要将现有的配置“迁移”到 wg-easy 的数据目录中，并停止原有的 WireGuard 服务，由 wg-easy 来启动和管理它。

准备工作（非常重要！）

1. 备份现有配置
   • 确保你有一个备份，以防操作过程中出问题。操作失误可以随时还原。

   cp /etc/wireguard/wg0.conf /etc/wireguard/wg0.conf.backup
   

2. 记录现有配置信息
   • 记录服务端私钥：wg0.conf 中 [Interface] 部分的 PrivateKey。
   • 记录服务端监听端口：ListenPort（通常是 51820）。
   • 记录客户端公钥列表：所有 [Peer] 部分的 PublicKey 和对应的 AllowedIPs。
3. 停止并禁用原有的 WireGuard 服务

   wg-quick down wg0 
   systemctl stop wg-quick@wg0.service
   systemctl disable wg-quick@wg0.service
   

可以防止它与即将启动的 wg-easy 服务冲突，因为 wg-easy 会在启动时检查并使用自己的配置。

部署 wg-easy（使用 Docker Compose）

1. 创建 Docker Compose 文件

   • 参考 wg-easy 的官方文档，创建一个 docker-compose.yml 文件。
   • 确保将服务端私钥、监听端口和客户端公钥列表替换为你记录的信息。

2. 启动 wg-easy 服务

   docker-compose up -d
   

   • 这将在后台启动 wg-easy 服务，并将其绑定到默认端口 51821（可在 docker-compose.yml 中修改）。