WireGuard Easy - 简易WireGuard管理平台

一、关于 WireGuard Easy

1、项目概览

WireGuard Easy是Linux主机上最简单易用的WireGuard安装和管理解决方案，提供Web UI界面实现可视化操作。

免责声明：本项目与WireGuard官方无关联，"WireGuard"名称及logo为Jason A. Donenfeld注册商标

[外链图片转存中…(img-PSEBsRHR-1750647070934)]

2、相关链接资源

• GitHub仓库：https://github.com/wg-easy/wg-easy

• 官方文档：https://wg-easy.github.io/wg-easy/latest

  • 基础教程 ：快速入门 | 基础安装
  • 进阶配置 ：Caddy反向代理 | Traefik配置 | 迁移指南

• 预发布文档：https://wg-easy.github.io/wg-easy/Pre-release

• Docker镜像：https://github.com/wg-easy/wg-easy/pkgs/container/wg-easy

• License：AGPL-3.0

3、功能特性

1. 一体化解决方案

   • 集成WireGuard服务与Web管理界面
   • 支持Docker快速部署

2. 客户端管理

   • 客户端配置的增删改查
   • 二维码生成与配置文件下载
   • 连接状态监控与流量统计

3. 高级功能

   • 自动深浅色主题切换
   • 多语言支持
   • 双因素认证(2FA)
   • Prometheus监控指标
   • IPv6/CIDR支持

二、安装配置

本指南将帮助您快速上手使用 WireGuard Easy。

如需更详细的安装说明，请参阅入门指南页面。

1、安装 Docker

如果尚未安装 Docker，请以 root 身份运行以下命令进行安装：

curl -sSL https://get.docker.com | sh
exit

重新登录。

2、运行 WireGuard Easy

使用 Docker Compose 是运行 WireGuard Easy 最简单的方式。

只需下载 docker-compose.yml 并执行 sudo docker compose up -d 命令即可。

接下来需要设置反向代理，以便能够安全地从互联网访问 Web 用户界面。

如果想通过 HTTP 协议访问 Web 用户界面，请将环境变量 INSECURE 改为 true。但这种方式并不推荐，仅建议在测试时使用。

三、开发

1、前提条件

• Docker
• Node LTS 版本并启用 corepack
• Visual Studio Code

2、开发服务器

这将使用 Docker 启动开发服务器

pnpm dev

3、更新自动导入

当你添加了应该支持自动导入的内容但 VSCode 报错时，可以运行以下命令：

cd src
pnpm install
cd ..

4、测试命令行工具

这将使用 Docker 启动命令行界面

pnpm cli:dev

伊织 xAI 2025-05-27（二）