ByteNoteByteNote
vpn2qr:一条命令把 VPS 变成 Reality 节点,扫码导入手机

字节笔记本

2026年9月14日

vpn2qr:一条命令把 VPS 变成 Reality 节点,扫码导入手机

API中转
¥120

在 VPS 上手搓代理配置,改 JSON、生成密钥、开防火墙,一套下来小半小时。vpn2qr 把它压成一条命令:SSH 进服务器执行一行脚本,装好 Xray、生成 VLESS+Reality 配置,二维码直接打在终端里,手机扫码就能导入。

项目简介

vpn2qr(www222fff/vpn2qr)是今年 8 月开源的 Shell 项目,MIT 协议,目前 227 stars。整个项目核心就是一份 151 行的 install.sh,没有面板、没有依赖服务,跑完只留一个能扫的二维码。

定位很克制:给已经有一台 VPS 的人省掉每次重复配置的时间。README 里写明仅供个人学习与自用,请遵守当地法律及服务商条款。

一条命令背后发生了什么

SSH 登录 VPS 后执行:

bash
curl -fsSL https://raw.githubusercontent.com/www222fff/vpn2qr/main/install.sh | bash

脚本会依次完成这些事:

  1. 装好 curl、openssl、ufw、qrencode 等依赖(适配 Debian/Ubuntu)
  2. 调 Xray 官方安装脚本装上或更新 Xray
  3. 生成 UUID 和 Reality 密钥对,写入 VLESS+Reality 入站配置,默认监听 443 端口
  4. systemd 启动服务并设置开机自启
  5. 拼出 vless:// 分享链接,用 qrencode 生成二维码:一张 PNG 存到 /root/onexray-reality.png,一张以字符画形式直接打在终端

端口、节点名、SNI 都可以通过环境变量覆盖。介意 curl 直跑远程脚本的话,先下载再执行,顺便把配置改了:

bash
curl -fsSL https://raw.githubusercontent.com/www222fff/vpn2qr/main/install.sh -o install.sh
# 按需改 PORT、NODE_NAME、SNI 三个变量
PORT=8443 NODE_NAME=my-node bash install.sh

支持扫码导入的客户端

README 列了四类:

  • OneXray:iOS / Android 都有
  • Shadowrocket 小火箭:iOS,2023 年后的版本支持 Reality
  • Clash Meta / Mihomo 内核:Clash Verge、FlClash、ClashMetaForAndroid 等;原版 Clash 内核不支持 Reality,注意别用错
  • v2rayN / v2rayNG:新版本已支持 Reality

安全提醒

这部分 README 原文写得很实在:

  • UUID、密钥、导入链接、二维码等同密码,不要发到公开聊天群,更不要提交进 Git 仓库
  • 仅供个人学习与自用,请遵守当地法律及服务商条款
  • 仓库本身不含任何真实节点凭据

补两条使用层面的:

  • 二维码扫完就关,终端历史里留下的 vless:// 链接记得清理,那个链接包含全部连接凭据
  • 脚本默认用 ufw 管防火墙,如果你服务器上有自己的防火墙方案,跑完后核对一下端口放行规则

项目链接

分享: