图形客户端与配置文档

V2Fly官网
v2rayN 客户端

集中整理 四平台客户端入口订阅导入步骤路由分流配置,菜单路径、模式差异和排查顺序均按实际操作展开。

永久免费 代码开源 中文文档 Xray · V2Fly
桌面客户端

v2rayN

Windows、macOS 与 Linux 图形界面

内核家族

Xray

与 V2Fly 生态并行演进

维护方式

开源

配置行为与发布记录可公开审阅

平台 Windows · macOS · Android · Linux 客户端 v2rayN · v2rayNG · v2flyNG 内核 Xray · V2Fly 属性 免费 · 开源 · 社区维护
平台下载入口

按系统选择 V2Ray 客户端

桌面系统使用 v2rayN,Android 可在 v2rayNG 与 v2flyNG 之间选择。下列入口会打开下载页对应的平台面板,安装包类型、架构选择和系统要求都在面板内说明。

桌面系统

Windows · v2rayN

提供新一代桌面界面与经典 WPF 界面。首次使用可优先选择桌面版;已有固定操作习惯或需要经典菜单结构时,可在下载页查看 WPF 版说明。

前往下载
桌面系统

macOS · v2rayN

按照设备处理器选择 Apple Silicon 或 Intel 安装包。进入系统的“关于本机”即可查看芯片类型,安装后的订阅与路由菜单和其他桌面版本保持相近。

前往下载
移动系统

Android · v2rayNG / v2flyNG

v2rayNG 使用 Xray 内核,适合作为常用入口;v2flyNG 使用 V2Fly 内核,可按服务端配置与使用偏好选择。主流设备通常选择 arm64,无法确认时可查看通用版。

前往下载
桌面系统

Linux · v2rayN

Debian、Ubuntu 等系统选择 deb,Fedora、Rocky Linux 等系统选择 rpm。下载页同时区分 x64 与 arm64 架构,并列出安装前需要确认的桌面环境条件。

前往下载
配置能力

从订阅到路由的完整操作链

客户端的关键价值不只在于导入一个连接。订阅如何更新、系统代理接管哪些程序、路由规则按什么顺序匹配、TUN 模式何时需要启用,都会直接影响实际使用结果。本区按照真实设置项拆分六类能力,先给出操作入口,再解释适用边界和检查方法。

{
  "routing": {
    "domainStrategy": "IPIfNonMatch",
    "rules": [
      {
        "type": "field",
        "ip": ["geoip:private"],
        "outboundTag": "direct"
      }
    ]
  }
}
订阅管理

把地址、分组和更新状态分开检查

在 v2rayN 中可通过“订阅分组 → 订阅分组设置”保存订阅地址,再执行“更新全部订阅”获取服务器列表。分组名称用于整理不同来源,不会改变节点参数。若更新后列表为空,应依次确认地址是否完整、返回内容能否被客户端解析、当前网络是否允许请求以及客户端日志是否出现格式提示。相比逐条粘贴分享链接,订阅更适合持续维护一组会发生变化的配置。

快速上手

安装、导入、启用三步路径

先建立一条可以复现的基础连接,再逐步加入自动更新、路由与 TUN。初次配置时一次只改变一个选项,出现问题时更容易判断发生在哪个环节。

  1. 01

    选择系统与客户端

    桌面系统进入 v2rayN 对应平台面板,Android 根据内核需求选择 v2rayNG 或 v2flyNG。安装前确认处理器架构与安装包类型,避免把架构不匹配误认为程序无法启动。首次打开后先保持默认路由和默认端口,不急于调整高级参数。

  2. 02

    导入订阅并更新列表

    在客户端的订阅分组设置中新增地址,保存后执行更新。服务器列表出现后,选择一条配置并设为活动服务器。若列表为空,先查看订阅更新日志;若节点存在但不能启动,再查看内核日志,不要把两类问题混在同一轮排查中。

  3. 03

    启动内核并选择接管方式

    确认活动服务器后启动内核,再根据应用类型选择系统代理。常规浏览器通常先测试系统代理;不读取系统代理的程序再评估 TUN。基础连接稳定后,最后加入绕过局域网、域名匹配和指定出口等路由规则。

开源生态

Project V、V2Fly 与 Xray 的关系

客户端、内核、协议配置与订阅服务分别承担不同职责。理解这些边界,有助于判断问题属于界面操作、配置内容、内核兼容还是远端服务。

从 Project V 到并行维护的内核家族

Project V 奠定了 V2Ray 配置体系的基本结构:入站负责接收本机流量,出站负责定义转发目标,routing 在两者之间执行匹配,dns 与 log 则提供域名解析和运行记录。V2Fly 社区继续维护 V2Ray Core 及相关规范,Xray 在同一技术脉络上发展出独立内核。两者共享不少配置概念,但具体字段、协议扩展和发布节奏可能存在差异。

