你自己的VPN服务器 · WireGuard、Outline、AmneziaWG · 6个城市 · 用BTC, USDT, USDC, ETH, SOL, LTC, XMR付款
语言: 简体中文
获取VPN服务器

指南 · 在服务器上使用 qrencode

如何为手机生成 WireGuard 二维码?

手机的客户端文件在同一个 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。
3SSH 终端运行 qrencode -t ANSIUTF8 < phone.conf,并用 WireGuard 应用扫描二维码。
4SSH 终端运行 clear,并删除二维码的任何 PNG 副本。

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

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

二维码就是完整的客户端文件,只是换了一种形式。内容不会经过电子邮件、聊天或云盘传输。iPhone 指南 和 Android 指南 展示了各应用中的扫描界面。

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

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

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

安装 qrencode,并以二维码形式打印手机的文件
apt install qrencode
cd /etc/wireguard/clients
qrencode -t ANSIUTF8 < phone.conf
# after the scan:
clear

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

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

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

把二维码写入 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)
  1. qrencode(1) 手册页 — Debian (read 2026-11-16)
  2. WireGuard:安装与客户端应用 — WireGuard (read 2026-11-16)
  3. wg-easy代码仓库 — GitHub (read 2026-11-16)

为家中每部手机准备的服务器

Home 方案可供一家人的手机使用,每月 5 TB,按 12 个月计费时每月 $6.37。

12个月起每月2.25美元 · 无KYC

获取服务器