客户端入口 · 配置字段参考

V2Ray发布页
v2rayN 客户端下载

下载v2rayN 查看教程

按设备选择开源客户端，从订阅导入到路由分流，对照设置项完成配置。

客户端与配置，分开理解

v2rayN 和 v2rayNG 提供图形操作入口；Xray、V2Fly 内核负责处理连接。先选适合设备的客户端，再核对订阅参数、代理模式与路由规则，能减少把界面设置和内核字段混为一谈的情况。

04 设备平台 03 图形客户端 Xray / V2Fly 内核家族 JSON 配置参考

v2rayN 常用设置项

从流量入口到路由出口，按实际操作顺序查看五类设置。下方片段用于解释字段，不是一份可以直接连接远端服务器的完整配置。

v2rayN · 系统代理设置

先让应用使用本地代理

系统代理决定遵循系统设置的应用是否把请求交给客户端。导入订阅并选中服务器后，在托盘菜单设置系统代理，再打开浏览器检查访问情况。它与路由模式不是同一个开关：前者决定流量是否进入本地监听，后者决定进入后如何分配出口。部分应用使用独立代理设置，需要单独填写监听地址和端口。排查时先确认内核已启动、端口一致，退出客户端前可清除系统代理，避免应用继续指向已经关闭的监听端口。

设置项核对
本地混合监听端口：10808
本机应用代理地址：127.0.0.1
系统代理：自动配置系统代理
退出客户端前：清除系统代理

注意：端口以实际参数设置为准。

设置的先后顺序

先把“应用是否交出流量”和“内核如何处理流量”分成两层。浏览器访问失败，不一定是服务器配置有误；浏览器没有遵循系统代理、监听端口被其他程序占用，或者客户端启动后内核立即退出，都可能得到相似现象。只改变一项设置，再观察同一目标的访问结果，通常比反复切换全部开关更容易定位原因。

日志也应按阶段阅读：启动阶段关注配置解析和端口监听，连接阶段关注域名解析、握手和超时。日志等级可在需要时临时调整，排查结束后恢复常用级别。分享日志前移除订阅地址、认证信息与服务器标识；需要理解完整结构时，转到配置字段，对照入站、出站与路由之间的引用关系阅读。

四平台客户端入口

桌面端优先查看 v2rayN，安卓端按内核选择 v2rayNG 或 v2flyNG。这里进入对应平台的安装包列表；具体发布信息与文件入口集中在安装包页。

Windows · v2rayN

适合通过托盘菜单管理系统代理、订阅分组和路由模式的桌面用户。安装包页区分采用跨平台界面的桌面版与经典 WPF 版，选择前先确认系统和处理器架构，不要只依据文件后缀判断。

首次配置先使用普通权限运行并导入订阅，确认本地监听正常后再设置系统代理。若准备启用需要额外权限的接管功能，应先理解权限提示的作用。已经安装其他网络工具时，先退出其代理接管，避免两个客户端反复改写系统设置。

前往下载

macOS · v2rayN

按芯片选择 Apple Silicon 或 Intel 安装包。在系统“关于本机”中查看芯片信息后再下载，能避免安装后因架构不匹配而无法启动。桌面端订阅与路由的基本概念一致，具体菜单位置以实际界面为准。

首次打开若出现开发者验证或网络权限提示，应在系统设置中阅读提示内容，按单个应用处理。不要为了运行客户端关闭整套系统保护。完成安装后检查系统代理是否已指向客户端监听地址；退出客户端后仍不能访问网络时，先检查残留的代理设置。

前往下载

Android · v2rayNG / v2flyNG

需要 Xray 配置能力时先看 v2rayNG；已有 V2Fly 配置需求时再考虑 v2flyNG。主流较新设备通常选择 arm64，不能确认架构时可查看通用包说明。两款客户端应分别管理配置，不能把名称相似当作参数完全兼容的依据。

导入订阅后还要选择服务器，并在首次连接时确认系统 VPN 授权。分应用代理名单会影响哪些应用被接管，测试时先使用明确纳入接管的应用。若切到后台后连接中断，再检查系统电池管理与后台运行限制，不必首先重装客户端。

前往下载

Linux · v2rayN

按发行版包管理体系选择 deb 或 rpm，再核对 x64 与 arm64 架构。图形客户端适合在桌面环境中维护订阅与查看日志，安装成功并不意味着所有应用都会自动使用本地代理。

不同桌面环境对系统代理的处理方式可能不同。浏览器、终端程序与后台服务也可能各自使用独立的代理设置，因此应逐类确认，而不是仅凭某个应用访问成功判断全部流量已接管。需要启用虚拟网络接口时，先检查权限、系统路由和现有网络管理工具之间的关系。

