客户端安装与配置索引

V2Ray安装包下载 v2rayN · v2rayNG · v2flyNG 客户端

按系统选择开源客户端,用中文配置教程完成订阅导入与路由设置;桌面端从 v2rayN 开始,安卓端优先了解 v2rayNG。

协议 / 安全层
  • VMess
  • VLESS
  • Trojan
  • Shadowsocks
  • REALITY

安装包与
平台选择

先选操作系统,再确认处理器架构。桌面端集中使用 v2rayN,安卓端优先选择采用 Xray 内核的 v2rayNG,需要 V2Fly 配置环境时再看 v2flyNG。安装包负责提供程序,实际连接还需要可用的服务配置;下载客户端并不会自动生成订阅地址。

首次安装不必同时准备多个客户端。先让一款客户端完成导入、启动与访问验证,再考虑迁移已有设置。切换安装包格式也不会改变服务端的协议要求,架构不匹配、协议字段不完整和地址过期,应当分别处理。

Windows

v2rayN 提供桌面版与经典 WPF 版入口。桌面版采用跨平台界面,WPF 版保留经典操作布局。先按系统要求选择,已有使用习惯时再比较界面差异。

下载页会列出对应安装方式。首次运行后,先确认内核能启动,再导入订阅;若系统提示程序无法运行,应先检查处理器架构与运行环境,不要反复更换节点来排查安装问题。

前往下载

macOS

v2rayN 按 Apple Silicon 与 Intel 提供不同安装包。在“关于本机”中查看芯片或处理器信息:前者对应 arm64,后者对应 x64,不能只凭电脑外观判断。

完成安装后再设置订阅与系统代理。遇到系统安全提示时,先核对下载来源和提示内容,再按系统提供的方式处理。把应用移到固定位置,也便于后续管理配置与更新。

前往下载

Android

优先了解 v2rayNG;v2flyNG 是使用 V2Fly 内核的备选。主流较新手机通常选择 arm64,不确定设备架构时可查看系统信息,再考虑通用包。

首次连接需要确认系统的 VPN 授权。后台运行、应用省电限制和按应用代理也会影响使用表现。若锁屏后连接中断,先检查电池管理策略,不要直接把问题归因于订阅或协议类型。

前往下载

Linux

v2rayN 提供 deb 与 rpm 安装入口,并区分 x64、arm64。先确认发行版采用的软件包格式,再核对处理器架构;软件包格式与桌面环境是两回事。

安装图形客户端后,系统代理是否被应用采用,还取决于桌面环境和应用自身设置。浏览器能访问而其他程序不能时,先检查程序的代理入口。命令行工具也可能需要单独设置代理参数。

前往下载

v2rayN 常用设置

订阅分组与更新

订阅分组适合把不同来源的配置分开管理。在分组设置中填写备注与完整地址,启用更新后执行一次手动更新,再确认是否出现配置条目。订阅地址是配置集合的入口,不等于单条节点分享链接。与逐条手动添加相比,分组更新更便于同步服务端变更;但自动更新失败不一定代表现有连接失效。先看日志中的请求错误或格式提示,检查链接是否过期,再决定是否调整更新方式。界面名称会随客户端更新略有变化。

订阅分组 → 地址(URL)启用更新:开自动更新间隔(分钟)

首次连接
三步检查

安装完成后,按“配置进入客户端、应用进入代理、请求按规则出去”的顺序操作。这三个环节分别出错时,表现可能都像无法连接。把每一步单独确认,比一次修改协议、DNS 和端口更容易找出原因。下方是快速预览,具体菜单与操作顺序见完整教程。

  1. 导入订阅,确认配置条目

    在 v2rayN 的订阅分组中添加地址并更新,或在 v2rayNG 中使用对应的导入入口。复制链接时检查开头、结尾和换行,避免把说明文字一起带入。更新后确认条目所属分组、协议类型与备注,再选择一条作为当前配置。

    订阅内容为空与请求失败是不同情况:前者可能涉及服务状态或返回格式,后者更需要检查地址有效性与请求错误。不要把订阅地址贴到公开页面,也不要根据链接外观猜测其中是否包含访问凭据。出现问题时,分享已隐去敏感信息的错误描述更合适。

  2. 选择模式,启动本地入口

    桌面端确认内核已启动,再选择系统代理与路由预设;安卓端确认连接配置,并接受系统 VPN 授权。初次测试先保留较少的自定义项,确保当前配置本身可用。已经运行其他代理工具时,要留意本地端口与系统代理是否被重复修改。

    若应用采用独立代理设置,应将地址与端口指向当前客户端实际监听的位置。不要把 SOCKS 端口当作 HTTP 端口填入。仅在确有需求时调整局域网访问、额外入站或复杂分流,先建立一个可以重复验证的基础配置。

  3. 验证访问,再读错误日志

    用平时使用的浏览器打开目标站点,同时确认本地服务是否仍可正常访问。一次访问失败不能直接判定协议不可用:域名解析、系统时间、应用代理和服务端状态都可能参与其中。先看内核有没有启动,再检查请求是否进入代理。

    V2Ray 延迟测试和 V2Ray 节点测速也应区分用途。连接测试只能反映特定目标、特定时间下的结果,不能替代实际页面访问。出现超时或握手失败时,记录错误类型,每次只调整一项设置,再用同一目标复测,才能判断改动是否有效。

