开源客户端安卓与桌面

V2Ray 安卓下载

桌面选 v2rayN,安卓优先选 v2rayNG;从安装包选型开始,依次完成订阅导入与路由分流。

  • VMess
  • VLESS
  • Trojan
  • Shadowsocks

连接异常与对应设置

先找出故障发生在哪一步:更新订阅只负责取得配置,启用系统代理才会改变部分应用的连接入口,路由规则则决定接入客户端的流量怎么走。这三步互不替代。排查时只改一项,用同一个应用重试,才容易判断是哪项设置生效。

常见卡点

  • 系统代理开了,浏览器仍直连。 排除浏览器自己的代理设置后,再区分请求没有进入客户端,还是进入后命中了直连规则。
  • 订阅更新后列表为空。 保存地址只创建了分组条目;更新可能失败,也可能成功写入了另一个分组。
  • 安卓一锁屏,稍后就掉线。 如果回到应用后才恢复,先复查系统的后台限制,不必立刻更换连接配置。

对应设置

  • 在 v2rayN 选择「自动配置系统代理」,确认浏览器沿用系统设置,再到「路由设置」检查目标是否匹配直连。
  • 打开「订阅分组」,选中刚保存的分组并更新当前订阅。若提示解析失败,先确认拿到的是订阅地址,而不是账户登录页。
  • 在安卓系统的 v2rayNG 应用信息中查看电池设置。若有「不受限制」,可临时选中做锁屏对照,确认有改善再保留。

路由规则片段:目标命中私有地址集合时,从标记为 direct 的出站发送。这个标记需与现有出站的名称一致。

{
  "type": "field",
  "ip": ["geoip:private"],
  "outboundTag": "direct"
}

五项客户端设置

订阅分组与列表刷新

订阅分组适合维护一批会变动的连接配置,单条链接则适合一次只导入一条。桌面 v2rayN 可先在「订阅分组」保存地址,再更新当前分组;安卓 v2rayNG 则从侧边菜单进入订阅分组设置,保存后回到主列表执行更新。确认新条目出现在正确的分组后,手动选定一条连接配置。若刷新后自定义条目被覆盖,应改在独立分组保存本地条目,而不是在订阅分组里反复编辑。

订阅分组更新当前订阅

界面示意把分散设置放在一起,便于对照,不代表实际菜单顺序。若当前客户端的用词不同,可先查概念速查:确认要调整的是流量入口、目标匹配,还是连接配置本身,再回到对应菜单。

按系统选择安装包

先确定安装在哪台设备上,再对照系统类型和处理器架构。同一架构的安装包也不能跨系统使用;已经安装的设备,更新前还要确认当前使用的是哪个客户端和发行形式。

v2rayN 有跨平台界面的桌面版,也有经典 WPF 版。初次使用可先看桌面版;若手头的操作说明以经典界面为例,选 WPF 版更容易对照。先到系统的「关于」查看「系统类型」,确认设备适用下载页列出的架构。

应用若在窗口出现前就退出,先查发行说明列出的桌面运行环境。此时尚未进入订阅或连接阶段,修改节点参数不能解决启动失败。

前往下载

在「关于本机」查看「芯片」或「处理器」。显示 Apple 芯片的机型选 Apple Silicon 包,显示 Intel 处理器的机型选 Intel 包。不要按电脑的购买年份猜测,同一时期可能有两种架构的机型。

打开磁盘映像后,按其中的安装说明将应用放到「应用程序」。若从映像窗口直接试用了客户端,先退出,再从实际安装位置启动,避免安装和测试时打开不同副本。

前往下载

优先看基于 Xray 的 v2rayNG;已有明确的 V2Fly 配置要求时,再比较 v2flyNG。多数近年的设备可选 arm64 包,拿不准系统支持哪种架构时可先看通用包,并核对最低系统要求。

若系统提示与已安装应用冲突,先区分是不是覆盖安装失败。卸载可能清除本地配置,排查前应备份订阅分组和手动建立的条目,不要将卸载作为第一步。

前往下载

安装桌面版 v2rayN 时,先按发行版的包管理体系选 deb 或 rpm,再核对架构。Debian、Ubuntu 一般使用 deb,Fedora 一般使用 rpm;使用 ARM 设备时,也要选对应架构的包。

