# 如何在我的 TunnelVPS 服务器上安装 WireGuard？

> 在 TunnelVPS 服务器上用 apt 安装 WireGuard，生成密钥，根据示例（使用占位值）编写 wg0.conf，启动它，然后添加手机和笔记本。

- URL: https://tunnelvps.com/zh/help/install-wireguard-in-one-command/
- 最后更新: 2026-11-16
- 发布者: TunnelVPS (https://tunnelvps.com)

**简要回答 — 如何在 TunnelVPS 服务器上安装 WireGuard？**

以 root 身份登录 **TunnelVPS** 服务器，在 Debian 上运行 `apt install wireguard`，在 Ubuntu 上运行 `sudo apt install wireguard`。然后生成密钥对，编写 `/etc/wireguard/wg0.conf`，开启 IP 转发，并启动 `wg0` 接口。每台设备都有自己的密钥和一个 `[Peer]` 段。整个设置大约需要 10 条命令。

**要点速览**

- **安装**：Ubuntu 上用 `sudo apt install wireguard`，Debian 上以 root 身份用 `apt install wireguard`，依据 wireguard.com。
- **密钥**：`wg genkey | tee privatekey | wg pubkey > publickey`，在 `umask 077` 之后。
- **配置**：服务器一个 `[Interface]`，每台设备一个 `[Peer]`。
- **端口**：任何空闲的 UDP 端口；TunnelVPS 不封闭入站端口。
- **客户端**：iOS、Android、Windows 和 macOS 的官方应用；OpenWrt 使用 `opkg install wireguard`。

## 每个 TunnelVPS 镜像上用哪条命令安装 WireGuard？

**四个镜像的软件包名称相同，只有 `sudo` 前缀不同。** TunnelVPS 于 2026 年 11 月 16 日阅读了 WireGuard 的安装页面。

*针对每个 TunnelVPS 系统镜像的 WireGuard 安装命令，来自 wireguard.com，2026 年 11 月 16 日阅读*

| TunnelVPS 镜像 | 安装命令 | wireguard.com 的说明 |
| --- | --- | --- |
| Ubuntu 24.04 LTS | `sudo apt install wireguard` | Ubuntu 上公布的命令 |
| Ubuntu 22.04 LTS | `sudo apt install wireguard` | Ubuntu 上公布的命令 |
| Debian 13 | `apt install wireguard` | 以 root 身份运行 |
| Debian 12 | `apt install wireguard` | 以 root 身份运行；backports 仅适用于 Bullseye 之前的版本 |

## 如何安装软件包并生成服务器密钥？

**更新软件包列表，安装，然后在 `/etc/wireguard` 中生成密钥对。** 你以 root 身份登录，因此 `sudo` 是可选的。[首次 SSH 登录指南](https://tunnelvps.com/zh/help/first-ssh-login/ "How do I log in to a TunnelVPS server over SSH?") 说明了如何到达这一步。

*安装 WireGuard 并生成服务器密钥对*

```bash
apt update
apt install wireguard
cd /etc/wireguard
umask 077
wg genkey | tee privatekey | wg pubkey > publickey
cat privatekey publickey
```

## wg0.conf 中应写些什么？

**服务器需要一个 `[Interface]` 段，每台设备需要一个 `[Peer]` 段。** 下面的示例使用明显的占位值。把所有大写单词替换为来自你的服务器或设备的真实密钥。

- **Address** 是服务器在隧道内的地址，此处为 `10.8.0.1/24`。
- **ListenPort** 是设备连接的 UDP 端口。51820 很常见；任何空闲端口都可以。
- **PostUp 和 PostDown** 让隧道流量通往互联网。把 `eth0` 替换为 `ip route` 中 `dev` 之后显示的名称。
- 每个对等节点下的 **AllowedIPs** 是该设备自己的隧道地址，每台设备一个。

在 Debian 上，如果缺少命令，请先用 apt 安装 `iptables`。

*/etc/wireguard/wg0.conf (sample with dummy values)*

```ini
[Interface]
Address = 10.8.0.1/24
ListenPort = 51820
PrivateKey = SERVER_PRIVATE_KEY_HERE
PostUp = iptables -A FORWARD -i wg0 -j ACCEPT; iptables -t nat -A POSTROUTING -o eth0 -j MASQUERADE
PostDown = iptables -D FORWARD -i wg0 -j ACCEPT; iptables -t nat -D POSTROUTING -o eth0 -j MASQUERADE

[Peer]
# phone
PublicKey = PHONE_PUBLIC_KEY_HERE
AllowedIPs = 10.8.0.2/32

[Peer]
# laptop
PublicKey = LAPTOP_PUBLIC_KEY_HERE
AllowedIPs = 10.8.0.3/32
```

## 如何开启转发并启动隧道？

**允许内核转发数据包，然后启动 `wg0`，并设置为开机启动。** `wg show` 随后会列出接口，设备连接后还会列出每个对等节点，包括其最近的握手以及发送和接收的字节数。

如果你启用了 ufw 之类的防火墙，请在其中开放 WireGuard 端口。服务器的入站UDP和TCP端口已开放；客户自行选择VPN端口并设置防火墙。。

*开启转发并启动 WireGuard*

```bash
echo "net.ipv4.ip_forward=1" > /etc/sysctl.d/99-wireguard.conf
sysctl --system
systemctl enable --now wg-quick@wg0
wg show
```

## 如何添加手机或笔记本？

**为设备生成一对密钥，把它的公钥作为 `[Peer]` 添加到服务器上，然后把客户端文件交给设备。** 为每台设备在单独的文件夹中运行同样的 `wg genkey` 命令。编辑 `wg0.conf` 之后，用 `systemctl restart wg-quick@wg0` 重启。

下面的客户端文件指向服务器。`203.0.113.10` 是文档地址：请把你服务器的 IPv4 放在那里，如控制面板中所示。`AllowedIPs = 0.0.0.0/0` 会把所有 IPv4 流量送入隧道。

每份设备指南都说明了如何导入该文件。可以先从 [指南中心](https://tunnelvps.com/zh/guides/ "Which WireGuard setup guide fits my device?") 开始，它链接了 iPhone、Android、Windows、macOS 和路由器的指南。[iPhone 指南](https://tunnelvps.com/zh/guides/wireguard-iphone/ "How do I set up WireGuard on an iPhone?") 最为详细。

*phone.conf，客户端文件（带占位值的示例）*

```ini
[Interface]
PrivateKey = PHONE_PRIVATE_KEY_HERE
Address = 10.8.0.2/32
DNS = DNS_RESOLVER_IP_HERE

[Peer]
PublicKey = SERVER_PUBLIC_KEY_HERE
Endpoint = 203.0.113.10:51820
AllowedIPs = 0.0.0.0/0
PersistentKeepalive = 25
```

## 应该保留哪些内容的副本？

**`/etc/wireguard` 文件夹，保存在服务器之外。** 所有套餐都不包含备份；结账时可加购每日备份（保留7天），收费为套餐价格的15%。不加购的话，请在服务器之外保存一份VPN配置和密钥。。重启、重装和删除通过控制台发出，由人工执行；重装会清空磁盘，包括VPN密钥。。

只要保有 `wg0.conf` 的副本和服务器密钥，重装后的服务器就能恢复同样的配置，设备无需新文件即可重新连接。如果你所在的网络屏蔽了 WireGuard，[WireGuard VPS 页面](https://tunnelvps.com/zh/wireguard-vps/ "Where can I rent a VPS for my own WireGuard VPN?") 指向 AmneziaWG 和 Outline。

## WireGuard 安装相关问题

### TunnelVPS 是否提供已预装 WireGuard 的服务器？

没有。目前不提供现成的VPN镜像；四个Debian和Ubuntu镜像是Amnezia列为其自建服务器官方支持的系统。。安装需要按本页的命令操作。

### 应该使用哪个端口？

任何空闲的 UDP 端口。示例使用 51820；同一个端口号要填入服务器的 `ListenPort`，以及每台设备的 `Endpoint`。

### 能为隧道添加 IPv6 吗？

可以。每台服务器都有一个路由的 IPv6 /64。在 IPv6 转发设置完成后，把一个 IPv6 隧道地址和 `::/0` 添加到客户端的 AllowedIPs 中。

### 有没有网页面板可以代替配置文件？

wg-easy 在 Docker 中运行 WireGuard，并提供网页管理页面，采用 AGPL-3.0 许可证。Docker 通过 `curl -sSL https://get.docker.com | sh` 安装，然后按照 wg-easy 文档操作。

### 如何查看哪些设备已连接？

运行 `wg show`。每个对等节点都会显示其最近的握手以及接收和发送的字节数。

**结论**

- **一条命令即可在每个 TunnelVPS 镜像上安装 WireGuard**；密钥、`wg0.conf` 和转发完成剩余的工作。
- **把 `/etc/wireguard` 备份到服务器之外**，因为重新安装会将其清除。

## 来源

1. [安装](https://www.wireguard.com/install/) — WireGuard (read 2026-11-16)
2. [快速入门](https://www.wireguard.com/quickstart/) — WireGuard (read 2026-11-16)
3. [协议与加密](https://www.wireguard.com/protocol/) — WireGuard (read 2026-11-16)
4. [wg-easy](https://github.com/wg-easy/wg-easy) — GitHub (read 2026-11-16)
5. [为文档保留的IPv4地址段（RFC 5737）](https://www.rfc-editor.org/rfc/rfc5737) — IETF (January 2010)

**需要一台用于 WireGuard 的服务器吗？** Solo 一人使用，按 12 个月计费时每月 $2.25。 [订购12个月的Solo](https://tunnelvps.com/app/checkout/?plan=solo&term=12m&from=help-install-wireguard-in-one-command&lang=zh) · [所有帮助页面](https://tunnelvps.com/zh/help/ "在哪里获得 TunnelVPS 服务器的帮助？")

---

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