你自己的VPN服务器 · WireGuard、Outline、AmneziaWG · 6个城市 · 用BTC, USDT, USDC, ETH, SOL, LTC, XMR付款
语言: 简体中文
获取VPN服务器

指南 · 带网页管理页面的WireGuard

如何在VPS上安装wg-easy?

wg-easy在Docker中运行WireGuard,并提供用于客户端和二维码的网页。安装只需四条命令;保护管理页面才是需要谨慎处理的部分。

最后更新:

简要回答

如何在VPS上安装wg-easy?

如何在VPS上安装wg-easy:以root身份登录TunnelVPS服务器,使用官方脚本安装Docker,将项目的docker-compose.yml下载到/etc/docker/containers/wg-easy,然后运行docker compose up -d。WireGuard随后监听UDP 51820。在从互联网访问网页管理页面之前,请将其置于反向代理之后。

要点速览
  • 内容:WireGuard加上用于客户端和二维码的网页管理页面,运行在Docker中,采用AGPL-3.0许可证。
  • 安装:Docker,然后是官方compose文件和docker compose up -d。
  • 端口:WireGuard使用UDP 51820,可在compose文件中更改。
  • 管理页面:通过反向代理供互联网访问;文档认为纯HTTP不安全。

安装wg-easy的步骤是什么?

在TunnelVPS服务器上安装wg-easy,共6个步骤,依据wg-easy文档(2026年11月16日查看)
步骤位置操作
1TunnelVPS结账下单带有Debian或Ubuntu镜像并附上您SSH密钥的服务器。
2服务器,以root身份用curl -sSL https://get.docker.com | sh安装Docker,然后重新登录。
3服务器创建/etc/docker/containers/wg-easy,并将docker-compose.yml下载到其中。
4服务器在该文件夹中运行docker compose up -d。
5服务器防火墙如果运行着防火墙,请允许UDP 51820,或您设置的端口。
6反向代理通过HTTPS发布管理页面,或让其不对互联网开放。

为什么用wg-easy而不是普通WireGuard?

因为添加、禁用和共享客户端只需在网页上点击几下。wg-easy为每个客户端显示一个二维码,便于手机扫描。普通WireGuard用配置文件和qrencode完成同样的工作。

代价是需要保护一个网络服务,并且要保持Docker更新。若只有两三台设备,使用一条命令安装的普通WireGuard更轻便。对于有许多对等节点的团队,管理面板能节省时间,这也是人们会问如何在VPS上安装wg-easy的原因。

如何安装Docker并启动wg-easy?

运行Docker安装脚本,然后执行wg-easy基础安装页面中的四条命令。TunnelVPS于2026年11月16日查看了该页面。GitHub页面说明,应以root运行Docker脚本,之后需重新登录。

下面的命令是官方原文,未作改动。它们使用sudo,在您已是root时无害。学会如何在VPS上安装wg-easy只需这些;其余都是配置。

安装Docker,然后安装wg-easy(官方命令)
curl -sSL https://get.docker.com | sh
# log out and back in, then:
sudo mkdir -p /etc/docker/containers/wg-easy
sudo curl -o /etc/docker/containers/wg-easy/docker-compose.yml https://raw.githubusercontent.com/wg-easy/wg-easy/master/docker-compose.yml
cd /etc/docker/containers/wg-easy
sudo docker compose up -d

wg-easy需要哪些端口?

UDP 51820用于WireGuard,见基础安装页面。文档指出端口可以更改,此时防火墙也必须随之调整。服务器的入站UDP和TCP端口已开放;客户自行选择VPN端口并设置防火墙。。

管理页面端口在compose文件中设置。未加保护时,请勿向整个互联网开放。UFW端口指南展示了如何只允许WireGuard端口。

网页管理页面应如何保护?

放在带HTTPS的反向代理之后,这也是wg-easy文档推荐的做法。文档提供了Traefik和Caddy的指南。

存在一种无代理模式:在compose文件的environment中设置INSECURE=true。文档称其不安全,并说明只有在您清楚自己在做什么时才使用。文档还说明,应确保此时页面无法从本地网络之外访问。在VPS上,它周围没有本地网络,因此应把代理视为必需。

文档中的无代理设置(不安全,公共VPS上应避免)
environment:
  - INSECURE=true

哪款套餐适合wg-easy和小团队?

Crew的规格适用于wg-easy这类网页面板、多种协议和众多对等节点。它有4 shared vCPU, 8 GB RAM, 120 GB NVMe, 5 TB a month,12个月租期每月$10.12,也可按月租用。

Docker在WireGuard之外还会占用内存,因此Home(4 GB内存)是最小的舒适选择。小团队服务器页面按人数比较各方案。

wg-easy常见问题

wg-easy免费吗?

是的。它以AGPL-3.0许可证开源。服务器是唯一的成本。

wg-easy与手动配置的WireGuard能在同一台服务器上运行吗?

只能使用不同的端口和接口名称。在同一端口上运行两个WireGuard管理工具会失败,因此请选择一个。

如何更新wg-easy?

请按wg-easy文档中适用于您版本的更新步骤操作;它们通过Docker Compose拉取较新的镜像。

wg-easy能为手机生成二维码吗?

能。网页为每个客户端显示一个二维码,WireGuard手机应用可以扫描。

2026年在VPS上安装wg-easy的最佳方式是什么?

wg-easy文档中官方的Docker Compose方式,并在管理页面前放置反向代理。

结论
  • 四条命令即可安装wg-easy;Docker需先安装。
  • 切勿在公共服务器上让管理页面以纯HTTP开放。
来源 (4)
  1. wg-easy代码仓库 — GitHub (read 2026-11-16)
  2. wg-easy:基础安装 — wg-easy (read 2026-11-16)
  3. wg-easy:无反向代理 — wg-easy (read 2026-11-16)
  4. WireGuard:安装 — WireGuard (read 2026-11-16)

获取用于wg-easy的服务器

Home有运行Docker和WireGuard所需的内存,12个月租期每月$6.37。

12个月起每月2.25美元 · 无KYC

获取服务器