桌面与安卓 · 客户端配置指南

V2Ray 客户端 下载与配置指南

下载v2rayN 查看教程

从 订阅导入到路由分流，按真实菜单梳理 v2rayN 与 v2rayNG 的设置顺序。

代码开源 Xray / V2Fly 生态 中文配置文档

界面为设置项示意；菜单位置与可用内核以实际客户端为准。跨端使用配置前需确认内核与字段兼容。

配置入口

订阅、路由与内核设置

先区分配置来源、流量入口和请求去向，再调整高级字段。图形客户端管理设置，内核按生成的配置执行连接；两层各有职责。

订阅分组与更新范围

订阅地址用于获取一组服务器配置，不等于单条分享链接。在 v2rayN 的「订阅分组设置」中填写备注和地址，保存后更新对应分组；在 v2rayNG 中通过「订阅分组设置」添加，再执行「更新订阅」。按来源分别建组，能保留更新边界，避免把手动配置与订阅内容混在一起。更新后先检查服务器地址、协议和传输设置，再切换活动配置。订阅可能包含访问凭据，截图和排查记录中应隐藏完整地址。

addressportprotocol
查看订阅导入步骤 →

初次配置时，建议只走一条明确路径：添加一个订阅分组，选择一条可用配置，启用本地代理入口，再检查一次目标应用。完成这条路径后，再增加域名分流、应用名单或自定义 DNS。每次只修改一类设置，能把故障限定在具体层次；同时调整内核、端口和路由，往往会丢失原本可用的参照状态。

这里的界面卡用于对照菜单概念，不代替实际配置。不同客户端的按钮名称可能随界面调整，判断依据仍是设置本身的作用：订阅负责获取配置，入站负责接收本地请求，出站负责建立连接，路由负责选择出站。需要编辑 JSON 时，先阅读配置字段参考，确认字段属于哪一段，再决定是否需要离开图形界面。

客户端下载

按系统与设备架构选择

桌面使用 v2rayN，安卓优先查看 v2rayNG。安装包还需匹配处理器架构与系统环境；先在设备设置中确认，再进入对应平台下载页。

Windows

v2rayN 提供桌面版与经典 WPF 版入口。桌面版采用跨平台界面，WPF 版保留经典桌面操作布局。选择时先核对系统要求，再根据日常使用的菜单布局决定；两者不需要为了导入同一份订阅而同时运行。

首次启动后检查本地监听端口与系统代理状态。旧客户端仍在运行时，可能占用相同端口；退出旧实例后再测试。若浏览器另有代理扩展，也应先确认它是否覆盖系统设置，避免出现两个入口相互干扰。

前往下载 Windows 客户端

macOS

v2rayN 按 Apple Silicon 与 Intel 分别提供入口。在「关于本机」中查看芯片或处理器信息，再选择对应安装包。处理器架构与界面语言无关，不能凭设备外观或购入年份直接判断。

安装后先确认客户端可以正常启动，再配置订阅和系统代理。遇到系统安全提示时，核对下载来源与系统给出的具体原因，按系统设置处理，不要直接关闭整体安全功能。完成连接后仍需在实际使用的应用中验证代理行为。

前往下载 macOS 客户端

Android

v2rayNG 使用 Xray 内核，是安卓端的首选入口；需要 V2Fly 内核配置时，可查看 v2flyNG。主流设备通常使用 arm64 架构，不确定时先查看设备信息，或阅读下载页的通用版说明。

首次连接需要确认系统 VPN 授权。这项授权用于接管本机网络流量，不代表服务器已经连接成功。连接建立后测试目标应用，并检查后台电池限制；若切到后台后连接中断，先排查系统对客户端的运行限制，再更换配置。

前往下载 Android 客户端

Linux

v2rayN 提供 deb 与 rpm 安装入口，并区分 x64 和 arm64。先按发行版选择包格式，再按处理器选择架构；包格式不是代理协议，也不会改变订阅中的服务器参数。

安装后使用图形客户端导入配置。不同桌面环境对系统代理的支持可能不同，部分应用需要单独填写本地 HTTP 或 SOCKS 入口。验证时区分浏览器、桌面应用与终端程序，某一个程序可以访问，并不能说明所有程序都读取了相同设置。

前往下载 Linux 客户端

客户端安装完成后仍需有效的服务器配置或订阅。安装包用于部署客户端，不包含可直接使用的连接参数。

查看全部客户端 →

快速上手

导入、选择入口、验证连接

