V2Ray 图形客户端 · 桌面与安卓

v2rayN 客户端 下载与配置参考

用 订阅分组整理来源,用 路由分流决定出口;从客户端安装到 TUN 配置,按设置项查阅。

  • GPL-3.0 开源
  • Xray-core
  • sing-box 可选

客户端界面结构示意;菜单与字段名称可能随平台和发布版本调整。

v2rayN 设置与流量入口

先管理配置来源,再区分系统代理、路由与虚拟网卡。三个层次分别决定配置从哪里来、流量如何进入内核,以及最终使用哪个出口。

按来源保存订阅与更新设置

订阅分组把地址、别名和更新策略放在同一处,适合同时维护多个配置来源。先在订阅分组设置中填写地址,再执行更新,并从对应分组选中服务器。自动更新间隔以分钟计,启用后仍需客户端具备访问订阅地址的网络条件。相比把所有条目混在单个列表里,分组便于定位失效来源,也便于控制更新范围。订阅内容由提供方决定;更新失败时先核对地址和证书错误,不要反复删除现有配置。

订阅分组 → 订阅分组设置

订阅分组设置

别名
区分配置来源
可选地址(url)
订阅地址
启用更新
✓
自动更新间隔(分钟)
按使用需要设置

一条请求的处理顺序可以概括为:应用发起连接,系统代理或虚拟网卡把流量交给本地入口,内核读取规则,再选择直连或代理出站。订阅分组并不参与这条实时链路,它负责提供服务器配置。把这些职责拆开后,更新订阅、修改系统代理和调整路由就不再是可以互相替代的操作。

首次使用建议保持默认参数,先完成一次可复现的连接,再逐项增加自动更新、分流例外和 TUN。需要修改 JSON 时,先阅读配置大全中的入站、出站与路由说明;只需完成图形界面设置时,直接按使用指南操作即可。

按平台选择客户端安装包

桌面设备选 v2rayN,安卓设备在 v2rayNG 与 v2flyNG 之间按内核需求选择。先确认系统与处理器架构,再进入对应平台下载。

Windows

v2rayN 提供 Desktop 桌面版与经典 WPF 版。Desktop 使用跨平台界面,WPF 面向该系统的桌面环境。两种界面的菜单位置可能不同,教程中的设置名称比窗口外观更适合作为定位依据。

首次安装先按下载页要求选择适用安装包;已有配置的设备先备份,再决定是否迁移界面版本。不要把两个实例同时运行造成的本地端口占用误认为订阅失效。

前往下载 Windows 客户端

macOS

选择 v2rayN 跨平台桌面版。Apple Silicon 与 Intel 处理器对应不同安装包,可在系统的“关于本机”中确认芯片信息。架构选对之后,再按下载页说明完成安装与首次启动。

系统代理与 TUN 的权限路径并不相同。建议先用系统代理完成连接验证,再处理虚拟网卡相关授权;迁移桌面配置时,也要复查文件路径和本地监听端口。

前往下载 macOS 客户端

Android

优先查看使用 Xray 内核的 v2rayNG;需要 V2Fly 内核时再考虑 v2flyNG。多数较新的手机适用 arm64 包,不确定设备架构时可查看通用包及下载页的选择说明。

移动端通常通过系统 VPN 接口接入流量,首次连接需确认系统授权。桌面的系统代理模式不能直接等同于手机端开关;分应用设置和后台运行限制也会影响实际连接范围。

前往下载 Android 客户端

Linux

v2rayN 桌面版提供 deb 与 rpm 安装入口,并区分处理器架构。根据发行版的软件包体系选择格式,再确认设备使用 x64 还是 arm64,避免只看文件后缀就直接安装。

桌面环境对系统代理与托盘的支持存在差异,部分应用需要自行指定代理入口。使用 TUN 前应确认权限和路由环境,尤其留意已运行的虚拟网卡与容器网络。

前往下载 Linux 客户端

客户端安装包解决的是软件部署,不会自动提供可用的远端服务器。连接前仍需准备有效的订阅地址或服务器配置,并确认该配置所用协议受当前内核支持。订阅链接可能包含访问凭据,导入时只在客户端中保存,不要贴到公开讨论或日志截图里。

从其他设备迁移时,优先保留订阅分组、必要的自定义规则与设置记录。系统权限、本地路径和网络接口名称需要在新设备上重新确认。下载页集中说明安装包类型与系统要求;型号之间的定位差异可继续阅读客户端对比。

查看全部客户端 →

Project V 与开源内核生态

客户端负责配置与操作界面,内核负责连接、传输和路由。理解两者分工,比仅凭软件名称判断功能更准确。

从 Project V 到 V2Fly、Xray

Project V 是理解 V2Ray 生态的起点,其核心思路是把入站、出站、传输与路由组合成可配置的网络工具。后来围绕 V2Ray 形成了不同的社区项目。V2Fly 延续了 V2Ray 的社区维护路线,Xray 则从相关代码基础发展为独立演进的内核项目。两者有历史联系,但不能据此认为所有字段、协议特性与默认行为始终一致。

