v2rayNG 配置教程:从安装到连接排查
简答:如果你已经有订阅地址,最快流程是:从 2dust/v2rayNG Releases 页面下载与手机架构匹配的 APK,安装后打开主界面菜单中的订阅设置,添加订阅地址并更新配置,选择节点后启动 VPN。若手里只有 vmess、vless、trojan 等单条链接,不要粘贴到订阅地址栏,应使用剪贴板导入、扫码或手动配置入口。
定义:v2rayNG 是一款运行在 Android 手机上的代理客户端,项目说明显示它支持 Xray core 和 v2fly core;它与桌面端 v2rayN 不是同一个平台客户端。
先按这张表完成最短配置流程
第一次配置时,先判断你手里的输入类型,再选择对应入口。不要把订阅地址和单节点分享链接混用。
| 你手里的内容 | 应使用的方式 | 成功标准 | 失败时先检查 |
|---|---|---|---|
| 以 http 或 https 开头的订阅地址 | 主界面菜单中查找“订阅设置”或“Subscriptions”,新增订阅后更新 | 订阅分组出现,节点数量大于 0 | 地址是否完整、是否需要登录、手机是否能打开该地址 |
| vmess://、vless://、trojan://、ss:// 等单条链接 | 使用剪贴板导入、扫码导入或手动配置 | 主界面出现一条可选择的配置 | 链接是否被截断、二维码是否清晰、协议是否受当前版本支持 |
| 多个节点组成的文本或配置文件 | 先确认提供方给的是订阅地址还是分享链接,再选择导入方式 | 配置列表能看到对应节点 | 不要直接把未知格式文本粘贴到订阅地址栏 |
项目 README 将 v2rayNG 定义为 Android 客户端,并把桌面端项目单独指向 v2rayN;下载入口应优先从项目 Releases 页面进入,而不是依据搜索结果中的镜像名称判断来源。查看项目 README 查看 Releases 页面
第一步:下载并选择正确的 APK
截至 2026 年 11 月 1 日,项目 Releases 页面顶部可见 2.3.11 条目;版本状态和可下载文件可能继续变化,因此本文不把某个版本号写成永久推荐。下载时以当前 Releases 页面显示的标签、文件名和校验信息为准。
- 普通近年 Android 手机:优先查看文件名中的
arm64-v8a。 - 较旧手机或部分电视盒子:如果 64 位安装包无法安装,再核对设备资料后考虑
armeabi-v7a。 - Android 模拟器或 x86 设备:根据设备架构选择
x86或x86_64。 - 无法判断架构:如果当前 Releases 页面提供
universal文件,可将其作为兼容性优先的选择;若页面没有该文件,不要自行假设存在。
项目 Wiki 对标准 APK、F-Droid 构建、架构文件以及 .sig、SHA-256 校验文件作了区分。下载后应核对文件名是否来自当前发布条目;需要更高把握时,再按照项目提供的签名或哈希说明校验。查看 Android 发布文件说明
第二步:安装 APK 与处理系统授权
从浏览器或文件管理器打开 APK 后,如果系统阻止安装,通常是因为 Android 对非应用商店来源设置了单独授权。Android 官方说明显示:Android 8.0(API 26)及以上通常需要在“安装未知应用”中为实际安装来源授权;Android 7.1.1(API 25)及更早版本通常使用“未知来源”设置。不同手机厂商的菜单名称可能不同,应以设备当前界面为准。查看 Android 官方安装说明
- 确认 APK 文件来自项目当前发布页面,并检查文件名和架构。
- 点击安装;若提示无权安装,进入系统设置,搜索“安装未知应用”或“未知来源”。
- 只给实际打开 APK 的来源授权,例如浏览器或文件管理器,不要长期扩大授权范围。
- 安装完成后,可回到设置关闭该来源的安装权限。
如果出现“应用未安装”,先删除同包名但来源不同的旧版本备份,再确认 Android 版本、CPU 架构和存储空间;仍无法判断时,不要连续安装多个来路不明的 APK。
第三步:添加订阅、单节点或二维码
订阅地址
- 打开 v2rayNG,进入主界面菜单或右上角更多选项,查找“订阅设置”“Subscriptions”等入口。由于版本界面可能变化,菜单名称以当前版本为准。
- 新增订阅分组,填写备注和订阅 URL,保存后执行更新订阅。
- 更新完成后回到主界面,切换到对应分组并选择节点。
订阅地址本质上是一个可访问的 URL;项目相关说明将标准协议链接与订阅格式区分开来。不要把自己的订阅地址公开发布,也不要把完整订阅链接粘贴到公开工单或群聊中。查看订阅格式说明
单条分享链接
如果内容以 vmess://、vless://、trojan:// 或其他协议前缀开头,它通常更接近单节点分享链接,而不是订阅 URL。可在主界面菜单中查找“从剪贴板导入”“扫描二维码”或添加配置入口。若当前版本没有完全相同的中文菜单,沿着“添加配置”“二维码”“剪贴板”这类功能定位。
更新后的可选操作
项目 Releases 的更新说明曾列出“更新订阅”“更新订阅后自动测试”“测试后自动删除无效”“测试后自动排序”等组合选项。是否能在你的版本中看到这些选项,应以当前版本订阅分组设置为准;不要把自动测试结果等同于所有应用都能正常访问。核对当前版本发布说明
第四步:选择节点并启动 VPN
- 在配置列表中选择一个节点,避免同时修改多个配置。
- 先执行 TCP 延迟或实际延迟测试;测试结果只说明某类连接测试的结果,不代表所有网站、应用和时段都可用。
- 点击主界面的启动按钮,Android 通常会弹出 VPN 连接授权提示,确认后等待状态变为运行中。
- 用一个你明确知道应能访问的普通网页或工作系统进行验证,同时观察应用是否提示无网络。
- 如果启动后立即断开,先停止服务,再更换一个节点测试,避免同时改变 DNS、路由和应用分流设置。
项目源码中的界面文字包含 VPN 与 Proxy only 两类模式,以及订阅更新、配置测试和日志相关功能。具体入口可能随版本调整,因此本文采用“通用路径”,不把某个固定端口或固定菜单位置写成所有设备都适用。
按症状排查:先判断卡在哪一层
| 现象 | 优先检查 | 处理顺序 |
|---|---|---|
| 订阅更新失败 | 地址、网络、访问权限、证书或服务端状态 | 先用浏览器确认地址是否能打开;再重新复制完整地址;仍失败时联系订阅提供方,不要随意开启不安全 HTTP。 |
| 更新成功但节点为空 | 订阅格式、分组是否启用、过滤规则 | 检查是否添加到正确分组,清除过窄的备注过滤;确认提供方返回的内容确实包含客户端支持的配置。 |
| 延迟显示负数或测试失败 | 测试类型、节点响应、DNS 或网络限制 | 换一个节点并区分 TCP 测试与实际连接;不要只凭负数判断配置一定无效。 |
| 节点可测试但应用打不开 | VPN 是否真正运行、路由模式、应用自身代理和 DNS | 先确认 VPN 状态,再恢复较简单的路由模式;关闭应用自带代理或其他 VPN,最后再检查 DNS。 |
| 只有部分应用不可用 | 分应用代理、应用内 DNS、IPv6 或应用自身网络策略 | 暂时关闭分应用规则做对照;若恢复,再逐项加入应用,不要一次修改多个网络参数。 |
排障时建议每次只改一个变量,并记录“节点、网络类型、路由模式、是否获得 VPN 授权、失败应用和日志时间”。如果需要反馈问题,项目 README 提供了 GitHub 反馈入口;提交日志前应删除订阅地址、账号标识和其他隐私内容。查看项目反馈入口
路由模式与分应用代理怎么选
- 全量或 VPN 模式:适合先验证客户端和节点是否能建立基础连接,排查时变量较少。
- 绕过局域网或本地地址:适合需要继续访问打印机、路由器、NAS 等局域网设备的场景,但实际规则受当前版本和系统实现影响。
- 全局直连或关闭代理:用于做对照测试,判断问题是否来自 v2rayNG,而不是本地网络或目标应用。
- 分应用代理:适合只让指定应用使用代理,或只排除指定应用。首次配置建议先建立最小规则集,确认结果后再扩展。
如果开启分应用后出现“浏览器正常、某个应用无网络”,先恢复基础模式进行对照,再检查该应用是否被加入错误的白名单或黑名单。不要把节点测速成功直接理解为分应用、DNS 和所有协议都已经验证。
安全与核验清单
- 下载前确认域名是项目代码仓库的发布页面,避免把搜索结果中的镜像、教程站或重打包文件当成项目发布。
- 订阅地址具有访问权限属性,不要公开截图、转发或放入公开配置示例。
- 不要为了解决安装问题而永久开启所有来源的应用安装权限。
- 不要在未理解参数作用时启用自定义请求头、跳过证书验证或不安全 HTTP;相关选项是否存在以当前版本为准。
- 连接问题应按“订阅可访问性—配置是否存在—节点测试—VPN 授权—路由与分应用”顺序排查,避免反复重装。
本文只提供客户端配置和网络连接诊断思路,不提供节点、订阅地址、账号或可用性保证。
常见问题
v2rayNG 和 v2rayN 有什么区别?
v2rayNG 是 Android 客户端,项目 README 将桌面端项目单独列为 v2rayN。两者的界面、发布文件和菜单不能完全混用,手机应查看 v2rayNG 项目页面。
订阅地址应该粘贴到哪里?
订阅地址应放在主界面菜单中的订阅设置或 Subscriptions 入口,再保存并执行更新。以 vmess://、vless:// 或 trojan:// 开头的内容通常是单条分享链接,应改用剪贴板、二维码或手动配置入口。
为什么更新订阅后没有节点?
先确认订阅 URL 能否在浏览器中访问,再检查是否保存到正确分组、分组是否启用、备注过滤是否过窄,以及服务端返回内容是否包含当前客户端支持的格式。
v2rayNG 显示延迟,但连接后应用仍打不开怎么办?
延迟测试只代表某类测试结果。先确认 VPN 授权和运行状态,再关闭分应用代理及其他 VPN 做对照;如果基础模式正常,再逐项恢复路由、DNS 或应用分流设置。
APK 安装失败时应该下载哪个版本?
先查看手机或设备的 CPU 架构。近年 Android 手机通常先核对 arm64-v8a;旧设备可能需要 armeabi-v7a;模拟器或 x86 设备应按 x86 或 x86_64 选择。若当前发布页提供 universal 且无法判断架构,可核对该文件是否适用。