CLIENTS / CONFIGURATION

V2Ray安装包下载 配置与教程

下载v2rayN 查看教程

按系统选择 v2rayN 等开源客户端，从订阅导入到路由分流，逐项确认设置。

  • JSON 配置字段
  • Xray · V2Fly
  • 图形客户端教程

参数窗口为静态设置示意；监听端口与菜单名称请以实际客户端为准。

01 / DOWNLOAD

按系统选择安装包

桌面使用 v2rayN；安卓优先了解 v2rayNG，再按内核需求考虑 v2flyNG。

Windows

v2rayN 提供桌面版与经典 WPF 版。桌面版采用新一代跨平台界面；WPF 版保留经典操作布局。先按界面偏好选择，再阅读下载页的运行要求，不需要为了导入同一份订阅同时安装两版。

首次启动后，先确认程序能正常写入配置目录，再添加订阅分组。若从旧环境迁移，保存原有配置与自定义路由，避免把旧目录直接覆盖到新安装位置。遇到启动异常，应先区分运行环境问题和配置问题。

前往下载 Windows 安装包

macOS

v2rayN 按处理器提供 Apple Silicon 与 Intel 安装入口。先在系统的“关于本机”查看芯片信息：Apple Silicon 选择 arm64，Intel 选择 x64。架构选择与订阅协议无关，不能根据服务器使用的处理器判断。

安装后，先启动客户端并选定服务器，再配置系统代理。若浏览器已有代理扩展，应确认扩展是否覆盖系统设置。终端程序也可能使用独立的环境变量，因此浏览器能够访问目标，并不代表所有应用都采用了同一条连接路径。

前往下载 macOS 安装包

Android

v2rayNG 使用 Xray 内核，v2flyNG 使用 V2Fly 内核。多数较新的安卓设备可先查看 arm64 安装包；架构不明确时，再了解通用版。两款应用的选择依据是配置兼容性与内核需求，不是文件名称是否相似。

首次连接需要授予系统 VPN 连接权限，这是客户端接管应用流量的入口。若锁屏后连接中断，再检查电池优化与后台运行限制。分应用代理用于限定哪些应用进入代理路径，规则方向应先确认，避免把“绕行”和“仅代理”理解相反。

前往下载 Android 安装包

Linux

v2rayN 提供 deb 与 rpm 安装入口，按发行版的软件包体系选择；处理器架构另分 x64 与 arm64。包格式回答“由哪个包管理器安装”，架构回答“在哪类处理器上运行”，这两个条件需要分别确认。

安装完成后，在桌面会话中启动图形客户端，先检查本地监听是否正常。不同桌面环境对系统代理的使用方式可能不同，部分应用需要手动填写代理地址与端口。不要把“安装成功”当作“所有应用已经接入代理”的判断依据。

前往下载 Linux 安装包

安装包只提供客户端程序。订阅地址、服务器连接参数与访问权限由配置来源提供；安装后仍需导入有效配置。下载页集中说明架构与包格式，客户端对比页则解释三款应用各自适合的操作环境。

查看全部客户端 →
02 / CONFIG OBJECTS

配置对象索引

先找到客户端设置项，再理解它影响的配置层级。

订阅分组：区分来源与更新范围

订阅分组是客户端管理层的对象，不是内核 JSON 的通用顶层字段。为不同来源设置独立备注，填入订阅地址后执行更新，再检查是否生成服务器条目。更新失败时，先区分地址不可达、返回内容无法解析和当前网络路径异常，不要立即删除已有配置。分组管理比逐条手工维护更适合持续更新的来源，但本地修改是否保留取决于客户端行为，重要参数应另行保存。

订阅分组
├─ 备注
├─ 订阅地址
└─ 更新订阅

客户端界面与内核配置之间并非逐字对应。订阅分组、窗口偏好等设置由客户端保存；入站、出站、路由与 DNS 才属于常见内核配置对象。手动编辑前，先确认正在修改的是客户端配置还是生成的运行配置，后者可能在下次启动时重新生成。

查看 JSON 结构与配置字段 →
03 / QUICK START

v2rayN 配置三步预览

