# 如何为手机生成 WireGuard 二维码？

> 用 4 步为手机生成 WireGuard 二维码：安装 qrencode，在 SSH 终端中打印客户端文件，扫描，然后清除私钥。

- URL: https://tunnelvps.com/zh/guides/how-to-make-a-wireguard-qr-code-for-a-phone/
- 最后更新: 2026-11-16
- 发布者: TunnelVPS (https://tunnelvps.com)

手机的客户端文件在同一个 SSH 窗口中以二维码形式打印，由 WireGuard 应用扫描，之后不留任何残留文件。

**简要回答 — 如何为手机生成 WireGuard 二维码？**

要生成 WireGuard 二维码，请在 **TunnelVPS** 服务器上安装 `qrencode`，然后在 SSH 终端中运行 `qrencode -t ANSIUTF8 < phone.conf`。手机的客户端文件会以二维码形式显示在屏幕上。用 iPhone 或 Android 上的 WireGuard 应用扫描，然后清空终端。共 4 步，不到一分钟。

**要点速览**

- **工具**：`qrencode`，在 Debian 或 Ubuntu 上用 apt 安装。
- **终端二维码**：`-t ANSIUTF8` 用文本字符绘制二维码。
- **图片**：`-o phone.png` 写出 PNG，这是默认输出类型。
- **安全**：二维码包含手机的私钥；扫描后请清除。

## 生成二维码的 4 个步骤是什么？

*依据 qrencode(1) 手册，从 TunnelVPS 服务器为手机生成 WireGuard 二维码，共 4 步*

| 步骤 | 位置 | 操作 |
| --- | --- | --- |
| 1 | 服务器 | 用 `apt install qrencode` 安装该工具。 |
| 2 | 服务器 | 写入手机的客户端文件，例如 `/etc/wireguard/clients/phone.conf`。 |
| 3 | SSH 终端 | 运行 `qrencode -t ANSIUTF8 < phone.conf`，并用 WireGuard 应用扫描二维码。 |
| 4 | SSH 终端 | 运行 `clear`，并删除二维码的任何 PNG 副本。 |

## 为什么用 WireGuard 二维码而不是文件？

**因为手机无法方便地通过 SSH 接收配置文件，但摄像头一秒钟就能读取二维码。** iOS 和 Android 版 WireGuard 应用都可以从二维码导入隧道。

二维码就是完整的客户端文件，只是换了一种形式。内容不会经过电子邮件、聊天或云盘传输。[iPhone 指南](https://tunnelvps.com/zh/guides/wireguard-iphone/ "How do I set up WireGuard on an iPhone?") 和 [Android 指南](https://tunnelvps.com/zh/guides/wireguard-android/ "How do I set up WireGuard on Android?") 展示了各应用中的扫描界面。

## qrencode 如何把文件转换为二维码？

**未给出字符串时，它从标准输入读取文本，并以 `-t` 选定的输出类型绘制。** TunnelVPS 于 2026 年 11 月 16 日阅读了 qrencode 手册。类型包括 PNG（默认）、UTF8 和 ANSIUTF8。

ANSIUTF8 适用于大多数终端：它使用块字符和颜色代码。如果二维码显示错乱，请加宽窗口或改用 `-t UTF8`。`<` 符号把文件送入该命令。

*安装 qrencode，并以二维码形式打印手机的文件*

```bash
apt install qrencode
cd /etc/wireguard/clients
qrencode -t ANSIUTF8 < phone.conf
# after the scan:
clear
```

## 也可以把二维码保存为图片吗？

**可以：`-o` 把二维码写入文件，默认类型为 PNG。** 当手机不在运行 SSH 会话的电脑旁边时，这很有用。用 `scp` 将 PNG 复制到本地，在屏幕上显示，扫描后删除两份副本。

切勿把该图片发布到任何地方。任何拍下它的人，都能以该手机的身份连接，直到其对等节点从服务器上移除为止。

*把二维码写入 PNG，扫描后删除*

```bash
qrencode -o /root/phone.png < /etc/wireguard/clients/phone.conf
# copy it down from your computer:
#   scp root@203.0.113.10:/root/phone.png .
rm /root/phone.png
```

## 编码之前，文件中必须包含什么？

**完整的客户端配置：手机的私钥和地址，然后是服务器的公钥和端点。** 缺少 `Endpoint` 或密钥错误，会得到一个能导入但永远无法完成握手的隧道。

[添加设备指南](https://tunnelvps.com/zh/guides/how-to-add-a-device-to-a-wireguard-server/ "How do I add a device to WireGuard?") 会生成该文件，并在服务器上生成对应的 `[Peer]`。只有在对等节点上线之后再生成 WireGuard 二维码，这样手机就能立即测试。

## 没有终端也能生成 WireGuard 二维码吗？

**可以：wg-easy 在其网页上为每个客户端显示二维码。** 它适合多人共用的服务器。代价是需要保护一个网页管理页面。

[wg-easy 安装指南](https://tunnelvps.com/zh/guides/how-to-install-wg-easy-on-a-vps/ "How do I install wg-easy on a VPS?") 对此有详细说明。如果只有几部手机，SSH 窗口中的 `qrencode` 更快，而且不会在服务器上增加任何服务。

## 二维码相关问题

### WireGuard 二维码包含私钥吗？

包含。它保存整个客户端文件，包括私钥。请像对待密码一样对待它。

### 一个二维码能用在两部手机上吗？

可以被扫描两次，但两部手机会共用同一个对等节点，并互相挤掉连接。请为每部手机生成一个二维码。

### 2026 年生成 WireGuard 二维码的最佳方式是什么？

在 SSH 会话中使用 `qrencode -t ANSIUTF8`：密钥从不离开加密通道。

### 笔记本电脑能扫描二维码吗？

桌面应用改为导入 `.conf` 文件。如各设备指南所示，用 `scp` 复制该文件。

### 二维码对我的终端来说太大了。怎么办？

放大窗口或减小字号，或用 `-o` 写出 PNG，扫描后删除。

**结论**

- **`qrencode -t ANSIUTF8 < phone.conf`** 是把隧道装到手机上最快的方式。
- **清空屏幕并删除 PNG 副本**：二维码就是密钥。

## 来源

1. [qrencode(1) 手册页](https://manpages.debian.org/bookworm/qrencode/qrencode.1.en.html) — Debian (read 2026-11-16)
2. [WireGuard：安装与客户端应用](https://www.wireguard.com/install/) — WireGuard (read 2026-11-16)
3. [wg-easy代码仓库](https://github.com/wg-easy/wg-easy) — GitHub (read 2026-11-16)

**为家中每部手机准备的服务器** 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-make-a-wireguard-qr-code-for-a-phone&lang=zh) · [iPhone 设置](https://tunnelvps.com/zh/guides/wireguard-iphone/ "如何在 iPhone 上设置 WireGuard？")

---

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