选择安卓 APK 架构
打开 v2rayNG 官方 Releases,选择稳定发布,再展开 Assets。真正用于安装的是 .apk 文件,.apk.sig 和 .asc 属于校验材料。当前发布包按 CPU 架构拆分,先判断设备架构,再比较版本号。
| 文件名标识 | 适用设备 |
|---|---|
| arm64-v8a | 多数较新的 64 位 ARM 安卓手机和平板。 |
| armeabi-v7a | 32 位 ARM 老设备或部分电视盒子。 |
| x86_64 / x86 | 对应架构的安卓模拟器或少数 Intel 设备。 |
2026 年 11 月 4 日核对的稳定版为 2.3.15,其发布代码最低 Android API 仍为 24,即 Android 7.0。该版本 Assets 实际提供 arm64-v8a、armeabi-v7a、x86、x86_64 和 universal APK;架构不确定时可核对设备规格或选择该版本提供的通用包。标准版与带 -fdroid 的构建包名不同,更新应保持原构建渠道,切换前先备份,不能假定配置会自动迁移。.apk.sig 与 .asc 是签名校验材料,不是安装程序。
安装与 VPN 授权
- 在设备信息或厂商规格中确认 CPU 架构,下载对应 APK。若系统提示不兼容,先核对架构和系统要求,而不是反复下载同一个包。
- 打开 APK,按 Android 提示为当前浏览器或文件管理器允许安装此应用。安装完成后,可收回该来源的安装权限。
- 首次启动先导入配置,选定要连接的项目,再启动连接。系统会请求建立 VPN 连接的授权,确认应用名称为 v2rayNG 后同意。
- 初次验证时停止其他 VPN、过滤软件或同类代理应用,减少 Android VPN 通道被另一应用接管的干扰。
VPN 图标说明系统连接服务已建立,并不保证远端节点可用。保留应用内错误信息,后面应结合一次实际网页访问判断。安装失败也可能是已有应用的签名或构建渠道不同;先备份,再决定是否迁移,避免直接卸载丢失配置。
导入订阅、分享链接或二维码
单节点分享链接通常描述一个连接,订阅 URL 则用来获取并更新连接列表。先按手里的内容选择导入入口,网站登录页或邀请页不能当订阅。
- 只有单个分享链接:复制完整内容,使用添加配置中的“从剪贴板导入”;也可以选择“扫描二维码”,在系统询问时授予相机权限。
- 有订阅地址:进入“订阅分组”,添加易识别的名称和完整地址后更新。2.3.14 仍可组合“更新、自动测试、删除无效、排序”等后台步骤;首次迁移先只更新订阅,核对节点数量,再单独测试。网络暂时不可用可能导致测试失败,不要在尚未确认原因时开启自动删除无效节点。只有服务方明确要求时才配置自定义 HTTP 请求头,不要把令牌或授权头放入公开截图。
- 从旧设备迁移:优先使用应用的备份与还原功能,或导出自己的配置后在新设备导入;不要将导出的凭据粘贴到公开论坛。
导入后检查节点数量和协议类型。若出现零个配置,先查看更新错误及返回格式。Clash YAML 不应直接按普通节点分享链接导入;需要保留 Clash 规则时,可考虑 FlClash。
订阅分组上的流量、到期时间从哪里来?
2.3.14 会在订阅分组中显示服务方返回的流量、到期时间与支持链接,分组标签也改为带数量徽章的样式。这些信息来自订阅响应头,不是客户端独立测量的计费结果;服务方没有提供对应字段时,界面可能不显示,不能据此判断套餐不限量或永不过期。先更新对应订阅,再与服务方账户页面核对;节点数量、剩余流量与连接是否可用是三件不同的事。
VPN 模式与仅代理模式
日常手机使用先选 VPN 模式,让 Android 接口接收应用流量。“仅代理”模式只开放本地入口,需要目标应用自行设置代理。
官方 Mode 文档列出的本地地址为 127.0.0.1:10808,同时可接受 SOCKS 和 HTTP;若你修改过端口,应以当前设置为准。这里的 127.0.0.1 指当前手机,在另一台电脑填写这个地址不会连到手机。
分应用选择和路由规则会影响某个应用实际走哪条路径。初次连接先维持清楚、简单的规则,完成验证后再逐项调整。仅代理模式如果配合 Wi-Fi 的 HTTP 代理设置使用,停止客户端后还需检查该 Wi-Fi 代理是否仍保留,否则看起来会像整个网络断开。
页面、后台与网络切换测试
- 选择一个已导入的配置并启动服务,观察日志有没有连接、解析或握手错误。
- 打开自己日常访问的 HTTPS 网站,刷新一个未缓存页面,确认内容能完整加载。
- 再使用一个受影响的应用发起请求。如果浏览器可用而该应用不可用,查看分应用设置、路由和该应用是否使用了独立代理。
- 把 v2rayNG 切到后台,锁屏数分钟后重试;再分别用 Wi-Fi 与移动数据访问同一目标,记录差异。
连接测试的毫秒值反映测试目标与测试时刻的结果,不代表下载吞吐量,也不能证明所有网站可访问。只有本机监听成功、但实际访问失败时,可在 故障排查 中按配置、入口、DNS、远端连接顺序继续定位。电脑端需求应看 v2rayN 指南。
安装失败、空订阅和后台断连
- APK 无法安装:检查下载是否完整、CPU 架构是否匹配、现有应用是否来自另一签名渠道。先保存配置,再处理渠道迁移。
- 订阅更新失败:区分地址过期、HTTP 状态码异常、域名解析失败和配置格式不兼容。客户端的连接失败与订阅下载失败应分开处理。
- 显示连接成功却打不开:确认选中的是需要使用的配置,查看日志中的目标域名与错误;再核对节点参数、设备时间、DNS 和路由。
- 锁屏后断开:检查系统对 v2rayNG 的电池与后台运行限制,只调整该应用。先用前台与后台的同一请求对比,判断是否确为后台限制。
- 规则更新失败:项目说明提醒,应用内下载 GeoIP/Geosite 数据可能需要已可用的代理。先恢复基础连接,再更新规则资料。
提交问题时附应用版本、Android 版本、安装包架构和脱敏日志。节点密码、UUID、订阅令牌和完整二维码都应从截图中去除。
从 2.3.11 升级的用户还应检查订阅更新后的主列表:官方后续修复了在订阅页仅更新、不自动测试时,主列表保留旧行、编辑时出现空内容的问题。升级至 2.3.14 后先只更新一个分组,返回主列表核对数量并打开配置检查;若仍异常,保留脱敏日志与备份,不要先删除整个分组或卸载应用。
备份与版本更新
打开“备份 & 还原”保存配置,再记下安装渠道、路由和分应用选项。导出几个节点到剪贴板,不能替代应用备份。
更新时继续使用同一官方渠道和同一构建类型。2.3.11 已迁移到 Jetpack Compose 界面,并新增 TCP ping、订阅组合任务和 v2rayn:// 内部分享导入;旧版截图中的入口位置可能不再一致。2.3.11 当时的发布说明列出 Xray-core v26.10.10;2.3.14 的历史说明列出 Xray-core v26.10.21;本轮核查的 2.3.15 正式发行说明已明确链接紧急安全更新 Xray-core v26.10.31。这是客户端发行记录中的内核更新信息,不是把独立内核的版本号套给旧 APK;更新后仍应查看应用实际版本信息。升级前保存应用备份,升级后先核对配置、路由和分应用设置,再分别验证网页、后台运行和网络切换。应用升级、订阅更新和规则更新分开进行,便于定位回归;TCP ping 成功也不代表实际 HTTPS 请求成功。
2.3.14 发布说明仍链接 allowInsecure 移除后的迁移说明。旧节点若依赖跳过 TLS 证书验证,应修正服务器证书与名称;若使用 pinnedPeerCertSha256,须先通过可信渠道核对证书指纹,不要用关闭验证来掩盖证书错误。
完成升级后重复“网页访问、目标应用、后台运行、网络切换”四项检查。若新版本异常,先查看该版本的已知问题和错误日志,再决定是否恢复备份;仅根据界面上存在节点无法判断备份恢复是否完整。
2.3.14 的官方代码还修复了不写端口的 Hysteria2 分享链接导入时使用默认端口的处理。已有链接若导入失败,先保存原链接并确认服务方给出的参数,再用新版重新导入一份核对;不要凭猜测修改服务端端口。本文依据发布说明和对应标签源码核对,未将这些修复描述为本站实机测试结果。
2.3.15 继续提供标准与 fdroid 两类、五种架构组合的 APK,标签源码最低 Android API 为 24(Android 7.0)。升级不需要先改订阅或扩大“允许局域网连接”的范围。先保留原备份,仅更新应用,再核对版本、订阅分组、路由与常用连接;自动测试后删除无效配置等组合操作仍应谨慎启用,避免将一次网络失败当作节点永久失效。安全修复的适用范围以官方发行说明为准,应用升级不能替代操作系统自身更新。
常见问题
普通安卓手机应该下载哪个 APK?
多数较新的手机选择标准版 arm64-v8a;老旧 32 位 ARM 设备选择 armeabi-v7a,模拟器按 x86 或 x86_64 架构选择。官方说明提到的 universal 文件如果本次发布没有提供,就应核对架构后选择对应包。
标准版与带 fdroid 字样的包有什么区别?
官方发布说明指出,fdroid 构建使用不同包名,适用于某些特殊系统环境。切换构建不能默认继承原配置,迁移前应备份,并核对更新渠道和安装签名。
仅代理模式停止后,为什么 Wi-Fi 无法访问网络?
如果此前在 Wi-Fi 设置中手工填写了指向 v2rayNG 的 HTTP 代理,应用停止后该入口就不能服务请求。检查并恢复这个 Wi-Fi 的代理设置,再重试。
参考资料
下载、系统要求和配置字段以对应版本的官方说明为准。文中的流程图由 AFQKit 绘制。