本文适合用 Windows 电脑或 Android 手机的新手。v2rayN 与 v2rayNG 是同一位开发者(GitHub 上的 2dust)维护的两个开源客户端。下面的说明依据两个官方 GitHub 仓库的 README、官方 Wiki 和仓库里的简体中文界面文字整理(2026-10-25 查看官方说明)。本站没有用它们连接任何机场节点,也没有测速;软件更新后菜单名称和位置可能变化,以当前版本界面为准。
iPhone / iPad 用户请看 Shadowrocket 导入订阅;想在电脑上用 Clash 格式订阅,可以看 Clash Verge Rev 导入订阅。
两个客户端分别适合谁
| 项目 | v2rayN | v2rayNG |
|---|---|---|
| 设备 | 电脑:Windows、Linux、macOS | Android 手机、平板(官方说明也可在 Android 模拟器上运行) |
| 系统要求(官方说明) | 发布文件说明写 Windows 10 及以上、macOS 13.6 及以上;Linux 列出 Debian 12+、Ubuntu 22.04+、Fedora 36+、Redhat 9+ | README 徽章标注 API 24+(对应 Android 7.0) |
| 内核 | 支持 Xray、sing-box 等;发布包内含 Xray、sing-box、mihomo 内核 | 支持 Xray 与 v2fly 内核 |
| 下载 | v2rayN GitHub Releases | v2rayNG GitHub Releases |
| 费用 | 开源(GPL-3.0),从 GitHub 下载不收费 | 开源(GPL-3.0),从 GitHub 下载不收费 |
一句话区分:v2rayN 是电脑版,v2rayNG 是手机版,两个 README 都这样互相指引。
从哪里下载、下载哪个文件
两个 README 给出的下载地址都只有 GitHub Releases,发布文件带 GPG 签名,可以用来核对文件没有被篡改。搜索结果里的「中文版」「汉化版」下载站不是官方渠道。
v2rayN(电脑)
官方 Wiki 的发布文件介绍说明(文件名以 Release 页面为准):
- Windows:x64 电脑下载
v2rayN-windows-64.zip(WPF 界面)或v2rayN-windows-64-desktop.zip(Avalonia 界面),arm64 电脑有对应的 arm64 包。zip 是便携版,解压到文件夹后直接运行,配置保存在这个文件夹里。官方常见问题建议文件夹路径尽量只用英文、不带空格,也不要放进 C 盘这类有权限限制的目录。 - macOS:Intel 与 Apple 芯片各有 zip 与 dmg。官方说明 dmg 安装包没有签名,打开时会提示应用已损坏,安装后需要在终端运行
xattr -cr /Applications/v2rayN.app。只对从官方 Release 下载的文件这样做。 - Linux:提供 zip、deb(Debian / Ubuntu)和 rpm(Fedora / Redhat)包。
v2rayNG(Android)
官方 Wiki 的 Android 发布文件说明建议:
- 大多数近几年的手机:下载文件名带
arm64-v8a的 APK; - 不确定手机架构:下载
universal版,体积约大一倍; - 老旧设备、电视盒子:64 位包装不上时试
armeabi-v7a; - 带
fdroid的版本只是包名不同,给部分特殊系统设备使用。
Release 页面提供 SHA-256 哈希值和签名文件,可以用来比对下载的 APK。安装时 Android 一般会要求允许浏览器或文件管理器安装未知应用,装完后可以把这个权限关掉。
订阅要选哪种格式
先说结论:在机场面板里复制标注为 V2Ray / v2rayN / 通用(Base64) 的订阅链接。
依据是 v2rayN 官方 Wiki 的订阅功能说明和重要界面功能介绍:
- 订阅地址是普通、可以正常访问的网址;
- 订阅支持的协议:VMess、Shadowsocks、SOCKS、VLESS、Trojan、Hysteria 2、TUIC、WireGuard、AnyTLS;
- 订阅内容支持协议标准的分享链接(如
vmess://、vless://)或 v2rayN 内部格式,明文和 Base64 编码都能解析; - 解析时还会识别 SIP008、WireGuard 配置,以及 sing-box、v2ray、Clash、Hysteria 的完整配置。不过完整配置会作为「自定义配置」导入,界面提示这类配置完全依赖其自身内容,不能使用全部设置功能。所以有 V2Ray 格式时优先用 V2Ray 格式。
- 很多订阅后台会根据客户端发送的 User Agent(客户端自报的名称)决定返回什么内容,v2rayN 默认发送
v2rayN/版本号。
v2rayNG 的 README 和 Wiki 没有单独列出订阅格式。从界面文字看,它也是通过「订阅分组」添加订阅,机场面板一般标为 V2Ray / v2rayNG / 通用订阅;能识别哪些节点,以机场说明和当前版本为准。
v2rayN:导入订阅
- 在机场面板复制订阅链接。
- 打开 v2rayN,在主界面的「订阅分组」菜单里打开「订阅分组设置」。
- 点「添加」,填写:
- 「别名」:给这个订阅起个名字,例如机场名;
- 「可选地址 (Url)」:粘贴订阅链接;
- 保持「启用更新」勾选,否则更新时会提示「未启用更新,跳过此订阅」;
- 「自动更新间隔 (分钟)」「User Agent (可选)」按需填写,不清楚就保持默认;
- 「订阅转换目标类型」留空。官方说明设置后更新订阅时会调用订阅转换服务,也就是把订阅交给转换服务处理。
- 保存后回到主界面,在「订阅分组」菜单里点「更新全部订阅 (不通过代理)」。日志区显示「更新订阅结束」后,节点会出现在列表里。
另一种方式:复制订阅链接后,在主界面的非输入框区域按 Ctrl+V(「从剪贴板导入分享链接」)。官方 Wiki 说明,内容以 https 开头时会按新增订阅处理。
v2rayN:选节点、开代理
- 在节点列表里选中一个节点,右键选「设为活动」。
- 打开系统代理:在主界面底部或托盘菜单里选「自动配置系统代理」(位置以当前版本界面为准)。不想用时选「清除系统代理」。
- 想先看看哪些节点有响应,可以多选后右键「测试真连接延迟 (多选)」。这个数值只反映当时、当前网络下的一次测量,不代表下载速度,也不代表以后都能用。
路由、TUN 等设置不懂可以先保持默认。
v2rayNG:导入订阅
以下菜单名称来自 v2rayNG 仓库的简体中文界面文字,入口位置以当前版本界面为准:
- 在机场面板复制订阅链接。
- 打开 v2rayNG,从侧边菜单进入「订阅分组」,点添加。
- 填写「备注」和「URL(可选)」(粘贴订阅链接),保持「启用更新」打开;需要自动更新可以打开「启用自动更新」。「允许不安全的 HTTP 地址」不要打开,订阅链接应当是 https 开头。
- 保存后回到首页,在右上角菜单里点「更新订阅」。完成后会提示更新了多少个配置、成功和失败各几个。
首页「+」菜单里还有「从剪贴板导入」「扫描二维码」,适合导入单条节点分享链接。机场订阅建议按上面的订阅分组方式添加,以后可以统一更新。
v2rayNG:选节点、连接
- 在首页列表里点选一个节点。
- 点首页的连接按钮(通常在右下角,以当前版本界面为准)。首次连接时 Android 通常会弹出 VPN 连接请求,确认后才能连接。
- 想看哪些节点有响应,可以在菜单里点「测试真连接延迟」,再「按测试结果排序」。设置里的「测试后自动删除无效配置」不建议打开:界面提示测试结果可能不准确,删掉的配置无法恢复。
官方 Wiki 的 Mode 页面介绍了 VPN 模式与仅代理模式的区别:仅代理模式需要在其他应用里手动设置代理,新手一般用 VPN 模式即可。
怎么更新订阅
- v2rayN:「订阅分组」菜单里有「更新全部订阅」和「更新当前订阅」,各分「不通过代理」和「通过代理」两种。还没有能用的节点时用「不通过代理」;订阅域名直连访问不了、而你已有可用节点时,再试「通过代理」。也可以在订阅分组里设「自动更新间隔 (分钟)」。
- v2rayNG:手动更新用菜单里的「更新订阅」;自动更新在设置里打开「自动更新订阅」并填「自动更新间隔(分钟,最小值 15)」。界面提示这项功能受设备影响,不一定总是有效,所以发现节点没变化时手动更新一次。
- 机场重置了订阅链接:编辑原来的订阅分组,把地址换成新链接,再更新一次。
官方 Wiki 说明,v2rayN 每次更新订阅后,之前的延迟和速度数据会被清空,需要重新测试。
常见错误
| 现象 | 可能原因与处理 |
|---|---|
| 「无效的订阅内容」 | 订阅返回的内容 v2rayN 解析不了:确认复制的是 V2Ray / 通用格式那一项;机场说明需要特定 User Agent 时再填写 |
| 「未启用更新,跳过此订阅」 | 订阅分组里的「启用更新」没有勾选 |
| 更新超时、「导入订阅内容失败」 | 核对本机网络、系统时间和链接是否完整;查看机场维护公告;已有可用节点时试「通过代理」更新 |
| 「运行 core 失败」 | 官方常见问题说明,多数是配置错误、当前内核已不支持该配置,或本地监听端口被其他程序(如虚拟机)占用;可把日志等级设为 Debug 查看 |
| macOS 提示应用已损坏 | 官方说明 dmg 没有签名,按上文运行 xattr -cr /Applications/v2rayN.app |
| v2rayNG 自动更新没生效 | 官方界面提示该功能受设备影响,改为手动「更新订阅」 |
更完整的排查顺序(先分清是下载失败、格式失败还是节点连不上)见订阅更新失败怎么办。官方的问题汇总见 v2rayN 常见问题。
订阅链接要像密码一样保管
订阅链接通常带有你的账户凭据,拿到链接的人就能用你的套餐流量。
- 两个客户端都有「分享」功能,可以生成二维码或复制链接(v2rayNG 还有「分享订阅链接」)。只在自己的设备之间使用,不要发到群里。
- 不要把订阅链接填进来路不明的订阅转换服务;v2rayN 的「订阅转换网址」「订阅转换目标类型」不需要时留空。
- 反馈问题、发日志或截图前,遮住订阅地址和令牌。
- 怀疑泄露时,到机场面板重置订阅,再在客户端里换成新链接。
更多说明见订阅链接是什么、怎么保管才安全。