前往下载

查看全部客户端 →比较三款客户端的适用场景 →

订阅导入与连接三步

以 v2rayN 桌面端和 v2rayNG 安卓端为主线。把安装、配置和接管分步完成，发生异常时才能知道该回到哪一层检查。

  1. 安装客户端，导入订阅

    先按系统和架构选择安装包，打开客户端后找到订阅分组入口。为订阅添加便于区分的名称，填入可信来源提供的地址并保存，再执行该分组的更新。地址应完整保留，尤其不要漏掉末尾参数；从聊天软件复制时也要注意多余空格与换行。

    更新完成后检查列表是否出现服务器条目。只有分组名称而没有条目时，应查看更新提示，区分网络获取失败与内容解析失败。客户端本身不附带远端服务器，安装完成后仍需使用有权访问的配置。订阅地址包含敏感参数时，不要在截图中完整展示。

  2. 选择服务器，确认代理模式

    在服务器列表选择活动条目，核对协议与所用内核是否匹配。桌面端先设置系统代理，安卓端确认 VPN 模式及系统授权。首次使用尽量保留客户端预设路由，待基本连接建立后，再添加自定义域名规则或分应用名单。

    服务器列表中的测试结果只能说明某种测试方式下的连接表现，不能代表所有网站与应用。若某个条目无法使用，先查看连接日志，再检查服务器地址、端口、认证信息与设备时间。反复修改传输和安全层参数可能让原本有效的配置失去对应关系。

  3. 检查访问，保留排查基线

    使用实际需要的应用访问一个明确的目标，观察客户端日志是否出现对应连接。没有记录时先检查应用是否走代理；已有记录但连接失败时，再分析解析、握手或超时信息。一次只调整一个因素，并记录调整前后的结果。

    确认可用后，再按需求配置路由例外、后台运行和开机启动。电脑与手机可以使用同一订阅来源，但系统代理、VPN 授权和分应用名单仍需各自设置。退出桌面客户端前注意清除系统代理；遇到网络异常，先恢复普通网络，再逐项重新启用接管。

查看完整教程 →

Project V、V2Fly 与 Xray

区分项目生态、代理内核和图形客户端，有助于判断一份配置应该在哪里导入、由哪个组件执行。

Project V 生态
Xrayv2rayNG · 安卓客户端
V2Flyv2flyNG · 安卓客户端
v2rayN桌面图形入口 · 按配置选择内核

从 V2Ray 到不同内核家族

Project V 是理解 V2Ray 技术生态的起点，围绕模块化代理、入站、出站与路由形成了通用的配置思路。V2Fly 延续 V2Ray 核心的社区开发；Xray 从相关代码基础分支发展，围绕协议与传输能力形成自己的演进路线。两者有共同历史，但不能据此认为所有字段、默认行为和协议组合都能互换。阅读教程时应先确认文章讨论的是哪个内核。

客户端负责操作，内核负责连接

v2rayN 把订阅、服务器选择、日志和系统代理集中到桌面图形界面；v2rayNG 面向安卓设备，围绕 Xray 内核组织配置；v2flyNG 则为 V2Fly 内核提供安卓图形入口。这三款客户端属于开源项目，界面项目与内核项目的开发节奏并不完全相同。判断功能是否可用时，需要同时查看客户端是否能生成对应配置，以及实际启动的内核是否支持。

开源协议与使用边界

开源意味着源代码依照相应许可证开放，并规定使用、修改和分发的条件，并不等于所有组件采用同一种许可证。以 v2rayN 的 GPL-3.0、v2rayNG 的 GPL-3.0 与 V2Fly 核心的 MIT 许可为例，二次分发前需要分别阅读所涉组件的许可要求。普通使用者则应关注客户端的来源、配置的授权范围，以及是否理解自己开启的代理与网络接管功能。

发布更新与配置兼容

更新客户端可能涉及界面调整、配置生成方式变化或随附内核变化，更新内核也可能影响字段兼容性。安装包页集中展示当前发布入口，首页不固定某个发布编号。更新前保留订阅分组和必要设置，更新后先用原有模式测试，再尝试新增功能；出现异常时比较日志与配置差异，不要在缺少证据时把问题简单归因于某个内核家族。

V2Ray发布页提供客户端入口与中文配置参考，站名不代表上游项目身份。站内说明侧重操作顺序和字段含义，不提供服务器账户或订阅服务。涉及具体协议能力时，应结合正在使用的客户端、内核与服务器配置判断，相关定位与内容维护原则见关于本站。

客户端技术笔记

从配置结构、桌面界面到多设备同步，按实际使用场景补充阅读。文章中的菜单和字段应与正在使用的客户端界面对照。

查看全部文章 →