这里的“内核”不是操作系统内核,而是执行代理连接的核心程序。图形客户端把服务器信息与用户选项转换成内核可读的配置,再启动并管理相应进程。因此,界面能保存一个选项,并不必然代表当前选择的内核可以执行它;判断功能是否可用,需要同时看客户端支持和内核能力。

VMess、VLESS 等名称通常对应协议,TLS、REALITY 等涉及连接安全与握手机制,路由规则则决定请求交给哪个出站。这些概念位于不同层次。选择客户端时先确认平台,配置连接时再核对协议与内核,最后处理入口和分流,能减少在多个设置页面之间反复试错。

v2rayN 与两个安卓客户端

v2rayN 以桌面图形管理为主,整合订阅、服务器列表、系统代理和路由操作。跨平台桌面界面与经典 WPF 界面属于界面实现的差别,不应与协议名称混为一谈。可选内核中还包括 sing-box,它是另一个独立项目;它的配置格式不能被当作 Xray 配置直接套用。

v2rayNG 面向安卓设备,使用 Xray 内核;v2flyNG 同样面向安卓,但采用 V2Fly 内核。两者名称接近,选型依据仍应是现有配置的兼容性与所需功能,而不是把其中一个简单视为另一个的替代安装包。首次使用可以先按下载页推荐顺序选择,有明确内核需求时再调整。

开源协议与项目边界

v2rayN、v2rayNG 与 v2flyNG 均为开源客户端,客户端项目采用 GPL-3.0 协议;Xray-core 与 V2Fly 核心采用 MPL-2.0 协议。图形界面和内核是不同项目,授权范围也应分别理解。开源意味着代码可以依协议被查看、使用和修改,并不等于所有网络配置都天然适合当前设备。

客户端、内核以及附带组件可能分别提供许可证说明。个人使用时可以从项目的开源属性了解其技术来源;需要修改或再分发时,则应阅读对应许可证正文,并按实际涉及的代码与组件履行义务。本站提供下载入口与配置文档,不把客户端项目的维护工作归属于本站。

把更新分成三个层次

客户端更新主要改变界面、配置管理与集成方式;内核更新可能改变协议处理、配置解析和连接行为;GeoIP、GeoSite 等规则数据库更新则改变分类数据。三者更新目的不同,不能用更新订阅代替内核更新,也不能指望升级界面自动修正所有路由匹配问题。

订阅更新只是在重新获取配置来源中的内容。更新后服务器条目可能增加、删除或修改,原先手动编辑的条目也可能受到订阅管理方式影响。执行更新前先确认分组,再检查更新结果。遇到证书错误或无法访问地址时,应沿着系统时间、网络连通性、订阅有效性依次排查,而不是一次性改动所有代理参数。

有自定义配置的设备,升级前应保留设置备份,并记录使用的内核与路由预设。升级后先验证基本连接,再检查 DNS、局域网与业务应用。日志适合帮助判断失败阶段,但分享日志前要移除订阅地址、认证信息与可识别的服务器资料。更详细的字段关系见V2Ray 配置文件参考。

配置排查的最小范围

出现无法连接时,先确定本地入口是否运行,再查看内核是否成功加载配置,最后检查远端连接。浏览器与其他程序表现不同,优先比较它们是否使用相同的代理入口;域名可用而部分目标不可用,再检查 DNS 与规则匹配。每次只修改一个层次,并保留修改前的状态,通常比连续切换多个预设更容易找到原因。

如果只是寻找首次安装步骤,可直接阅读使用指南;如果已经知道报错位置,可在疑难解答中按安装配置、使用技巧和故障排查分类查找。需要按字段理解配置结构时,再进入配置大全,避免把轻量上手流程与内核配置参考混在一起。

配置专题与使用记录

从具体设置进入:规则数据库、桌面界面选择,以及 TUN 接入方式。每篇围绕一个问题展开,适合在基本连接完成后继续阅读。

geoip.dat 与 geosite.dat 更新指南:geoip:cn、geosite:category-ads 规则怎么写

介绍 GeoIP 与 GeoSite 两个规则数据库的作用、在 v2rayN 中的更新入口和存放位置,并用路由规则示例演示国家与域名类别的引用写法。

v2rayN Desktop(Avalonia)与 WPF 版区别:Windows、macOS、Linux 该装哪个包

对比 Avalonia 跨平台桌面版与 Windows 专用 WPF 版在界面、系统托盘、平台覆盖上的差异,按操作系统给出安装包的选择建议。

v2rayN TUN 模式开启方法:虚拟网卡接管全局流量的原理与注意事项

解释系统代理与 TUN 虚拟网卡的区别,讲清哪些程序需要 TUN 接入。分步说明启用 Tun 开关、管理员权限要求与 DNS 劫持相关设置。

查看全部文章 →