# Làm thế nào để thêm thiết bị vào WireGuard?

> Cách thêm thiết bị vào WireGuard trong 5 bước: tạo cặp khóa mới, khối [Peer] trên máy chủ, wg syncconf hoặc wg set, rồi tệp client hoặc mã QR.

- URL: https://tunnelvps.com/vi/guides/how-to-add-a-device-to-a-wireguard-server/
- Cập nhật lần cuối: 2026-11-16
- Đơn vị phát hành: TunnelVPS (https://tunnelvps.com)

Một cặp khóa mới, thêm một peer trên máy chủ, tải lại cấu hình mà các thiết bị khác vẫn kết nối, và một tệp client cho thiết bị mới.

**Trả lời nhanh — Làm thế nào để thêm thiết bị vào WireGuard?**

Đây là cách thêm thiết bị vào WireGuard: tạo cặp khóa cho nó, thêm một khối `[Peer]` với khóa công khai và một địa chỉ đường hầm trống vào `wg0.conf` trên máy chủ **TunnelVPS**, rồi áp dụng bằng `wg syncconf` để các thiết bị khác vẫn kết nối. Gửi cho thiết bị một tệp client hoặc mã QR. Tổng cộng là 5 bước.

**Tóm tắt**

- **Khóa**: một cặp mới cho mỗi thiết bị, tạo bằng `wg genkey` và `wg pubkey`.
- **Máy chủ**: một `[Peer]` với khóa công khai của thiết bị và một địa chỉ `/32` duy nhất.
- **Áp dụng**: `wg syncconf` chỉ thay đổi những gì khác biệt; `wg set` thêm một peer trực tiếp.
- **Gỡ bỏ**: `wg set wg0 peer <KEY> remove`, rồi xóa khối đó khỏi tệp.

## 5 bước để thêm thiết bị là gì?

*Thêm thiết bị vào máy chủ WireGuard trên TunnelVPS, 5 bước, theo sách hướng dẫn wg(8) và wg-quick(8)*

| Bước | Ở đâu | Cần làm gì |
| --- | --- | --- |
| 1 | Máy chủ | Tạo một cặp khóa cho thiết bị trong một thư mục riêng. |
| 2 | Máy chủ | Chọn địa chỉ đường hầm trống tiếp theo, chẳng hạn `10.8.0.4/32`. |
| 3 | Máy chủ | Thêm một khối `[Peer]` với khóa công khai và địa chỉ đó vào `wg0.conf`. |
| 4 | Máy chủ | Áp dụng bằng `wg syncconf wg0 <(wg-quick strip wg0)`. |
| 5 | Thiết bị | Nhập tệp client, hoặc quét dưới dạng mã QR, rồi kết nối. |

## Vì sao mỗi thiết bị cần khóa riêng?

**Vì WireGuard gắn một khóa công khai với một peer, một địa chỉ đường hầm và một endpoint hiện tại.** Nếu hai điện thoại dùng chung một tệp, máy chủ sẽ liên tục đổi endpoint giữa chúng và cả hai đều rớt gói.

Ai hỏi cách thêm thiết bị vào WireGuard nên bắt đầu từ quy tắc này. Khóa riêng cũng làm việc thu hồi gọn gàng: điện thoại bị mất chỉ mất peer của nó; laptop vẫn hoạt động. [Hướng dẫn chia sẻ với gia đình](https://tunnelvps.com/vi/guides/how-to-share-your-vpn-server-with-family/ "How do I share a VPN server with my family?") áp dụng quy tắc này cho cả hộ.

*Tạo khóa cho một thiết bị mới tên là tablet*

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

## Khối [Peer] mới chứa gì?

**Khóa công khai của thiết bị và một dòng `AllowedIPs` với địa chỉ đường hầm riêng của nó.** Trên máy chủ, `AllowedIPs` liệt kê các địa chỉ mà thiết bị đó được dùng trong đường hầm. Hãy dùng một `/32` mà không peer nào khác có.

Một dòng chú thích phía trên mỗi khối, chẳng hạn `# tablet`, giữ cho tệp dài vẫn dễ đọc. Nếu máy chủ chạy `SaveConfig = true`, wg-quick sẽ ghi lại tệp từ trạng thái trực tiếp khi tắt máy, nên hãy sửa tệp khi giao diện đang tắt hoặc tắt tùy chọn đó đi.

*Khối cần thêm vào /etc/wireguard/wg0.conf (khóa giả)*

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

## Làm thế nào để áp dụng thay đổi mà không làm đứt các thiết bị khác?

**Dùng `wg syncconf`, đọc cấu hình trực tiếp và chỉ thay đổi những gì khác biệt.** Sách hướng dẫn wg-quick đưa ra dạng `wg syncconf wgnet0 <(wg-quick strip wgnet0)`; với một giao diện tên là `wg0`, dùng dòng dưới đây trong bash.

Một `systemctl restart wg-quick@wg0` đầy đủ cũng được, nhưng mọi thiết bị sẽ kết nối lại. Để thử nhanh, `wg set` thêm peer vào giao diện đang chạy; nó sẽ mất khi khởi động lại trừ khi cũng có trong tệp.

*Áp dụng peer mới trực tiếp, hoặc thêm bằng lệnh*

```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
```

## Tệp client của thiết bị chứa gì?

**Khóa riêng và địa chỉ của chính nó, rồi khóa công khai, địa chỉ và cổng của máy chủ.** `203.0.113.10` bên dưới là một địa chỉ tài liệu: hãy thay bằng IPv4 lấy từ bảng điều khiển. `AllowedIPs = 0.0.0.0/0, ::/0` gửi toàn bộ lưu lượng qua đường hầm.

Điện thoại nhập tệp này dưới dạng mã QR; xem [hướng dẫn mã QR](https://tunnelvps.com/vi/guides/how-to-make-a-wireguard-qr-code-for-a-phone/ "How do I make a WireGuard QR code for a phone?"). Máy tính và router nhập chính tệp đó, như [hướng dẫn thiết bị](https://tunnelvps.com/vi/guides/ "Which WireGuard setup guide fits my device?") chỉ ra.

*tablet.conf (giá trị giả)*

```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
```

## Làm thế nào để kiểm tra thiết bị mới đã kết nối?

**Chạy `wg show wg0` và tìm một latest handshake gần đây dưới peer mới.** Dòng transfer khi đó bắt đầu đếm số byte nhận và gửi. TunnelVPS đọc sách hướng dẫn wg ngày 16 tháng 11 năm 2026: `wg show` cũng có thể chỉ in `latest-handshakes` hoặc `transfer`.

Nếu không có handshake nào xuất hiện, hãy kiểm tra dòng `Endpoint`, cổng UDP và các khóa. [Hướng dẫn lưu lượng](https://tunnelvps.com/vi/guides/how-to-monitor-wireguard-traffic/ "How do I monitor WireGuard traffic?") đọc các bộ đếm này chi tiết hơn. Biết cách thêm thiết bị vào WireGuard và kiểm tra nó sẽ gỡ bớt phần bí ẩn của giao thức.

## Câu hỏi về thiết bị

### Có giới hạn số thiết bị tôi có thể thêm vào WireGuard không?

TunnelVPS không đặt giới hạn nào. Một subnet đường hầm /24 cho khoảng 250 địa chỉ; CPU và lưu lượng hằng tháng mới là giới hạn thực tế.

### Tôi có thể tạo khóa trên thiết bị thay vì trên máy chủ không?

Có, và khi đó khóa riêng không bao giờ rời khỏi thiết bị. Chỉ sao chép khóa công khai của nó lên máy chủ.

### Làm sao để gỡ một thiết bị?

Chạy `wg set wg0 peer <KEY> remove`, rồi xóa khối của nó khỏi `wg0.conf` để nó không quay lại sau lần khởi động lại kế tiếp.

### Cách tốt nhất để thêm thiết bị vào WireGuard trong năm 2026 là gì?

Sửa `wg0.conf`, rồi `wg syncconf`. Tệp đó vẫn là bản ghi duy nhất về ai có quyền truy cập.

### Vì sao điện thoại mới kết nối được nhưng không tải được gì?

Thường là thiếu IP forwarding hoặc quy tắc NAT trên máy chủ, hoặc dòng DNS của client bị sai.

**Kết luận**

- **Một thiết bị, một cặp khóa, một `/32`**: quy tắc giữ cho máy chủ gọn gàng.
- **Áp dụng bằng `wg syncconf`** để không làm gián đoạn ai khác.

## Nguồn

1. [Trang hướng dẫn wg(8)](https://man7.org/linux/man-pages/man8/wg.8.html) — man7.org (read 2026-11-16)
2. [Trang hướng dẫn wg-quick(8)](https://man7.org/linux/man-pages/man8/wg-quick.8.html) — man7.org (read 2026-11-16)
3. [WireGuard: Bắt đầu nhanh (Quick Start)](https://www.wireguard.com/quickstart/) — WireGuard (read 2026-11-16)
4. [Các khối địa chỉ IPv4 dành cho tài liệu (RFC 5737)](https://www.rfc-editor.org/rfc/rfc5737) — IETF (January 2010)

**Chỗ cho mọi thiết bị** Home phục vụ các thiết bị của một hộ gia đình với 5 TB mỗi tháng, ở mức $6.37 mỗi tháng với 12 tháng. [Đặt Home với 12 tháng](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=vi) · [Tạo mã QR](https://tunnelvps.com/vi/guides/how-to-make-a-wireguard-qr-code-for-a-phone/ "Làm thế nào để tạo mã QR WireGuard cho điện thoại?")

---

TunnelVPS: TunnelVPS cho thuê máy chủ KVM Linux để làm VPN cá nhân (WireGuard, Outline hoặc AmneziaWG) tại New York, Dallas, Los Angeles, London, Amsterdam và Frankfurt, thanh toán bằng tiền điện tử, máy chủ VPN không cần KYC và không cần giấy tờ tùy thân. 5 gói từ 2 đến 16 GB RAM và từ 2 đến 6 TB lưu lượng mỗi tháng có cùng giá ở cả sáu thành phố; với kỳ hạn 12 tháng, mỗi gói có giá thấp hơn ít nhất 25% so với một gói tương đương có tên của một nhà cung cấp không KYC nhận tiền điện tử, giá đọc ngày 16 tháng 11 năm 2026. Đơn vị vận hành là DomaineGoat LLC, Panama.