按“配置来源 → 流量入口 → 连接结果”的顺序操作。

  1. 步骤 01

    导入订阅与选择服务器

    打开订阅分组设置，为来源填写容易识别的备注，再粘贴完整订阅地址。保存后执行更新，确认列表出现可用配置，并选择需要使用的服务器。若持有的是单条分享链接，应使用客户端的导入功能，不要把它误填为订阅地址。

    导入成功只表示内容能够解析，不代表服务器一定可连接。此时先检查地址、端口、协议、传输与安全参数是否来自同一份配置。订阅地址可能包含访问凭据，不应出现在公开截图或求助文本中；分享日志前也应移除敏感字段。

  2. 步骤 02

    确认代理入口与路由模式

    启动连接后，确认客户端没有报告监听端口被占用，再按需要启用系统代理。浏览器通常可以读取系统设置，但终端和部分桌面应用需要独立配置。手动填写代理时，地址、端口和协议必须与客户端实际监听项一致。

    随后选择适合当前需求的路由模式。路由控制请求进入内核之后的去向，系统代理控制应用是否把请求交给内核，两者不是同一个开关。初次使用可先保留客户端提供的基础规则，确认连接正常后，再逐项增加自己的域名或地址条件。

  3. 步骤 03

    验证应用与读取日志

    用需要代理的实际应用访问目标，观察客户端是否出现对应连接记录。若只有某个应用失败，应检查它自己的代理路径；若所有应用都失败，再查看内核运行状态、服务器参数与网络连通性。每次只修改一个条件，才能判断变化来自哪里。

    日志中的连接被拒、超时与握手失败对应不同阶段，不能都归结为订阅失效。临时提高日志等级有助于定位，问题解决后应恢复常用等级。安卓端还需确认 VPN 连接授权与分应用范围，后台中断则继续检查电池优化，而不是反复重新导入订阅。

迁移设备或更换客户端时，先保存当前可用配置的来源与自定义规则。不要一次性启用系统代理、复杂分流和局域网共享；先建立最小可用路径，再逐项扩展。这样既能减少设置之间的干扰，也能保留清晰的排障起点。

查看完整教程 →
04 / OPEN SOURCE ECOSYSTEM

Project V、内核与客户端

分清生态、运行内核与图形界面，才能判断配置适用于哪一层。

生态背景

Project V 与 V2Ray 的关系

Project V 是围绕网络代理工具与相关能力形成的开源项目体系，V2Ray 是其中广为使用的核心项目。日常搜索中的“V2Ray 客户端”往往指图形管理程序，而技术文档中的 V2Ray 也可能特指运行内核。两种用法处于不同层级，阅读教程时应先明确语境。

内核通常通过配置文件描述入口、出口与匹配规则；图形客户端把这些对象转换成可以操作的表单、列表与菜单。因此，界面上能找到某个按钮，并不意味着所有内核都接受同一份 JSON。理解这一点，比记住某个菜单的位置更适合长期维护配置。

内核家族

V2Fly 与 Xray 的兼容边界

V2Fly 延续 V2Ray 的社区开发，Xray 从相关生态分出并发展了自己的能力。两者共享部分概念，但协议实现、传输选项与配置细节存在差异。涉及 REALITY、XTLS Vision 等能力时，应核对 Xray 的支持情况，而不是只看客户端名称里是否包含 V2Ray。

“支持某个协议”也不代表支持该协议的全部组合。传输方式、安全层、流控选项和内核功能共同决定可用性。更换内核后出现错误时，先查看解析阶段的提示，再检查运行时连接，不要把配置不兼容误判成服务器不可达。

开源与许可

三款图形客户端的职责

v2rayN、v2rayNG、v2flyNG 都是开源图形客户端，分别承担桌面与安卓环境中的配置管理。v2rayN 提供桌面多平台界面，v2rayNG 对接 Xray，v2flyNG 对接 V2Fly。选择时先看系统，再看配置要求，不必为了名称相近而重复安装。

开源表示代码依据相应许可证公开，复制、修改与再分发仍需遵守各项目及依赖组件的许可条款。客户端与内核的许可证未必相同，不能用一个笼统标签替代全部许可说明。客户端程序可以免费使用，服务器资源与订阅服务则属于另一层面的提供关系。

更新与维护

界面、内核和规则分别更新

一次客户端更新可能涉及界面、配置生成逻辑或附带内核；订阅更新主要刷新服务器配置；规则数据更新则影响域名与地址集合。三种更新作用不同，不能用“已经更新订阅”来推断程序和内核也已更新。排障前记录实际环境，有助于找到对应的字段说明。

更新前保存自定义路由、DNS 设置与订阅分组信息。更新后先验证既有连接，再检查自定义规则是否仍然生效。若参数名称或默认值发生变化，应以当前界面与对应内核文档为准。本页提供对象层面的阅读入口，下载页集中放置安装选择，配置字段页解释各段 JSON 的用途。

阅读路径可以按问题选择：需要选应用时看客户端对比，需要完成首次连接时看教程，需要解释某个字段时看配置参考。遇到订阅更新失败或系统代理不生效，先确定失败发生在哪个阶段，再进入对应的排障说明，避免把不同层级的问题混在一起。

关于站点与内容范围 →常见问题与连接排障 →
05 / READING

配置与排障文章

从内核差异、协议选择到安卓运行机制，补充设置项背后的判断依据。

查看全部文章 →