客户端选型 / 安装 / 配置

V2Ray官方下载

v2rayN · v2rayNG 客户端,支持 Windows / macOS / Android / Linux。围绕开源客户端,整理四平台安装与订阅导入路径;从系统代理到路由规则,按设置层次查阅。

  • VMess
  • VLESS
  • Trojan
  • Shadowsocks
  • REALITY

Xray-core · V2Fly-core · GPL-3.0 开源客户端

订阅、路由与代理入口

V2Ray 客户端的日常设置可以拆成四层:订阅负责取得和整理连接配置,内核负责执行协议与传输,系统代理决定部分应用是否把流量交给客户端,路由再决定进入客户端的流量走哪个出口。遇到问题时,先分清所在层次,比反复更换全部设置更容易找到原因。

下方以 v2rayN 的菜单结构说明操作位置。窗口为空列表示意,不代表已经导入配置或建立连接;不同系统与客户端发布包的菜单位置可能略有区别。先理解设置用途,再对照教程操作,可以减少把路由模式当作系统代理开关、把订阅更新当作内核更新的混淆。

v2rayN
服务器订阅分组设置帮助
别名地址端口类型
系统代理路由

排查顺序也应沿用这四层:列表为空时先处理导入;内核无法启动时先看配置和端口;浏览器请求没有进入客户端时检查接入方式;只有部分目标异常时再查规则和解析。每次只调整一项,并记录修改前后的现象,才能区分设置错误与远端服务问题。具体症状可转到故障排查手册逐项核对。

按系统与架构选择客户端

桌面系统优先从 v2rayN 开始,安卓设备优先查看 v2rayNG,已有 V2Fly 配置需求时再比较 v2flyNG。安装包首先要匹配操作系统与处理器架构,之后才是界面形式和内核选择。下载页集中提供各平台入口与安装说明;客户端只处理连接配置,不附带可用的远端服务,首次启动仍需准备合法取得且有效的订阅或服务器配置。

Windows

v2rayN

Windows 桌面使用 v2rayN。下载页区分新一代跨平台界面的桌面版与经典 WPF 版,两种入口面向不同的界面使用习惯。初次安装可先阅读各自的系统要求,已有配置的用户则应先备份订阅分组、路由与自定义设置,再决定是否迁移。

启动后先确认客户端能够正常保存配置和启动内核,再导入订阅、选择服务器及设置系统代理。若退出后浏览器仍无法访问,应检查系统代理是否指向已停止的本地端口。不要让多个代理程序同时接管同一组系统设置,也不要把重新安装作为每一种连接故障的首选处理方式。

前往下载

macOS

v2rayN

macOS 使用 v2rayN,先在“关于本机”中确认芯片信息:Apple Silicon 对应 ARM64,Intel 处理器对应 x64。按芯片选择安装包,可以减少因架构不符造成的启动问题;具体系统要求以下载页及所选发布包说明为准,不应根据设备外观或购买年份猜测。

安装后先在应用界面完成订阅管理,再检查系统网络代理。不同网络服务可能保留各自的代理设置,切换网络后出现差异时,应核对当前正在使用的网络连接。遇到系统安全提示,按提示确认应用来源与授权事项,不需要为了完成安装而关闭整套系统安全机制。

前往下载

Android

v2rayNG / v2flyNG

Android 首选使用 Xray 内核的 v2rayNG;需要 V2Fly 内核时,可查看 v2flyNG 作为备选。大多数较新的手机适用 ARM64 包,不确定设备架构时可查看系统信息或下载页的通用包说明。两款应用名称相近,但配置能力取决于各自所使用的内核,不能仅凭外观判断参数兼容。

首次启动连接时,系统会请求建立本地 VPN 接口的权限,这是安卓客户端接入设备流量的方式。授权后还需确认订阅已经更新、当前配置已经选定。若切到后台后连接中断,再检查电池优化与后台运行限制;若只有部分应用异常,则检查分应用规则及是否存在其他占用 VPN 接口的程序。

前往下载

Linux

v2rayN

Linux 桌面使用 v2rayN,按发行版的软件包体系选择 deb 或 rpm,再按处理器选择 x64 或 ARM64。Debian、Ubuntu 系通常使用 deb,Fedora 系通常使用 rpm。软件包格式与处理器架构是两项独立条件,选对其中一项并不意味着另一项也匹配。

安装后应检查图形界面依赖、用户配置目录的写入权限及内核启动状态。不同桌面环境对系统代理的支持方式并不完全一致,某个应用没有走代理时,可以先查看该应用的网络设置。计划随桌面登录自动启动时,先完成手动启动和访问测试,再配置登录自启动,避免把启动顺序问题与订阅问题混在一起。

前往下载

从订阅导入到访问验证

