客户端入口 · 订阅与配置参考

V2Ray发布页·v2rayN 客户端下载与配置参考

下载v2rayN 查看教程

从订阅导入到路由配置，按四个平台选择客户端与操作步骤。

VMess VLESS Trojan Shadowsocks

界面为设置项示意；实际名称随客户端界面调整。示例地址不可用于连接。

配置要点

订阅进来，配置成形

图形客户端负责整理订阅、生成配置与管理连接，内核负责实际处理流量。先分清这两层，再依次设置路由、代理方式与订阅更新，遇到问题时就能判断应检查哪个环节，而不是同时修改所有开关。

路由规则

路由把访问目标与出站方式关联起来。需要某类域名直连时，可添加域名匹配规则，并让出站标签指向已有的直连出站；需要走代理的流量则交给代理出站。规则通常按顺序匹配，因此具体条件应放在宽泛条件之前。图形客户端中的规则设置最终会转成内核配置，排查时要同时核对匹配条件与标签拼写。下方片段只展示规则结构，不能替代完整配置，修改前应先备份当前设置。

系统代理与 TUN

系统代理通过操作系统的代理设置引导支持它的应用连接；v2rayN TUN 模式则借助虚拟网络接口接管符合条件的流量，两者的作用范围不同。浏览器能联网而其他程序不能时，应先确认程序是否读取系统代理，再考虑是否需要 TUN。首次配置宜先验证普通代理连接，之后再处理虚拟网卡、权限与 DNS 设置。两种方式不是越多越好，切换前记录现有状态，避免与其他网络工具的接管规则互相影响。

内核与协议

V2Ray 协议选择应以服务端提供的参数为依据，而不是只比较协议名称。VMess、VLESS 协议以及传输层、安全层的组合需要客户端内核共同支持；只改协议下拉框，不能把原有节点自动转换成另一种服务。Xray 与 V2Fly 同属相关开源生态，但扩展功能与配置细节存在差异。切换内核前，应确认当前节点使用的传输、安全设置和路由功能都能对应，保存后再检查启动日志，避免把兼容性错误误判为网络不通。

订阅分组与更新

订阅地址用来获取节点集合，节点才是实际连接时选用的配置项。v2rayNG 订阅导入与桌面端的基本顺序一致：填写分组名称与地址，保存后执行更新，再从结果中选择节点。分组有助于区分不同来源，也便于单独刷新与排查。更新失败时，先检查地址是否完整、网络能否访问以及订阅是否仍有效；不要反复删除全部设置。订阅链接可能包含访问凭据，截图和求助时应遮住完整地址，手动修改节点前也应考虑后续更新可能覆盖改动。

按使用环境核对设置

桌面端先完成订阅更新并选中节点，再开启系统代理，最后用支持系统代理的浏览器验证。若浏览器正常、终端仍失败，需要单独检查终端工具的代理选项或环境变量；不能据此判断节点失效。需要更多应用进入同一路径时，再阅读 TUN 的权限和路由要求。调整配置后查看日志中的启动错误，确认本地监听端口没有被占用。每次只修改一类设置，保留可用配置，方便比较修改前后的结果。

查看入站、出站与路由配置大全 →

平台入口

V2Ray 客户端，按系统选择

桌面端从 v2rayN 开始；安卓端优先了解 v2rayNG，已有 V2Fly 配置需求时再对照 v2flyNG。下载前先看系统类型和处理器架构，安装包格式不同，并不意味着订阅需要重新购买或重新生成。

Windows

v2rayN 提供 Desktop 与经典 WPF 两种界面入口。Desktop 使用跨平台界面，WPF 保留熟悉的桌面操作方式；选择时以系统要求、界面习惯与现有配置兼容性为准，不必为了界面不同而同时运行两套客户端。

首次安装将程序放在便于管理的目录，按下载页说明处理运行环境。启动后先导入订阅，再验证系统代理；若程序闪退，应先检查运行库、解压路径与安全软件提示，而不是直接修改节点参数。

前往下载

macOS

v2rayN 的桌面入口按 Apple Silicon 与 Intel 芯片区分。可先在系统的“关于本机”中确认芯片类型，再选择相应安装包。架构选择影响程序能否正常运行，不改变订阅地址本身的用途。

首次打开时按系统提示完成必要授权，再检查系统代理与已有网络工具是否冲突。不同系统的菜单位置可能有所差异，但订阅分组、节点选择和路由规则的基本关系相同，配置参考中的概念仍可直接对照理解。

前往下载

Android

v2rayNG 下载入口提供 arm64 与通用包，选包时以设备实际支持的架构为准；不能确定时先查看下载页说明。v2rayNG 使用 Xray 内核，v2flyNG 则作为 V2Fly 内核的备选客户端，选型时应结合节点功能需求。

安装完成后再执行订阅导入，并在首次连接时确认系统 VPN 权限。若连接只在前台有效，应检查电池管理与后台限制；若只有个别应用失败，则检查应用分流。不要把后台策略和协议兼容性混为同一个问题。

前往下载

Linux