先得到一组可复现的基础设置，再添加个性化规则。以下三步对应完整教程中的操作顺序，桌面与安卓的差异集中在本地流量入口。

  1. 步骤一

    确认配置来源并导入

    先判断拿到的是订阅地址，还是以 vmess://、vless:// 等协议开头的单条分享链接。订阅地址添加到「订阅分组设置」后执行更新；单条分享链接则使用客户端的剪贴板导入入口。不要把网页说明地址当成订阅，也不要把订阅地址直接填入服务器地址字段。

    导入后查看备注、协议、服务器地址和端口是否完整。订阅更新报错时，先确认地址未被截断、没有多余空格，并查看更新提示。能打开订阅所在的网页，不等于客户端已经解析到有效配置。首次排查应保留原有分组，不要反复删除重建，以免丢失对照信息。

  2. 步骤二

    选择活动配置与流量入口

    桌面端选择要使用的服务器配置，再启用「自动配置系统代理」；安卓端选择配置后点击连接按钮，并确认系统 VPN 授权。路由先使用明确的预定义模式，暂时不要叠加复杂自定义规则。系统代理、VPN 接管与内核路由是不同层次，名称相近也不能互相替代。

    需要访问局域网服务时，核对绕过规则与目标地址。需要限定安卓应用范围时，再设置「分应用代理」，并确认绕过模式是否启用。修改这些设置后重新连接，以实际应用请求作为验证依据。若设备同时运行其他代理或 VPN 工具，先退出其他实例再测试。

  3. 步骤三

    用实际请求与日志验证

    连接按钮显示已启动，只能说明客户端进入运行状态。接着打开实际需要使用的网页或应用，观察请求是否完成，并查看日志中的出站、解析或握手提示。内置测速用于辅助比较当前条件下的连接表现，不等同于持续下载速度，也不能替代目标应用的访问测试。

    遇到问题时按本地入口、DNS、服务器连接、目标服务的顺序检查。记录本次选择的模式与修改项，每次只调整一个变量。若浏览器正常而某个软件失败，优先检查软件自己的代理设置；若所有请求都失败，再检查配置参数、系统时间和服务器可达性，而不是直接堆加路由规则。

需要恢复设置时，先退出连接并恢复系统代理，再重新选择配置。保留可用的基础配置，有助于定位后续规则改动。

查看完整教程 →

开源生态

客户端、内核与配置的关系

V2Ray 是生态与技术背景，v2rayN、v2rayNG 和 v2flyNG 是具体客户端名称。分清界面与内核，才能判断一项设置在哪里生效。

Project V 到内核家族

Project V 围绕模块化网络代理展开，V2Ray 是其中广为使用的实现。V2Fly 延续 V2Ray 的社区维护，Xray 则从相关代码与技术生态发展出自己的实现和功能。它们共享一部分概念与配置习惯，但项目名称不能作为完全兼容的依据。某种协议能够使用，不代表全部传输选项、安全字段和路由资源都能直接互换。

图形客户端负责订阅管理、配置编辑、启动控制和系统集成，内核负责执行实际网络处理。看到一个菜单选项时，应同时确认客户端如何保存它，以及当前内核是否识别对应字段。手工修改运行时生成的文件，可能在下次保存设置时被覆盖；长期保留的调整应放回客户端支持的配置入口。

三款客户端的开源属性

v2rayN、v2rayNG 与 v2flyNG 都是开源客户端，分别围绕桌面和安卓场景组织图形操作。v2rayN 项目采用 GPL 系列许可，v2rayNG 同样采用 GPL 系列许可，v2flyNG 项目采用 GPLv3 许可；具体许可范围、第三方组件与分发条件应以对应项目的许可文本为准。V2Fly 与 Xray 内核采用 MPL 2.0 许可，客户端与内核不是同一个软件包，不能把其中一方的许可直接套到所有组件上。

开源意味着代码可以在许可条件下阅读、研究和参与维护，不等于任意来源的安装包都具有相同状态。选择客户端时，应结合设备平台、需要的协议与配置兼容性。桌面优先查看 v2rayN；安卓使用 Xray 配置时优先查看 v2rayNG，需要 V2Fly 对应行为时再评估 v2flyNG。客户端本身不决定服务器运营方式，也不替代对订阅来源的判断。

更新前先保留可复现状态

客户端界面、内核能力和规则资源可能分别更新。界面升级后仍需检查实际启用的内核，规则文件更新后也应确认自定义标签没有失去对应关系。更新前记下本地端口、系统代理模式、活动配置和自定义路由；有导出功能时，保存一份受控备份。更新后先测试原本可用的请求，再逐项恢复高级设置，避免把多个改动混成同一次故障。

订阅更新与软件更新也应分开理解。前者刷新服务器配置，可能改变地址、协议或连接参数；后者改变客户端与组件本身。订阅提供的单条配置一般不能表达设备上全部路由偏好，客户端的本地规则也不会自动传播到其他设备。维护多台设备时，记录哪些设置来自订阅、哪些属于本地，能减少跨端迁移时的误判。

JSON 参考与敏感信息边界

需要进一步配置时，从 inbounds、outbounds、routing 与 dns 四部分开始阅读。入站监听应限定在实际需要的范围，出站标签必须与路由引用一致，DNS 行为则要结合域名策略判断。示意中的 geosite:cn 规则依赖相应资源；若只复制规则而没有可用资源文件，配置可能无法按预期启动。

完整配置、分享链接和订阅地址都可能带有访问身份信息。求助时仅保留必要字段，隐藏身份参数和完整订阅路径，并说明客户端名称、使用内核、出错阶段及相关日志。日志里显示的目标域名也可能暴露使用记录，应按排查需要截取。按这些边界整理材料，比仅提供一张连接失败的截图更便于复现问题。

继续阅读 V2Ray 配置字段 →

配置阅读

分享链接、路由部署与速度排查

从导入方式延伸到网关部署和分层排查。以下为最近三篇文章，按问题范围选择阅读，不必一次修改所有设置。

正在排查系统代理或连接日志？资讯目录还收录模式选择与报错解读，按具体问题继续查阅。

查看全部文章 →
V2Ray客户端下载