因此,“客户端支持某种分享链接”和“当前内核能够完整处理对应参数”是两个不同判断。图形客户端可以解析订阅、生成配置并管理进程,真正执行协议握手、路由和转发的是内核。服务端参数发生变化时,应同时核对客户端解析能力与内核支持范围,而不是只检查界面中是否出现服务器名称。

开源协议与公开协作方式

v2rayN、v2rayNG、v2flyNG 以及相关内核均采用开源方式维护。源代码、配置格式和变更记录由各项目公开管理,功能讨论、问题修复与兼容调整由维护者和社区参与者持续推进。开源属性便于开发者理解配置如何生成,也让高级用户可以根据日志和字段定义定位行为差异。

不同组件可能采用不同的开源许可证,许可证约束的是代码复制、修改和再发布方式,不代表所有客户端由同一团队维护。使用文档时应明确对象:v2rayN 的菜单路径不能直接套用于移动端客户端,Xray 的扩展字段也不应假定在每个 V2Fly 配置中都能使用。按组件查阅对应说明,能减少概念混用。

更新机制与兼容判断

客户端更新通常包含界面调整、订阅解析变化、配置生成修正和内核管理能力;内核更新则更集中于协议实现、传输行为、路由与 DNS。发生“更新前可用、更新后异常”时,应先记录改变的是客户端、内核还是订阅内容,再逐层回看日志。若同时替换多个组件,很难判断真正影响结果的变量。

日常维护可采用固定顺序:先更新订阅并观察节点列表,再启动当前已知配置,最后才调整代理模式和路由。对于长期使用的规则,应保留规则目的、匹配条件和出口标签说明。这样即使界面菜单调整,也能从配置语义恢复原来的行为,而不是依赖某个按钮位置。

桌面首选

v2rayN

面向 Windows、macOS 与 Linux 的图形客户端,集中管理订阅分组、服务器列表、系统代理、路由规则、TUN 与内核日志。适合需要在桌面端维护多组配置并观察运行状态的用户。

Android

v2rayNG

以 Xray 内核为主要实现的移动端客户端,支持扫码、剪贴板与订阅方式导入配置。常用操作围绕配置列表、活动节点、路由设置和连接日志展开。

V2Fly 内核

v2flyNG

采用 V2Fly 内核路线的移动端选择,界面操作与常见订阅流程保持清晰分层。适合明确需要 V2Fly 内核兼容范围或希望对照两类内核行为的使用场景。

常见问题精选

先区分订阅、内核与代理模式

多数配置问题可以先按发生阶段分类。列表没有内容,重点看订阅请求与解析;程序不能启动,重点看内核日志;只有部分应用不生效,重点看流量接管方式。

订阅更新后服务器列表为空

先确认保存的是完整订阅地址,再查看更新日志中的网络请求和解析提示。能够打开地址不等于返回内容符合客户端支持的订阅格式;若近期更换了订阅来源,还应检查分组中是否保留了旧地址。

查看订阅导入步骤 →

启动后浏览器仍使用原连接

检查活动服务器是否已选中、内核是否正在运行,以及托盘菜单中的系统代理状态。部分程序有独立代理设置或不会读取系统设置,需要单独配置,或在确认权限与冲突后使用 TUN。

查看连接与验证步骤 →

内核启动后立即退出

从日志中找到第一条明确错误,常见线索包括端口被占用、出站标签不存在、配置字段类型不正确或传输参数缺失。修正一项后重新启动,不要同时改端口、路由和内核。

查看完整排查路径 →

全局代理与路由分流怎么选

全局代理适合短时间验证节点与内核能否正常工作;确认基础连接后,再切换到路由分流并逐条加入规则。先验证默认出口,再增加局域网、域名和 IP 规则,可以更快发现匹配顺序问题。

查看路由分流章节 →
配置资讯

最新 v2rayN 使用与排查文章

围绕主界面分区、日志定位和 JSON 配置结构整理具体操作。文章按单一问题展开,便于在完成基础教程后继续查阅。

入门指南

v2rayN 主界面功能分区详解:服务器列表、订阅分组、日志窗口与设置入口

按主窗口从上到下说明服务器列表列头、订阅分组标签、底部日志窗口与常用设置入口,建立清晰的操作地图。

阅读全文
故障排查

v2rayN 内核启动失败怎么办:从日志窗口定位配置错误的排查路径

梳理端口占用、配置字段缺失、传输参数不匹配与内核文件异常等典型线索,并给出逐项修正顺序。

阅读全文
进阶配置

V2Ray 配置文件结构逐段解读:inbounds、outbounds 与 routing 的职责划分

以精简 JSON 配置说明入站、出站与路由之间的关系,并解释 log 和 dns 在整体配置中的位置。

阅读全文