本文适合用 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:导入订阅

  1. 在机场面板复制订阅链接。
  2. 打开 v2rayN,在主界面的「订阅分组」菜单里打开「订阅分组设置」。
  3. 点「添加」,填写:
    • 「别名」:给这个订阅起个名字,例如机场名;
    • 「可选地址 (Url)」:粘贴订阅链接;
    • 保持「启用更新」勾选,否则更新时会提示「未启用更新,跳过此订阅」;
    • 「自动更新间隔 (分钟)」「User Agent (可选)」按需填写,不清楚就保持默认;
    • 「订阅转换目标类型」留空。官方说明设置后更新订阅时会调用订阅转换服务,也就是把订阅交给转换服务处理。
  4. 保存后回到主界面,在「订阅分组」菜单里点「更新全部订阅 (不通过代理)」。日志区显示「更新订阅结束」后,节点会出现在列表里。

另一种方式:复制订阅链接后,在主界面的非输入框区域按 Ctrl+V(「从剪贴板导入分享链接」)。官方 Wiki 说明,内容以 https 开头时会按新增订阅处理。

v2rayN:选节点、开代理

  1. 在节点列表里选中一个节点,右键选「设为活动」。
  2. 打开系统代理:在主界面底部或托盘菜单里选「自动配置系统代理」(位置以当前版本界面为准)。不想用时选「清除系统代理」。
  3. 想先看看哪些节点有响应,可以多选后右键「测试真连接延迟 (多选)」。这个数值只反映当时、当前网络下的一次测量,不代表下载速度,也不代表以后都能用。

路由、TUN 等设置不懂可以先保持默认。

v2rayNG:导入订阅

以下菜单名称来自 v2rayNG 仓库的简体中文界面文字,入口位置以当前版本界面为准:

  1. 在机场面板复制订阅链接。
  2. 打开 v2rayNG,从侧边菜单进入「订阅分组」,点添加。
  3. 填写「备注」和「URL(可选)」(粘贴订阅链接),保持「启用更新」打开;需要自动更新可以打开「启用自动更新」。「允许不安全的 HTTP 地址」不要打开,订阅链接应当是 https 开头。
  4. 保存后回到首页,在右上角菜单里点「更新订阅」。完成后会提示更新了多少个配置、成功和失败各几个。

首页「+」菜单里还有「从剪贴板导入」「扫描二维码」,适合导入单条节点分享链接。机场订阅建议按上面的订阅分组方式添加,以后可以统一更新。

v2rayNG:选节点、连接

  1. 在首页列表里点选一个节点。
  2. 点首页的连接按钮(通常在右下角,以当前版本界面为准)。首次连接时 Android 通常会弹出 VPN 连接请求,确认后才能连接。
  3. 想看哪些节点有响应,可以在菜单里点「测试真连接延迟」,再「按测试结果排序」。设置里的「测试后自动删除无效配置」不建议打开:界面提示测试结果可能不准确,删掉的配置无法恢复。

官方 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 的「订阅转换网址」「订阅转换目标类型」不需要时留空。
  • 反馈问题、发日志或截图前,遮住订阅地址和令牌。
  • 怀疑泄露时,到机场面板重置订阅,再在客户端里换成新链接。

更多说明见订阅链接是什么、怎么保管才安全。