首次配置先使用一套明确有效的参数,完成最短连接路径,再逐步增加规则。桌面的 v2rayN 与安卓的 v2rayNG 在菜单位置和流量接入方式上有所不同,但基本顺序一致:取得配置、选定当前服务器、启用接入方式、验证访问。下面保留必要步骤,完整教程再按界面展开说明。

  1. 添加订阅并更新列表

    复制完整订阅地址,在订阅分组设置中新增分组,填入便于辨认的名称后保存,再执行更新。订阅地址与单条服务器分享链接的导入入口不同,粘贴前应确认内容类型。更新后检查是否出现配置条目;若列表仍为空,先核对地址是否过期、复制时是否带入多余空格,以及当前网络能否访问订阅服务。

    不要把更新订阅理解为购买或开通服务。客户端只是读取配置,订阅的有效期与访问权限由其提供方决定。向他人说明问题时,可描述错误提示,但应隐藏完整订阅地址、身份标识和认证参数。

  2. 选择配置与流量接入方式

    从列表选定当前使用的服务器,先沿用明确的默认路由,再启用桌面系统代理或安卓连接开关。桌面系统代理主要影响遵循该设置的应用;安卓客户端则通常通过本地 VPN 接口接入流量。两者都不意味着所有程序必然采用相同网络路径,因此不能只凭开关状态判断整个设备的连接情况。

    此时先不要叠加自定义 DNS、复杂规则和多个代理程序。确认内核启动成功、本地监听正常,再处理按域名直连、局域网访问或分应用设置。后续更改规则时保留原始设置,方便出现异常后恢复对照。

  3. 验证实际访问并保留日志

    分别访问预期走代理和预期直连的目标,观察客户端日志是否收到请求。连接按钮处于开启状态,只说明客户端尝试运行,并不能替代实际访问验证。若请求没有进入客户端,应查应用代理设置;若已经进入但无法完成连接,再核对服务器参数、内核兼容和远端可达性。

    记录发生问题的时间、网络环境与具体错误,排查时一次只改变一项。停止使用桌面客户端前,确认系统代理已按需要清除。对于间歇性问题,应比较不同网络下的表现,而不是只根据一次测试结果判断客户端或服务器是否正常。

Project V、内核与图形客户端

项目名称与职责边界

Project V 是理解 V2Ray 生态的起点。日常所说的“V2Ray”可能指代理内核,也可能泛指围绕相关协议和配置形成的工具生态。图形客户端在内核之外提供服务器列表、订阅分组、系统接入与日志查看界面。把这两类软件区分开,才能准确理解“客户端能够启动”与“内核能够处理某项配置”为什么不是同一件事。

V2Fly 社区延续了 V2Ray 的维护与演进,Xray 则是从相关代码与技术背景发展出的独立分支。两条内核线存在共同背景,但会各自增加功能、调整配置和安排发布。它们并非同一程序的两个显示名称,也不能用简单的“新旧替代”概括。选型应根据实际协议、传输、安全参数与客户端支持情况进行。

协议支持不等于配置通用

VMess、VLESS、Trojan 与 Shadowsocks 属于连接配置中常见的协议名称;REALITY 则涉及连接的安全机制,不宜与前者简单视为同一层级的选项。某个客户端能显示一种协议,并不说明其包含的任意内核都支持全部相关参数。比较方案时,需要一起看协议、传输方式、安全设置和远端要求。

例如涉及 REALITY 的配置,应确认所选内核和客户端能正确处理相应字段。切换到另一条内核线前,应阅读功能差异,并保留可以恢复的配置副本。遇到字段无法识别或启动失败,先回到兼容性问题,而不是随意删除参数直到界面不再报错。更完整的名词解释可在术语表中按分类查阅。

开源许可与使用边界

v2rayN、v2rayNG 与 v2flyNG 采用 GPL-3.0 开源许可。开源意味着代码与许可条款可供研究,使用、修改和分发仍需遵循相应条款。客户端、所调用的内核及其他随附组件可能有各自的许可要求,不能把界面项目的许可名称直接当作整个生态的统一许可。

客户端永久免费与远端服务收费是两件不同的事。图形工具不会因为安装完成就自动生成有效的连接权限。使用者还应了解订阅来源、配置用途与所处网络环境的要求,避免将软件名称或站点品牌误认为某项远端服务的授权证明。

更新策略与可恢复配置

客户端更新、内核更新和订阅更新分别处理界面程序、连接执行组件与服务器配置。三者可能影响不同设置,不宜在发生问题时同时更换。更新客户端前先备份订阅分组、自定义路由和必要的应用设置;完成后先测试原有连接,再启用新增功能。

这里整理的是下载与中文使用路径,品牌文字作为站点名称使用,不代表各上游项目的授权关系。安装入口集中在下载页,首页不固定展示具体发布编号。实际选择时,以下载页可用安装包、对应系统要求和配置兼容说明为准;更新后的异常可按故障排查流程定位。

内核关系与代理模式

完成基础配置后,再阅读生态与模式说明。先分清客户端和内核,再理解系统代理与路由的边界,后续比较功能和排查故障才有共同语境。以下按发布日期列出最近三篇文章,内容分别对应项目关系、内核差异和流量路径。