v2rayN 的 Linux 入口按 deb、rpm 包格式和处理器架构区分。先确认发行版使用的软件包体系，再确认是 x64 还是 arm64，避免把包格式问题误认为客户端无法启动。图形客户端需要可用的桌面环境。

安装后先以普通代理方式验证连接，再根据发行版的权限管理与网络设置决定是否启用 TUN。桌面应用与终端工具读取代理的方式可能不同；本地监听可用不代表所有程序都已经使用该代理，应分别检查实际连接路径。

前往下载

查看全部客户端 →

快速上手

订阅导入，三步验证

客户端安装完成后，按“取得配置 → 选择路径 → 验证结果”的顺序操作。订阅、节点与代理模式分别解决不同问题：订阅负责获取配置，节点决定连接目标，代理模式决定哪些应用流量进入客户端。

  1. 新建订阅分组并更新

    在客户端的订阅管理或订阅分组设置中添加名称与完整地址，保存后执行更新。分组名只是便于辨认的本地标记，不能代替订阅地址。更新成功后应能看到解析出的节点；若列表为空，先确认返回内容是否为当前客户端支持的格式，再检查地址是否过期或复制不完整。

    导入二维码、单条分享链接与订阅地址是不同入口，应按手头材料选择。本文的示意链接只是展示字段位置，不提供连接配置。已有可用设置时，先备份再导入，避免把订阅更新覆盖、分组筛选或重复条目误认为导入失败。

  2. 选择节点与代理模式

    从更新结果中选择一个节点作为当前连接项。桌面端先使用系统代理配合浏览器验证，安卓端启动连接并确认系统权限；此时暂不叠加复杂的路由规则。系统代理、TUN 与应用分流属于不同层面的设置，应在基础连接成功后逐项调整。

    不要一次切换协议、内核、DNS 与路由模式。若某次修改导致连接失败，先恢复最近一项更改，观察日志是否出现明确的配置或连接错误。多款网络工具同时接管流量时也会增加排查难度，测试前应确认当前实际工作的客户端。

  3. 检查日志与实际访问

    V2Ray 节点测速要区分连通性测试、请求延迟和实际下载吞吐。列表中的测试结果只能反映特定目标与当时网络条件，不能直接代表所有网站的体验。首次验证使用同一网络与同一目标，结合浏览器访问和客户端日志判断连接是否真正建立。

    测试失败时，按本地监听、应用代理设置、节点参数、服务端状态的顺序缩小范围。若只有终端失败，单独检查终端工具；若切换网络后结果变化，再检查当前网络环境。记录错误类型比反复点击测速更有帮助，也能为后续求助保留清晰线索。

查看完整教程 →

开源生态

客户端与内核，分层理解

Project V、V2Fly、Xray 与图形客户端不是同一个层级的名称。理解项目关系，有助于判断教程中的设置究竟属于界面、内核还是服务端，也能减少照抄不同版本配置时的兼容性问题。

Project V 与 V2Fly 的关系

Project V 是围绕网络代理工具形成的开源项目生态，V2Ray 是其中广为使用的核心项目。V2Fly 社区延续了 V2Ray 核心的开发与维护；在文档中看到 V2Fly 时，通常需要关注的是其内核实现与配置支持范围，而不是把它当成另一种订阅服务。图形客户端可调用内核完成连接，但客户端界面上的按钮名称不一定与内核配置字段逐字一致，阅读配置大全时应以字段含义为准。

Xray 分支与协议兼容性

Xray 由相关代码基础发展为独立演进的内核项目，拥有自身的功能扩展与配置要求。两类内核在部分常见配置上存在交集，但不能据此推断所有传输方式、安全选项与路由字段都可互换。判断一个节点能否使用，应检查完整参数组合，而不只看 VMess 或 VLESS 的名称。服务端提供了特定扩展参数时，还需要确认客户端所调用的内核确实支持，单纯换一个图形界面未必能解决兼容问题。

三款开源客户端的职责

v2rayN 面向桌面环境，提供订阅管理、节点选择和代理设置等图形操作；v2rayNG 面向安卓，使用 Xray 内核；v2flyNG 则面向需要 V2Fly 内核的安卓使用场景。三款客户端均为开源软件，客户端代码与随附内核分别受各自开源许可证约束。开源意味着代码可以按许可证条件查看、使用与修改，并不意味着不同客户端必须具有完全相同的功能，也不代表其界面设置可以不加检查地相互复制。

客户端更新与订阅更新

客户端更新改变程序和随附组件，订阅更新刷新远端提供的节点集合，两者互不替代。订阅更新后，手动改过的节点参数可能重新生成；客户端更新后，设置项位置、默认值或支持能力也可能调整。因此，变更前应保留配置备份，变更后先测试一条已知配置，再检查分流与 DNS 行为。本站按系统整理客户端入口，并用教程说明操作顺序；具体发布信息在下载页查看，配置细节则在配置大全中逐段核对。

教程动态

配置与排查，近期文章

基础连接完成后，再按实际遇到的问题阅读专题。安装、协议选择与系统代理属于不同排查方向，先辨认症状，再对照操作步骤，比同时尝试多种修改更容易定位原因。

查看全部文章 →