# 如何为WireGuard添加设备？

> 5个步骤为WireGuard添加设备：为设备生成新密钥对，在服务器上添加[Peer]段，用wg syncconf或wg set应用，然后交付客户端文件或二维码。

- URL: https://tunnelvps.com/zh/guides/how-to-add-a-device-to-a-wireguard-server/
- 最后更新: 2026-11-16
- 发布者: TunnelVPS (https://tunnelvps.com)

一对新密钥、服务器上多一个对等节点、不影响其他已连接设备的重新加载，以及给新设备的客户端文件。

**简要回答 — 如何为WireGuard添加设备？**

以下说明如何为WireGuard添加设备：为其生成密钥对，在**TunnelVPS**服务器上添加一个带其公钥和空闲隧道地址的`[Peer]`，写入`wg0.conf`中，然后用`wg syncconf`应用，使其他设备保持连接。为该设备提供客户端文件或二维码。总共5个步骤。

**要点速览**

- **密钥**：每台设备一对新密钥，用`wg genkey`和`wg pubkey`生成。
- **服务器**：一个带设备公钥和唯一`/32`地址的`[Peer]`。
- **应用**：`wg syncconf`只改变有差异的部分；`wg set`实时添加对等节点。
- **移除**：`wg set wg0 peer <KEY> remove`，然后从文件中删除该段。

## 添加设备的5个步骤是什么？

*在TunnelVPS上为WireGuard服务器添加设备，5个步骤，依据wg(8)和wg-quick(8)手册*

| 步骤 | 位置 | 操作 |
| --- | --- | --- |
| 1 | 服务器 | 在单独的文件夹中为设备生成密钥对。 |
| 2 | 服务器 | 选择下一个空闲隧道地址，例如`10.8.0.4/32`。 |
| 3 | 服务器 | 将带公钥和该地址的`[Peer]`段追加到`wg0.conf`。 |
| 4 | 服务器 | 用`wg syncconf wg0 <(wg-quick strip wg0)`应用。 |
| 5 | 设备 | 导入客户端文件，或扫描二维码，然后连接。 |

## 为什么每台设备都需要自己的密钥？

**因为WireGuard将一个公钥绑定到一个对等节点，对应一个隧道地址和一个当前端点。**如果两部手机共用一个文件，服务器会在它们之间来回切换端点，两者都会丢包。

任何想了解如何为WireGuard添加设备的人，都应从这条规则入手。独立的密钥也让撤销变得干净：丢失的手机只失去自己的对等节点，笔记本仍能正常工作。[家庭共享指南](https://tunnelvps.com/zh/guides/how-to-share-your-vpn-server-with-family/ "How do I share a VPN server with my family?")将这一规则应用到整个家庭。

*为名为tablet的新设备生成密钥*

```bash
mkdir -p /etc/wireguard/clients/tablet
cd /etc/wireguard/clients/tablet
umask 077
wg genkey | tee privatekey | wg pubkey > publickey
```

## 新的[Peer]段中包含什么？

**设备的公钥和一行带其自身隧道地址的`AllowedIPs`。**在服务器上，`AllowedIPs`列出该设备可在隧道内使用的地址。请使用其他对等节点都没有的`/32`。

每个段上方的注释行（例如`# tablet`）能让较长的文件更易读。如果服务器运行`SaveConfig = true`，wg-quick会在关机时根据实时状态重写文件，因此请在接口关闭时编辑，或关闭该选项。

*要追加到/etc/wireguard/wg0.conf的段（占位密钥）*

```ini
[Peer]
# tablet
PublicKey = <TABLET_PUBLIC_KEY>
AllowedIPs = 10.8.0.4/32
```

## 如何在不影响其他设备的情况下应用更改？

**使用`wg syncconf`，它读取实时配置，且只改变有差异的部分。**wg-quick手册给出了格式`wg syncconf wgnet0 <(wg-quick strip wgnet0)`；若接口名为`wg0`，则在bash中使用下面这行。

完整的`systemctl restart wg-quick@wg0`也可以，但每台设备都会重新连接。快速测试时，`wg set`只把对等节点加入正在运行的接口；除非也写入文件，否则下次重启会丢失。

*实时应用新对等节点，或用命令添加*

```bash
wg syncconf wg0 <(wg-quick strip wg0)
# or, live only:
wg set wg0 peer <TABLET_PUBLIC_KEY> allowed-ips 10.8.0.4/32
wg show wg0
```

## 设备的客户端文件包含什么？

**其自身的私钥和地址，然后是服务器的公钥、地址和端口。**`203.0.113.10`下方是文档地址：请替换为控制台中的IPv4。`AllowedIPs = 0.0.0.0/0, ::/0`会让所有流量经过隧道。

手机可以将此文件作为二维码导入；参见[二维码指南](https://tunnelvps.com/zh/guides/how-to-make-a-wireguard-qr-code-for-a-phone/ "How do I make a WireGuard QR code for a phone?")。电脑和路由器则直接导入文件本身，如各[设备指南](https://tunnelvps.com/zh/guides/ "Which WireGuard setup guide fits my device?")所示。

*tablet.conf（示例值）*

```ini
[Interface]
PrivateKey = <TABLET_PRIVATE_KEY>
Address = 10.8.0.4/32
DNS = <DNS_RESOLVER_IP>

[Peer]
PublicKey = <SERVER_PUBLIC_KEY>
Endpoint = 203.0.113.10:51820
AllowedIPs = 0.0.0.0/0, ::/0
PersistentKeepalive = 25
```

## 如何检查新设备是否已连接？

**运行`wg show wg0`，并在新对等节点下查找最近的latest handshake。**随后transfer行开始统计收发的字节数。TunnelVPS于2026年11月16日查看了wg手册：`wg show`也可以只打印`latest-handshakes`或`transfer`。

如果没有出现握手，请检查`Endpoint`行、UDP端口和密钥。[流量指南](https://tunnelvps.com/zh/guides/how-to-monitor-wireguard-traffic/ "How do I monitor WireGuard traffic?")更详细地解读这些计数器。了解如何为WireGuard添加设备并检查连接，就能消除这项协议的大部分神秘感。

## 设备常见问题

### WireGuard能添加的设备数量有限制吗？

TunnelVPS不设限制。/24隧道子网约有250个地址；实际上限取决于CPU和每月流量。

### 能在设备上生成密钥，而不是在服务器上吗？

可以，此时私钥永远不会离开设备。只需把公钥复制到服务器。

### 如何移除设备？

运行`wg set wg0 peer <KEY> remove`，然后从`wg0.conf`中删除其段，使其不会在下次重启时恢复。

### 2026年为WireGuard添加设备，最佳方式是什么？

编辑`wg0.conf`，然后`wg syncconf`。该文件始终是谁有访问权限的唯一记录。

### 为什么新手机能连接却加载不了任何内容？

通常是服务器缺少IP转发或NAT规则，或客户端的DNS行有误。

**结论**

- **一台设备、一对密钥、一个`/32`**：保持服务器整洁的规则。
- **用`wg syncconf`应用**，确保其他人不会被断开。

## 来源

1. [wg(8)手册页](https://man7.org/linux/man-pages/man8/wg.8.html) — man7.org (read 2026-11-16)
2. [wg-quick(8)手册页](https://man7.org/linux/man-pages/man8/wg-quick.8.html) — man7.org (read 2026-11-16)
3. [WireGuard：快速入门](https://www.wireguard.com/quickstart/) — WireGuard (read 2026-11-16)
4. [为文档保留的IPv4地址段（RFC 5737）](https://www.rfc-editor.org/rfc/rfc5737) — IETF (January 2010)

**为每台设备留足空间** Home以每月5 TB的流量承载一个家庭的设备，12个月租期每月为$6.37。 [订购12个月的Home](https://tunnelvps.com/app/checkout/?plan=home&term=12m&image=ubuntu-24.04&from=guides-how-to-add-a-device-to-a-wireguard-server&lang=zh) · [制作二维码](https://tunnelvps.com/zh/guides/how-to-make-a-wireguard-qr-code-for-a-phone/ "如何为手机生成 WireGuard 二维码？")

---

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