客户端入口 / 配置文档

v2rayN 客户端 下载与配置

下载v2rayN 查看教程

按系统选择开源客户端，从订阅导入开始，依次配置系统代理、路由分流与 DNS。

协议
VMessVLESSTrojanShadowsocks
Windows Android macOS Linux
配置工作台

从订阅分组到内核选择

先区分设置负责的环节，再逐项调整。下方为设置项示意；入口名称可能随客户端界面更新略有变化。

按来源保存订阅与筛选条件

订阅分组把链接、更新方式与服务器列表分开管理。先在“订阅分组设置”中填写名称和订阅地址，再更新对应分组，避免把单条分享链接误当作订阅。来源较多时，使用备注与过滤条件缩小列表，保留手动添加的服务器。与一次性粘贴服务器相比，分组能保留来源关系，后续更新更清楚。删除或改写过滤条件前，先确认当前选中分组，避免误处理其他来源的配置。

设置项示意

分组名称订阅分组 A
订阅地址按来源填写
服务器过滤按备注筛选
更新范围当前分组
相关章节：订阅分组与服务器过滤 →
平台入口

V2Ray 客户端下载选择

桌面系统先看 v2rayN；移动设备再按内核需求选择。下载页集中说明处理器架构、安装格式与安装注意事项，入口随平台切换。

Windows

v2rayN · 桌面版 / WPF 版

桌面版采用跨平台界面，WPF 版保留经典 Windows 界面。首次使用可先阅读两版说明，再选择符合操作习惯的入口；不要把两版程序解压到同一个目录，避免配置与运行文件混在一起。

安装前确认系统与处理器类型。首次启动后先导入订阅，再设置系统代理；浏览器仍沿用旧设置时，检查系统代理地址与客户端监听端口是否一致。

前往下载

macOS

v2rayN · Apple Silicon / Intel

先在“关于本机”查看芯片信息。Apple Silicon 对应 arm64，Intel 对应 x64；安装格式相同不代表处理器架构相同。选择匹配的安装入口，后续权限与更新流程更容易保持一致。

将应用移入“应用程序”后启动，按系统提示处理权限。若普通代理可用而 TUN 无法启用，应单独检查授权与网络接口，不必立即删除订阅或重新填写服务器参数。

前往下载

Android

v2rayNG · v2flyNG 备选

优先查看基于 Xray 的 v2rayNG；需要 V2Fly 内核环境时再查看 v2flyNG。主流设备通常选择 arm64，架构不确定时阅读下载页的通用包说明，不按文件大小判断兼容性。

导入配置后，首次连接需要确认系统 VPN 授权。若切换到其他应用后连接中断，再检查系统电池优化与后台运行限制。切换客户端时应先停止原连接，避免系统连接权限互相替换。

前往下载

Linux

v2rayN · deb / rpm

根据发行版的包管理方式选择 deb 或 rpm，再区分 x64 与 arm64。图形客户端仍需要桌面环境及对应运行条件；处理器架构与软件包格式是两项独立条件，不能只核对其中一项。

不同桌面环境对系统代理的读取方式不同。应用未自动使用代理时，可检查应用自身的代理入口，并核对本地监听地址。需要 TUN 时，再按文档确认权限与路由，保留可恢复的原网络设置。

前往下载
查看全部客户端 →
首次配置顺序

导入、选择模式、验证连接

先让一套基础配置完整运行，再增加分流与接管范围。每次只改变一个环节，出现问题时才能判断原因。

  1. 01 / 配置来源

    导入订阅并选中服务器

    v2rayN 从“订阅分组”进入“订阅分组设置”，新建分组后填写订阅地址，再执行对应分组的更新操作。v2rayNG 在“订阅设置”中添加来源，再更新订阅。单条分享链接应使用剪贴板导入入口，不能直接替代订阅地址。

    列表出现内容后，检查服务器备注、协议和传输设置，再选中需要使用的服务器。订阅地址可能携带访问凭据，应避免放入公开截图。更新返回空列表时，先检查链接是否完整、来源是否仍有效，以及是否设置了过窄的过滤条件。

  2. 02 / 流量入口

    分别设置系统代理与路由

    桌面端先选择“自动配置系统代理”，让遵循系统设置的应用把流量交给客户端，再选择适合需求的路由模式。“全局”描述进入客户端后的出站策略，不等于自动接管设备上的全部应用。普通网页访问通常可以先从系统代理开始验证。

    “不改变系统代理”会保留系统现有设置，“清除系统代理”则移除相应代理配置。需要恢复普通访问时，应明确选择正确操作，而不是只关闭窗口。暂时不要同时启用 TUN、改写 DNS 和添加自定义路由，否则故障来源会变得难以区分。

  3. 03 / 结果检查

    确认入口、解析与出站

    连接后用同一应用访问一个已知可用的目标，确认请求确实经过预期入口。若客户端支持连接信息或日志，检查所用出站及错误类型；界面显示运行中，只代表相关进程启动，不代表目标网站一定能够访问。

    浏览器可用而其他应用失败，先排查应用是否读取系统代理；域名失败而地址访问表现不同，再检查 DNS；全部目标均失败，再核对服务器参数与网络条件。保留一次改动前后的结果，按相同目标复测，比连续切换多个模式更有助于定位问题。

