Qv2ray下载使用教程：订阅与v2ray核心配置，官网已易主
更新于
Qv2ray 在 2021 年 8 月 17 日停止维护，最后一个版本是 v2.7.0，此后没有任何新版。 它是一个图形界面外壳，安装包里不带 v2ray 核心，装完必须另外下载核心才能连接。最常见的坑是装了最新的 v2ray v5，结果 Qv2ray 一直报"核心退出码 2"——它只认 v4 版本或 Xray。
还要先提醒一句：搜索结果里的 qv2ray.net 已经不是官网了。这个域名现在挂在停放服务上，浏览器打开会跳到一个"人机验证后自动下载软件"的页面，不要从那里下载任何东西。原版文件只认下面的 GitHub 地址。
Qv2ray 官网和 GitHub 在哪？先看停更状态
| 你要找的 | 地址 | 现在的状态 |
|---|---|---|
| Qv2ray GitHub | Qv2ray/Qv2ray | 源码仍在，README 首行写着「本项目已不再维护」 |
| 最后正式版 | v2.7.0 发布页 | 2021-08-17，Windows / Linux / macOS 四个文件 |
| 官方文档源文件 | qv2ray.github.io 仓库 | 只能在 GitHub 上看 Markdown 原文 |
| 原官网 | qv2ray.net | ⚠️ 已停放，跳转到诱导下载页 |
v2.7.0 的发布说明只有一段话：4 月开发者内部出现矛盾后，四个月里没有活跃开发者维护，所以决定停止。仓库没有被归档，之后 dev 分支还有过几次构建脚本的提交，但没有发过任何新安装包。网上标着"Qv2ray 3.0""Qv2ray 2026 最新版"的下载，都不是这个项目发布的。
qv2ray.net 为什么不能再打开
本站 2026 年 10 月 19 日用浏览器访问 qv2ray.net，页面被跳到 safedomainguard.org 下面的一个 "Security Check" 页，按钮写着点了之后"继续自动下载软件"。域名的 DNS 已经指向停放商 ParkLogic，网页存档显示 2023 年中起它就不再是文档站。
原来的 qv2ray.github.io 也会 301 跳到这个域名，所以两个旧官网入口现在都通向同一个停放页。老教程里那句 curl https://qv2ray.net/debian/pubkey.gpg | sudo gpg --dearmor ... 也别再照着跑：它会把一个现在不归官方控制的域名下载的内容导入成系统信任的软件源密钥。
Qv2ray 下载：Windows、Linux、Mac 安装包
下列四个文件从 Qv2ray/Qv2ray 官方 GitHub Release v2.7.0 原样下载，本站镜像不改文件名、不改内容。2021 年的 Release 没有官方 SHA-256，本站核对了文件大小与 GitHub API 一致，并在 2026 年 10 月 19 日从镜像域名回读，确认与原文件 SHA-256 相同。
| 系统 | 文件 | 大小 | 官方原始下载 | 本站镜像 |
|---|---|---|---|---|
| Windows 10/11 x64 安装版 | Windows-Installer.exe | 43.8 MiB | GitHub | 下载安装版 |
| Windows x64 免安装版 | Windows.7z | 41.1 MiB | GitHub | 下载 7z 包 |
| Linux x86_64 | linux-x64.AppImage | 38.0 MiB | GitHub | 下载 AppImage |
| macOS（Intel） | macOS-x64.dmg | 16.1 MiB | GitHub | 下载 dmg |
几个要先知道的限制：
- 没有 32 位和 ARM 版。 v2.7.0 正式版只给了 Windows x64、Linux x64 和 Intel Mac 三种。Windows 32 位最后一次出现在 2.7.0-pre1 预发布版里
- Windows 免安装版是 7z 格式，Windows 11 新版资源管理器能直接解压，老系统需要 7-Zip。解压后里面是
qv2ray.exe、Qt5 运行库和vc_redist.x64.exe，没有 v2ray.exe - Mac 只有 Intel 版，Apple 芯片的 Mac 要靠 Rosetta 转译，本站没有在 M 系列 Mac 上实测。dmg 没有经过苹果公证，首次打开需要在"系统设置 → 隐私与安全性"里点"仍要打开"
- Homebrew 已在 2025 年 12 月删除 qv2ray 的 cask，
brew install qv2ray现在装不上
Qv2ray 2.7.0 四个安装包的 SHA-256
| 文件 | SHA-256 |
|---|---|
| Qv2ray-v2.7.0-Windows-Installer.exe | ee01cb9c6ef3e6c24a78608f5c3199707291610004ef1b4af986eaf7312cb051 |
| Qv2ray-v2.7.0-Windows.7z | b914b41d015facb84b1eceeff013e1187242b3c6f73539fbcd9a8aaf5d6942e5 |
| Qv2ray-v2.7.0-linux-x64.AppImage | 7df26fa08277ecd077651a9d19da8fa90b2da17edddf13315a581c502f0a0360 |
| Qv2ray-v2.7.0-macOS-x64.dmg | 457e1b70989515ddb9a1bd4c0635d4ea7d5eda17435bd63908151621b1235a97 |
Qv2ray Linux / Ubuntu 怎么装
Linux 上推荐直接用上面的 AppImage，它不依赖发行版的软件源，下载后给执行权限就能运行：
chmod +x Qv2ray-v2.7.0-linux-x64.AppImage
./Qv2ray-v2.7.0-linux-x64.AppImage
Ubuntu 22.04 及更新版本双击没反应，多半是缺 FUSE 2，AppImage 需要它才能挂载。Ubuntu 22.04 装 libfuse2，24.04 起包名改成了 libfuse2t64：
# Ubuntu 22.04
sudo apt install libfuse2
# Ubuntu 24.04 及以后
sudo apt install libfuse2t64
其他几种安装途径的现状（2026 年 10 月核对）：
| 途径 | 现状 |
|---|---|
sudo apt install qv2ray | Ubuntu 和 Debian 官方源都没有这个包 |
| Qv2ray 自建 APT 源 | 地址挂在已停放的 qv2ray.net 上，别再添加；仓库里也只有 2.7.0 预发布版的 deb |
Snap（sudo snap install qv2ray） | stable 频道是 2.7.0，2023 年 5 月后没再更新 |
| Flathub | 停在 2.0.1，非常旧 |
| Arch AUR / archlinuxcn | qv2ray 包仍是 2.7.0 |
Linux 上 Qv2ray 的"设置系统代理"只对 GNOME 和 KDE 生效，而且官方文档自己也说 KDE 的系统代理很多应用不认。终端里的命令需要手动设置环境变量，见下面的使用教程。
v2ray 核心怎么选：v5 不能用，装 v4.45.2
Qv2ray 启动前会用 核心 --version 检查核心，连接时用 核心 -config 配置文件 启动。这是 v2ray v4 的命令格式。v2ray v5 改成了 v2ray run 这种子命令写法，不再认 --version。
本站在 Windows 上把 Qv2ray 用到的两条命令分别交给三个核心跑了一遍：
| 核心 | --version | -test -config | 能否配 Qv2ray |
|---|---|---|---|
| v2fly v2ray v4.45.2 | 正常输出版本号 | Configuration OK | ✅ 推荐 |
| Xray 26.3.27 | 正常输出版本号 | Configuration OK（附弃用提示） | ✅ 可用，v4 兼容模式 |
| v2fly v2ray v5.53.0 | flag provided but not defined | 退出码 2 | ❌ 报"核心退出码 2" |
所以搜"Qv2ray v2ray 核心"的答案是：装 v2fly v4.45.2。 它是 v4 的最后一版，发布于 2022 年 6 月，也已经不再更新。想用 Xray 的新协议可以换 Xray，但 Qv2ray 界面并不认识 Reality 这些新参数，换核心解决不了界面问题，原因见下文"订阅"一节。
下列 v2ray 核心从 v2fly/v2ray-core 官方 GitHub Release v4.45.2 下载，每个文件都与官方 .dgst 里的 SHA-256 核对一致：
| 系统 | 官方原始下载 | 本站镜像 |
|---|---|---|
| Windows x64 | v2ray-windows-64.zip | 下载 |
| Windows 32 位 | v2ray-windows-32.zip | 下载 |
| Windows ARM64 | v2ray-windows-arm64-v8a.zip | 下载 |
| Linux x64 | v2ray-linux-64.zip | 下载 |
| Linux ARM64 | v2ray-linux-arm64-v8a.zip | 下载 |
| macOS Intel | v2ray-macos-64.zip | 下载 |
| macOS Apple 芯片 | v2ray-macos-arm64-v8a.zip | 下载 |
核心要和 Qv2ray 的架构一致：Qv2ray 只有 x64 版，Windows 和 Linux 上就选 x64 的核心，别把 arm64 看成 amd64。Mac 上 Qv2ray 走 Rosetta 时，也选 Intel 核心更稳妥。
v2ray-core v4.45.2 七个文件的 SHA-256
| 文件 | SHA-256 |
|---|---|
| v2ray-windows-64.zip | 1cc5065fe9a7005d52c8df8c89f54d656eec176a6c21ad55109f8c2a48dd0adc |
| v2ray-windows-32.zip | 32ba955a9be1b09aeb48e2c05b932c2e6f3a56fc302ca38c67d62b9e05cd7549 |
| v2ray-windows-arm64-v8a.zip | 602f1ac9186cdd5ec628bec5a8e4bbacfd5402bedd8b76adf6e80dd2c2cd8a66 |
| v2ray-linux-64.zip | 5530c1ce251f1f668db8e315afb18dc204c768231780a4b1e5fbfbc3fe20a749 |
| v2ray-linux-arm64-v8a.zip | 4c43883b2c42f707abe3aefd3d85ca7433b00cdbd1276927364cb91e31a17735 |
| v2ray-macos-64.zip | 2ff3037c0b17cd5f2fc109a77ab25a1c4f408a570deec340b4ec032db26d7024 |
| v2ray-macos-arm64-v8a.zip | fa7ddf6863091b6b7558ca8a4430b2ed5b12d345cfd7df983ec7a4a02bf8997a |
Qv2ray 使用教程：从装核心到连上节点
下面的菜单名取自 Qv2ray 官方中文文档。本站没有在真机上把整套流程从装到连跑一遍，个别按钮位置以你实际看到的界面为准。
第一步：安装 Qv2ray
- Windows：安装版双击
Windows-Installer.exe一路下一步；免安装版把 7z 完整解压到一个固定文件夹，比如D:\Qv2ray。第一次运行如果提示缺VCRUNTIME140.dll，运行包里自带的vc_redist.x64.exe装一下 VC++ 运行库 - Linux：用上一节的 AppImage
- Mac：打开 dmg 把 Qv2ray 拖进"应用程序"
第二步：放好 v2ray 核心
把 v4.45.2 核心的 zip 解压到一个固定位置，解压后的文件夹里要能看到 v2ray（Windows 是 v2ray.exe）、v2ctl、geoip.dat、geosite.dat 四样东西。官方推荐的位置：
| 系统 | 推荐放核心的位置 |
|---|---|
| Windows 免安装版 | qv2ray.exe 旁边的 config\vcore 文件夹 |
| Windows 安装版 | 自己建一个固定文件夹，比如 C:\v2ray-core，别放桌面或"下载" |
| Linux | ~/.config/qv2ray/vcore，解压后执行 chmod +x v2ray v2ctl |
| Mac | ~/Library/Preferences/qv2ray/vcore 或任意固定文件夹，同样要 chmod +x |
然后打开 Qv2ray，进 首选项 → 内核设置：
- 核心可执行文件路径：选到
v2ray.exe（Linux/Mac 是v2ray）这个文件本身 - V2Ray 资源目录：选到
geoip.dat所在的文件夹 - 点 检查 V2Ray 核心设置，提示里出现
V2Ray 4.45.2就说明成了
⚠️ 核心路径千万别选成 qv2ray.exe 自己，官方文档专门提醒过这个错误。
第三步：导入订阅
机场给的"V2Ray 订阅""通用订阅"一般就是 Qv2ray 能读的格式。操作：
- 主窗口点 分组，打开组编辑器，左下角点加号新建一个分组
- 切到 订阅设置，勾选 此组是一个订阅
- 订阅地址 粘贴订阅链接；订阅类型 先保持默认的 Basic Base64
- 点 更新订阅，节点列表出现后点 确定
Qv2ray 的订阅类型只有 Basic Base64 和 SIP008 两种，不认 Clash 的 YAML 订阅。机场后台如果只给了 Clash 订阅，换成后台里的"V2Ray / Shadowrocket / 通用"那个链接；更新失败、提示没有节点时，多半就是格式不对。
如果手里只有单个节点链接（vmess://、vless://、ss:// 开头的），点主窗口的 导入，选 分享链接，一行一条粘贴进去即可。
第四步：连接并设置系统代理
双击一个节点连接，然后在托盘图标右键 系统代理 → 启用系统代理，浏览器就会走代理。Qv2ray 默认在本机开两个端口：
| 入站 | 默认地址 |
|---|---|
| SOCKS5 | 127.0.0.1:1089 |
| HTTP | 127.0.0.1:8889 |
不读系统代理的程序（Linux 终端、部分游戏和开发工具），手动填上面的地址。Linux 终端临时走代理：
export http_proxy="http://127.0.0.1:8889"
export https_proxy="http://127.0.0.1:8889"
分流规则在 首选项 → 路由设置里，默认就有"国内直连"的选项，一般不用动。
Qv2ray 配置文件在哪
Qv2ray 自己的配置（节点、分组、首选项）存在一个叫 qv2ray 的配置文件夹里，常见位置：
| 系统 | 配置文件夹 |
|---|---|
| Windows 免安装版 | qv2ray.exe 旁边的 config 文件夹 |
| Windows 安装版 | C:\Users\你的用户名\AppData\Local\qv2ray |
| Linux | ~/.config/qv2ray |
| Mac | ~/Library/Preferences/qv2ray |
每次连接时，Qv2ray 会把实际交给 v2ray 核心的完整配置写到这个文件夹下的 generated/config.gen.json。连不上时打开这个文件看出站部分，比在界面里一项项翻要快。想重置 Qv2ray，退出程序后把整个配置文件夹改名备份即可。
如果你手里有一份写好的 v2ray config.json，可以在新建连接时选 高级 → 导入现有配置，或在 JSON 编辑器里直接粘贴。官方文档提醒：用了复杂配置后，首选项里的路由设置会被忽略。
Qv2ray 支持哪些节点？Reality、Hysteria2 都不行
这是现在用 Qv2ray 最容易卡住的地方。v2.7.0 是 2021 年的代码，之后出现的协议它全都不认识：
| 节点类型 | Qv2ray 2.7.0 | 说明 |
|---|---|---|
| VMess（TCP / WS / gRPC，含 TLS） | ✅ | 内置支持 |
| VLESS + TLS | ✅ | 内置支持 |
| VLESS + Reality | ❌ | 分享链接里的 pbk、sid、fp 参数解析不了，界面也没有 Reality 选项 |
| Shadowsocks（常规加密） | ✅ | 内置；SS2022 要换 Xray 核心 |
| SS + obfs/v2ray-plugin 插件、SSR | 需插件 | 装 QvPlugin-SS / QvPlugin-SSR |
| Trojan / Trojan-Go / NaiveProxy | 需插件 | 装对应 QvPlugin |
| Hysteria2、TUIC、AnyTLS | ❌ | 没有支持，也没有插件 |
现在不少机场的主力节点已经是 VLESS Reality 或 Hysteria2。订阅导进去只出来一部分节点、或者全部超时，先对照这张表，不是你操作错了。
Qv2ray 插件下载
插件从 Qv2ray 组织下各插件仓库的 v3.0.0 正式版 Release 原样下载（2021-08-17，与 Qv2ray 2.7.0 同一天）。Qv2ray 2.7.0 正式版是 Qt5 构建，所以只镜像了 Qt5 版本，文件名带 Qt6 的不要装。
用法：主窗口打开 插件管理器，点 打开本地插件目录，把下载的 .dll（Windows）或 .so（Linux/Mac）放进去，重启 Qv2ray 后勾选启用。
| 插件 | 用途 | Windows x64 | Linux x64 | macOS x64 |
|---|---|---|---|---|
| QvPlugin-Trojan | Trojan | GitHub · 镜像 | GitHub · 镜像 | GitHub · 镜像 |
| QvPlugin-TrojanGo | Trojan-Go | GitHub · 镜像 | GitHub · 镜像 | GitHub · 镜像 |
| QvPlugin-SS | SS 插件模式、旧加密 | GitHub · 镜像 | GitHub · 镜像 | GitHub · 镜像 |
| QvPlugin-SSR | SSR | GitHub · 镜像 | GitHub · 镜像 | GitHub · 镜像 |
| QvPlugin-NaiveProxy | NaiveProxy | GitHub · 镜像 | GitHub · 镜像 | GitHub · 镜像 |
| QvPlugin-Command | 连接前后执行命令 | GitHub · 镜像 | GitHub · 镜像 | GitHub · 镜像 |
另外六个 Windows 32 位插件（Windows-x86.dll）也已镜像，路径相同，把文件名里的 x64 换成 x86 即可。不过 Qv2ray 2.7.0 正式版本身没有 32 位版，它们只对旧的 32 位预发布版有用。
常见报错怎么排查
| 现象 | 先查什么 | 处理 |
|---|---|---|
| 提示"V2Ray 核心退出码 2" | 核心是不是 v5 | 换成 v4.45.2 或 Xray |
| 提示找不到核心 / 无法打开核心文件 | 路径选的是文件夹还是文件 | 核心路径要选到 v2ray.exe 本身 |
| 提示 No geoip.dat in assets path | 资源目录 | 选到 geoip.dat 所在的文件夹 |
| 核心与平台不兼容 | 是否下成了 arm64 | Windows / Linux 选 64 位的 x64 核心 |
| Linux 提示核心不可执行 | 执行权限 | chmod +x v2ray v2ctl |
| 订阅更新后没有节点 | 订阅格式 | 换机场后台的 V2Ray / 通用订阅，别用 Clash 订阅 |
| 节点导入了但全部超时 | 节点协议 | 对照上面的协议表，Reality、Hysteria2 用不了 |
| 已经连上，浏览器还是打不开 | 系统代理是否开启 | 托盘里启用系统代理，或给浏览器手动填 127.0.0.1:8889 |
Qv2ray 替代软件：现在新装选哪个
Qv2ray 停更快五年了，新协议用不了、系统兼容性问题也不会再有人修。已经在用、节点也能连的可以继续用；新装的建议直接换下面这些仍在更新的客户端，订阅一般都能通用：
| 软件 | 平台 | 适合谁 | 本站教程 |
|---|---|---|---|
| v2rayN | Windows / Linux / macOS | 最接近 Qv2ray 的用法，内置 Xray、sing-box、mihomo 三个核心，不用自己装核心 | v2rayN 下载与教程 |
| Throne | Windows / Linux | NekoRay 的后续分支，Qt 界面，习惯 Qv2ray 布局的人上手快 | NekoRay / Throne |
| Clash Verge Rev | Windows / Linux / macOS | 机场只给 Clash 订阅时 | Clash Verge Rev 教程 |
| Hiddify | 全平台，含 Apple 芯片 Mac | 想要一个软件同时装在电脑和手机上 | Hiddify 教程 |
截至 2026 年 10 月，v2rayN 最新是 7.25.6（10 月 11 日），Throne 是 1.3.2（9 月 29 日），都还在正常发版。从 Qv2ray 迁过去不用导出配置，直接把机场订阅链接重新粘贴一遍就行，比迁移旧的节点文件更省事。
哪些机场还能用 Qv2ray
挑机场时只看一件事：节点是不是 VMess、VLESS+TLS 或普通 Shadowsocks。本站核实过的机场里，下面两家的节点协议正好落在 Qv2ray 能处理的范围内：
- 丛雨云：本站进后台看过，全部节点都是 VMess 协议，Qv2ray 内置就支持，配 v4.45.2 核心即可。反过来说，VMess 在封锁严的时期抗封能力不如新协议，评测里也提到了这一点
- Scrssr：面板里只有 Shadowsocks、SSR 和 V2Ray 三类，官方文档的 Windows 教程本身就是 v2rayN 这类老工具。SS 节点 Qv2ray 直接能用，SSR 要装上面的 QvPlugin-SSR
这两家都是因为协议没跟上新的才和 Qv2ray 兼容，这是同一件事的两面。打算长期用的话，换到 v2rayN 这类新客户端，可选的机场会多得多。
常见问题
Qv2ray 还能用吗？
能用，前提是核心用 v4.45.2 或 Xray，节点是 VMess、VLESS+TLS 或普通 Shadowsocks。它在 2021 年 8 月停止维护，之后的新协议（Reality、Hysteria2 等）都不支持，系统兼容问题也不会再修。
Qv2ray 官网是 qv2ray.net 吗？
曾经是，现在不是了。这个域名已经被停放，浏览器打开会跳到诱导下载软件的页面，原来的 qv2ray.github.io 也会跳过去。要下载就去 GitHub 上的 Qv2ray/Qv2ray 仓库 Releases 页。
Qv2ray 用 v2ray v5 核心为什么报错？
Qv2ray 用 v4 的命令格式调用核心（--version 和 -config），v5 改成了 v2ray run 子命令，不认旧参数，所以检查时报退出码 2。换成 v2fly 的 v4.45.2 或 Xray 就能通过。
Qv2ray 有安卓版或 iOS 版吗？
没有。官方只出过 Windows、Linux 和 macOS 版本。手机上可以用 v2rayNG（安卓）或小火箭、Karing（iPhone），机场订阅通用。
本文的版本、发布日期与分发渠道状态核实于 2026-10-19：版本信息来自 GitHub Release 与仓库 README，核心兼容性来自 Qv2ray v2.7.0 源码中的调用参数并在 Windows 上实际运行三个核心验证，菜单名称来自官方文档仓库的中文 Markdown。本站镜像文件均从 GitHub Release 原样下载、未做修改。代理工具的使用请遵守所在地法律法规。