# 如何在VPS上安装wg-easy？

> 如何在VPS上安装wg-easy，共6个步骤：Docker、官方compose文件、docker compose up、端口51820/udp，以及受保护的网页管理页面。

- URL: https://tunnelvps.com/zh/guides/how-to-install-wg-easy-on-a-vps/
- 最后更新: 2026-11-16
- 发布者: TunnelVPS (https://tunnelvps.com)

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日查看）*

| 步骤 | 位置 | 操作 |
| --- | --- | --- |
| 1 | TunnelVPS结账 | 下单带有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更新。若只有两三台设备，使用[一条命令安装](https://tunnelvps.com/zh/help/install-wireguard-in-one-command/ "How do I install WireGuard on a TunnelVPS server?")的普通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（官方命令）*

```bash
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端口指南](https://tunnelvps.com/zh/guides/how-to-open-the-wireguard-port-in-ufw/ "How do I open the WireGuard port in UFW?")展示了如何只允许WireGuard端口。

## 网页管理页面应如何保护？

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

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

*文档中的无代理设置（不安全，公共VPS上应避免）*

```yaml
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内存）是最小的舒适选择。[小团队服务器页面](https://tunnelvps.com/zh/best-vpn-server-for-a-small-team/ "What is the best VPN server for a small team?")按人数比较各方案。

## 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开放。**

## 来源

1. [wg-easy代码仓库](https://github.com/wg-easy/wg-easy) — GitHub (read 2026-11-16)
2. [wg-easy：基础安装](https://wg-easy.github.io/wg-easy/latest/examples/tutorials/basic-installation/) — wg-easy (read 2026-11-16)
3. [wg-easy：无反向代理](https://wg-easy.github.io/wg-easy/latest/examples/tutorials/reverse-proxyless/) — wg-easy (read 2026-11-16)
4. [WireGuard：安装](https://www.wireguard.com/install/) — WireGuard (read 2026-11-16)

**获取用于wg-easy的服务器** Home有运行Docker和WireGuard所需的内存，12个月租期每月$6.37。 [订购12个月的Home](https://tunnelvps.com/app/checkout/?plan=home&term=12m&image=ubuntu-24.04&from=guides-how-to-install-wg-easy-on-a-vps&lang=zh) · [为WireGuard添加设备](https://tunnelvps.com/zh/guides/how-to-add-a-device-to-a-wireguard-server/ "如何为WireGuard添加设备？")

---

TunnelVPS: TunnelVPS在纽约、达拉斯、洛杉矶、伦敦、阿姆斯特丹和法兰克福租用Linux KVM服务器，用于个人VPN（WireGuard、Outline或AmneziaWG），用加密货币支付，无需身份证件。共5款套餐，内存从2到16 GB，每月流量从2到6 TB，六个城市价格相同；选择12个月租期时，每款价格都比一家无KYC加密货币主机的同类套餐至少低25%（该对比价格于2026年11月16日查看）。运营方为巴拿马的DomaineGoat LLC。