能启动客户端不等于桌面应用会采用系统代理。安装后先查当前桌面环境的网络代理设置,再用一个会读取该设置的应用做验证;个别应用仍需要在自身设置中指定连接方式。

前往下载

查看全部客户端 →

从导入到验证的三步

第一次连接,先保留默认设置,用一条已知可用的配置建立基线。确认能用之后,再调整分流、分应用名单或后台设置;这样即使后续出现问题,也能回到上一步重试。

  1. 导入配置并选定条目

    有订阅地址时,在客户端新建一个分组,填写便于辨认的名称与订阅地址,保存后更新该分组。只有一条分享链接时,使用从剪贴板导入的入口,不必先建订阅。导入结束后,检查主列表有没有出现预期条目,并选定用于测试的一条。若客户端提示没有找到配置,先确认复制的内容是完整地址或分享链接,不是二维码旁边的说明文字。订阅地址可能含有访问凭据,不要把完整地址贴到公开截图或问题反馈里。

  2. 接入一个测试应用

    桌面端在 v2rayN 选中配置后,设置「自动配置系统代理」,再打开一个沿用系统代理的浏览器。安卓端在 v2rayNG 点连接,首次出现系统 VPN 权限确认时,核对由哪个应用发起,再确认授权。测试期间先别改分应用名单,必要时确认没有其他 VPN 正在占用系统连接。若在启用代理或系统授权前就遇到错误,先处理客户端启动、运行环境或授权问题,不急着修改路由规则。

  3. 用实际请求判断哪一步有问题

    打开日常访问的页面,发起一次新请求并记下时间,再回到客户端观察这一刻的运行日志。没有对应记录时,先复查测试应用是否接入;记录显示已直连但预期应走代理时,再看规则匹配;已经尝试建立连接却超时时,依次检查本机网络、连接配置和服务端状态。验证结束后,可恢复原来的系统代理或断开安卓 VPN,再用同一应用重试一次,确认连接状态确实随设置变化。

查看完整教程 →

Project V 生态与客户端许可

项目、内核和客户端是三个层次。先弄清文档说的是哪一层,才能判断一项能力属于连接协议、内核实现,还是界面提供的设置。

Project V 与社区维护

Project V 是 V2Ray 早期所属的项目生态,V2Ray 的核心负责处理入站、出站与路由。V2Fly 社区延续维护 V2Ray 核心,Xray 则从这一代码谱系分出,沿自己的方向演进。日常讨论里,「V2Ray」既可能指内核,也常被当作这一类工具的泛称。遇到一份教程说「支持 V2Ray」时,应再核对实际指的是能导入某种分享格式,还是能按所用协议和传输参数完成连接。

Xray 与 V2Fly 的兼容范围

两条内核路线共享部分配置概念,但协议名相同并不代表所有传输、安全设置都兼容。尤其要把协议类型与附加字段分开确认:一份使用 VLESS 的配置,还可能要求特定的传输或安全选项。若换内核后客户端能显示条目,启动或握手仍失败,应拿原配置逐项与受支持的字段对照,并确认服务端预期,而不是把「已导入」当成「已兼容」。

三款开源图形客户端

v2rayN 面向桌面,管理订阅、参数与系统代理;v2rayNG 将基于 Xray 的连接接入安卓系统 VPN 服务;v2flyNG 采用 V2Fly 内核,为有相应配置需求的安卓设备提供另一种选择。三款图形客户端均以 GPL-3.0 开源许可发布,可以免费使用。客户端许可不等同于内核及其他组件的许可,也不包含可用的服务器或订阅服务;已有配置仍应按其实际参数选客户端。

更新前后的检查顺序

客户端、内核和用于路由的规则数据可能分别更新。客户端更新可涉及界面或系统接入,内核更新则可能改变配置解析和连接行为。如果只是个别域名的出站不符预期,优先看正在使用的路由规则与数据,而不是同时更换客户端和内核。更新前记录启用的分组、路由预设和应用范围;更新后先复现一条原本可用的连接,再测试新增配置,便于区分迁移问题与原有问题。

对照三款客户端的适用场景 →

运行日志与故障排查

窗口打不开、单条连接超时、日志出现握手错误,分别对应不同的检查起点。先选与当前现象最接近的一篇;如果多个应用同时异常,建议从问题诊断中按症状逐项排除。

查看全部文章 →