查看完整教程 →
项目与内核

Project V、V2Fly 与 Xray 的关系

客户端名称、内核名称和代理协议不是同一层概念。分清这三层，才能判断配置能否导入、连接由谁执行，以及更新时应关注哪些变化。

配置管理v2rayN / v2rayNG / v2flyNG
连接执行Xray / V2Fly
协议与传输按服务器配置匹配

生态来源：从 Project V 到不同内核线

Project V 是围绕网络通信工具形成的开源项目体系，V2Ray 是其中的重要实现。V2Fly 社区持续维护 V2Ray 相关实现；Xray 则从相关代码基础发展为独立内核分支。两条路线拥有相近的概念与配置传统，但后续功能、协议扩展和实现细节各自演进，不能简单理解为只有名称不同。

“V2Ray 客户端”在日常搜索中常指这一生态的图形工具，不代表所有工具都运行相同内核。服务端给出的配置若要求特定协议扩展，应先核对实际内核支持情况，而不是只看应用名称中是否带有 V2Ray。配置字段看起来相似，也不保证能够直接交换使用。

阅读教程时，还要区分图形菜单与内核配置文件。菜单中的一个开关可能会生成多项底层配置；直接编辑配置文件后，又可能在下一次界面保存时被重新生成。日常管理优先使用图形入口，需要自定义内容时先了解客户端的生成和合并方式。

三款客户端：界面与内核各有职责

v2rayN 面向桌面环境，负责服务器管理、订阅更新、路由选择及相关设置，并调用对应内核执行连接。v2rayNG 面向 Android，使用 Xray 内核；v2flyNG 则提供基于 V2Fly 的 Android 客户端选择。三款客户端均属于开源软件，具体使用方式仍应结合各自界面与所带内核判断。

图形界面主要解决配置管理问题：保存来源、选择服务器、生成运行参数和显示信息。内核主要处理协议握手、传输、解析与路由。界面可以成功读取订阅，不等于内核一定支持其中每一种组合；同样，内核启动失败也不一定意味着订阅地址错误，可能只是某个参数或运行条件不满足要求。

桌面端与移动端的流量入口也不同。前者常从系统代理开始，后者通常需要系统 VPN 授权。迁移配置时，可先迁移同一条服务器配置并验证，再处理分组、规则和其他设置，避免把不同平台的接管方式当成可以逐项照搬的选项。

开源协议：按组成部分分别理解

开源意味着源代码按相应许可证开放，并允许在许可证条件下使用、研究和分发。V2Fly 的 V2Ray 内核采用 MIT 许可证，Xray 内核采用 MPL 2.0 许可证；图形客户端及其依赖还有各自的许可证。讨论软件授权时，应区分客户端、内核和附带组件，不能把其中一项许可证套用于整个软件组合。

对于日常用户，开源属性有助于理解项目来源和技术实现，但不能替代具体配置检查。订阅来源决定服务器参数，服务端运营者决定相关服务条件，客户端则负责本地连接与管理。这些环节相互配合，职责不同；安装客户端本身不会自动生成可用的订阅或服务器。

分享问题时，保留协议类型、系统环境与错误信息通常已经足够。完整订阅地址、身份标识和私有连接参数不适合直接公开。文档中的示意设置只用于解释配置结构，不是可直接连接的服务，也不能替代来源提供的实际参数。

更新顺序：先看兼容性，再改配置

客户端界面、内核程序、订阅内容与路由数据可以分别变化。客户端更新不一定会改变订阅，订阅更新也不等于升级内核。遇到连接变化，应先记录最近修改了哪一层，再有针对性地检查。仅凭界面外观或文件日期，很难判断实际运行的内核是否符合配置要求。

更新前保存当前可用配置，并阅读安装格式、权限与数据目录说明。更新后先用原服务器和原模式测试，再逐项启用新增功能。如果是内核启动失败，应优先检查启动信息与配置兼容性；如果只有某个订阅来源异常，则先检查来源返回内容，不必立即重装整个客户端。

进阶配置建议保留一份简短变更记录，包括调整的路由、DNS 策略和 TUN 状态。恢复时按相反顺序撤销，能避免遗留系统代理或虚拟接口设置。需要继续排查时，可沿着“应用入口、域名解析、路由匹配、服务器连接”的顺序阅读手册，而不是不断重复导入相同订阅。

阅读项目介绍 →打开进阶配置手册 →
配置专题

订阅导入、协议与代理模式

基础设置之后，按当前问题选择专题。先确认概念边界，再回到客户端调整对应选项，不必一次读完全部进阶配置。

查看全部文章 →