查看完整教程 →

Project V 生态
与内核选择

“V2Ray”常被用来统称一类配置与客户端,但下载时需要分清具体层次。Project V 是这一生态的重要起点,V2Ray 提供可组合的网络代理能力;V2Fly 社区延续 V2Ray 的开发与维护,Xray 则是从相关代码基础发展出的另一条内核路线。它们共享部分概念与配置习惯,但功能演进并不完全一致。

图形客户端与内核各做什么

图形客户端提供分组、菜单、订阅更新和连接控制。内核负责解析配置、建立连接、匹配路由并处理数据流。因此,客户端界面看起来相近,不代表底层能力完全相同。同一款客户端也可能随着内核更新获得新的配置支持,判断兼容性时应同时了解客户端与所用内核,而不是只看应用名称。

v2rayN 面向桌面环境,提供多内核配置入口;v2rayNG 面向安卓环境,采用 Xray 内核;v2flyNG 则提供基于 V2Fly 内核的安卓备选。三款客户端都是开源软件,使用场景与功能范围各有侧重。选择时先看设备和已有配置,桌面端与安卓端不必追求完全相同的菜单,只需核对关键字段是否表达了同一套连接要求。

协议名称不能单独决定体验

VMess、VLESS、Trojan 与 Shadowsocks 是常见的协议类型,REALITY 则属于安全层相关技术,不应把它们全部当作互斥的同一层选项。实际配置往往还包含传输方式、服务器名称、证书验证与流控等参数。服务端提供什么组合,客户端就需要按相应组合配置,不能只替换协议下拉框就期待连接成功。

连接速度、资源占用与移动端电量也不能只靠协议名称排序。服务器距离、链路质量、握手过程、传输封装和设备性能都会影响结果。已有稳定配置时,优先保留能满足需求的方案;需要比较时,在相同网络、相同目标和相近时间下测试。对普通使用者而言,字段完整、内核支持和配置可维护,通常比追逐某个名称更重要。

开源协议与使用边界

开源意味着代码按照项目采用的许可证开放,并不意味着所有组成部分使用同一份许可证。客户端、内核及其依赖可能适用不同条款,使用、修改或再分发时,应分别阅读对应项目附带的许可说明。开源属性便于理解实现与维护路径,但不能代替对运行环境、服务来源和配置内容的判断。

客户端本身不提供远程服务器,也不会替用户生成可用账号。订阅中的地址、凭据和使用期限由配置来源决定,与本地应用是否成功安装是两件事。本站整理安装入口和中文说明,帮助区分这些层次;涉及具体服务状态的问题,需要结合配置来源的说明与客户端日志判断。

客户端更新与订阅更新分别处理

订阅更新是在获取配置内容,客户端更新是在替换应用程序,内核更新则可能影响协议能力与配置解析。三者并不等价。订阅更新成功,不说明应用程序已经更新;安装新的客户端,也不会自动修复已经失效的服务地址。先判断问题属于哪一层,再选择相应操作,可减少不必要的重新安装。

更新前记录当前的路由模式、自定义规则和本地监听设置,并通过客户端提供的方式保存必要配置。更新后先验证原有使用场景,再逐项启用新增功能。涉及内核切换时尤其要检查协议字段与 DNS 行为;旧环境能运行的配置,迁移到另一内核后仍需要重新验证,不宜直接套用兼容性结论。

常见问题的排查入口

v2rayN 订阅更新失败:先检查地址完整性、有效期与日志中的请求结果。节点仍可使用时,优先排查订阅获取环节,不要急着删除全部配置。订阅与节点的区别可在术语手册中查阅。

V2Ray 无法连接:按内核启动、本地监听、应用代理、路由与远程握手的顺序检查。只有浏览器失败和所有应用都失败,排查方向不同;配置报错与连接超时也应分别处理。先读懂内核、监听与路由术语,再对照教程操作。

V2Ray 节点测速结果不同:不同测试方法可能使用不同目标与连接过程。显示可连接不代表所有站点都能访问,某次结果也不能代表长期表现。先明确测试项目,再结合真实使用场景判断,相关概念见术语手册。

阅读协议与内核技术参考 →

教程动态
与技术文章

基础连接跑通后,再按遇到的问题深入阅读。协议入门帮助辨认订阅中的类型,自定义路由文章说明匹配顺序,路由器部署概览则介绍图形客户端之外的内核运行环境。先确认文章讨论的是哪一层,再把其中建议应用到当前设备,避免把服务端参数、桌面设置与网关配置混在一起。

v2rayN下载