## 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 的[官方文档](https://github.com/wg-easy/wg-easy#docker-compose)，创建一个 `docker-compose.yml` 文件。
    - 确保将服务端私钥、监听端口和客户端公钥列表替换为你记录的信息。
    
2. **启动 wg-easy 服务**
    ```
    docker-compose up -d
    ```
    - 这将在后台启动 wg-easy 服务，并将其绑定到默认端口 51821（可在 `docker-compose.yml` 中修改）。