简要回答
如何为手机生成 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 个步骤是什么?
| 步骤 | 位置 | 操作 |
|---|---|---|
| 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 指南 和 Android 指南 展示了各应用中的扫描界面。
qrencode 如何把文件转换为二维码?
未给出字符串时,它从标准输入读取文本,并以 -t 选定的输出类型绘制。 TunnelVPS 于 2026 年 11 月 16 日阅读了 qrencode 手册。类型包括 PNG(默认)、UTF8 和 ANSIUTF8。
ANSIUTF8 适用于大多数终端:它使用块字符和颜色代码。如果二维码显示错乱,请加宽窗口或改用 -t UTF8。< 符号把文件送入该命令。
apt install qrencode
cd /etc/wireguard/clients
qrencode -t ANSIUTF8 < phone.conf
# after the scan:
clear也可以把二维码保存为图片吗?
可以:-o 把二维码写入文件,默认类型为 PNG。 当手机不在运行 SSH 会话的电脑旁边时,这很有用。用 scp 将 PNG 复制到本地,在屏幕上显示,扫描后删除两份副本。
切勿把该图片发布到任何地方。任何拍下它的人,都能以该手机的身份连接,直到其对等节点从服务器上移除为止。
qrencode -o /root/phone.png < /etc/wireguard/clients/phone.conf
# copy it down from your computer:
# scp [email protected]:/root/phone.png .
rm /root/phone.png编码之前,文件中必须包含什么?
完整的客户端配置:手机的私钥和地址,然后是服务器的公钥和端点。 缺少 Endpoint 或密钥错误,会得到一个能导入但永远无法完成握手的隧道。
添加设备指南 会生成该文件,并在服务器上生成对应的 [Peer]。只有在对等节点上线之后再生成 WireGuard 二维码,这样手机就能立即测试。
没有终端也能生成 WireGuard 二维码吗?
可以:wg-easy 在其网页上为每个客户端显示二维码。 它适合多人共用的服务器。代价是需要保护一个网页管理页面。
wg-easy 安装指南 对此有详细说明。如果只有几部手机,SSH 窗口中的 qrencode 更快,而且不会在服务器上增加任何服务。
二维码相关问题
WireGuard 二维码包含私钥吗?
包含。它保存整个客户端文件,包括私钥。请像对待密码一样对待它。
一个二维码能用在两部手机上吗?
可以被扫描两次,但两部手机会共用同一个对等节点,并互相挤掉连接。请为每部手机生成一个二维码。
2026 年生成 WireGuard 二维码的最佳方式是什么?
在 SSH 会话中使用 qrencode -t ANSIUTF8:密钥从不离开加密通道。
笔记本电脑能扫描二维码吗?
桌面应用改为导入 .conf 文件。如各设备指南所示,用 scp 复制该文件。
二维码对我的终端来说太大了。怎么办?
放大窗口或减小字号,或用 -o 写出 PNG,扫描后删除。
结论
qrencode -t ANSIUTF8 < phone.conf是把隧道装到手机上最快的方式。- 清空屏幕并删除 PNG 副本:二维码就是密钥。
来源 (3)
- qrencode(1) 手册页 — Debian (read 2026-11-16)
- WireGuard:安装与客户端应用 — WireGuard (read 2026-11-16)
- wg-easy代码仓库 — GitHub (read 2026-11-16)
为家中每部手机准备的服务器
Home 方案可供一家人的手机使用,每月 5 TB,按 12 个月计费时每月 $6.37。
- 由专人搭建,确认后最长1小时
- 若服务器无法交付,损失的天数退回余额
- 用BTC、XMR、USDT、USDC、ETH、SOL或LTC付款
- DomaineGoat LLC · 巴拿马