CLIENT CONFIGURATION INDEX

V2Ray配置指南：客户端选择与订阅配置

下载v2rayN 查看教程

围绕 客户端下载、订阅导入 与 路由分流 整理操作顺序，说明 v2rayN、v2rayNG、v2flyNG 的平台范围、内核差异、系统代理设置和常见连接问题。

  • v2rayN 桌面端
  • v2rayNG Android
  • v2flyNG Android
平台范围 WINDOWS · MACOS · ANDROID · LINUX
内核家族 XRAY · V2FLY
客户端 V2RAYN · V2RAYNG · V2FLYNG
维护方式 OPEN SOURCE

PLATFORM DOWNLOAD

按操作系统进入下载页

先确认设备平台与处理器架构，再选择对应客户端。首页入口只负责平台分流，具体安装包类型、系统要求与文件说明集中在下载页核对。

DESKTOP

Windows

Windows 桌面环境优先查看 v2rayN。下载页分别说明新一代桌面界面与经典 WPF 界面的适用范围，已有配置可以先备份订阅分组和路由设置，再决定安装方式。

前往下载

DESKTOP

macOS

macOS 使用 v2rayN 桌面客户端。下载前应在系统信息中确认处理器类型，Apple Silicon 与 Intel 对应不同文件；导入订阅后的代理模式、路由规则和桌面端操作逻辑与其他平台基本一致。

前往下载

MOBILE

Android

Android 可在 v2rayNG 与 v2flyNG 之间选择。前者采用 Xray 内核，适合常见 Xray 配置；后者采用 v2fly 内核，可作为 V2Fly 生态配置的对应客户端。下载时还需区分 arm64 与通用构建。

前往下载

DESKTOP

Linux

Linux 桌面端使用 v2rayN，可按发行版选择 deb 或 rpm，同时核对 x64 与 arm64 架构。安装完成后应分别检查客户端进程、系统代理状态和桌面环境的网络设置，避免只启动内核而未接管应用流量。

前往下载

查看全部客户端 →

CLIENT WORKSTATION

三个客户端的设置工位

客户端名称相近，但平台、内核家族和设置入口并不完全相同。先按设备选客户端，再按订阅、节点、代理模式、路由规则的顺序配置。

桌面端优先

v2rayN：桌面订阅与系统代理

v2rayN 覆盖 Windows、macOS 与 Linux，适合需要集中管理多个订阅分组、手动节点和路由规则的桌面环境。常用流程是建立订阅分组、更新服务器列表、执行真连接测试、选择活动节点，再启用合适的系统代理模式。客户端可调用 Xray 或 V2Fly 相关内核能力，具体协议可用性取决于当前内核与配置内容。排查时应把客户端日志、系统代理和浏览器连接分开验证，不要只根据节点列表中的单一状态判断。

设置项清单

  • 系统代理模式
  • 订阅分组与更新
  • 真连接测试
  • 路由规则集
  • 核心类型与日志
内核家族：Xray / V2Fly 开源桌面客户端 覆盖平台：3

QUICK START

订阅导入到连接验证

首次配置不要同时修改大量高级选项。先建立一条可复现的基础连接，再逐步加入路由、DNS 与分应用规则，出现问题时才能明确定位变化来源。

  1. 01

    导入订阅并确认分组

    复制完整的 V2Ray 订阅链接，在客户端的订阅分组或订阅设置中新增地址，然后执行更新。更新完成后不要立即连接，先检查服务器列表是否确实出现配置，并确认这些配置位于刚创建的分组。若列表为空，应依次检查地址是否复制完整、网络是否能访问订阅源、客户端日志是否返回格式解析错误。二维码与单节点链接适合临时导入，长期维护多个节点时，使用订阅分组更容易统一更新和区分来源。

  2. 02

    选择节点与代理模式

    从当前分组中选择一个节点作为活动配置，可先执行真连接测试，确认完整握手链路能够建立。桌面端随后设置系统代理模式，Android 端则启动系统连接。首次验证建议先使用客户端提供的基础代理模式，暂缓叠加复杂分流。全局代理意味着更多流量进入代理出站，规则模式则依据域名、IP、端口和进程等条件决定直连或代理。两者只是流量选择策略，不会修复订阅参数错误或节点本身不可达的问题。

  3. 03

    验证浏览器、日志与路由结果

    启动连接后，先用浏览器访问一个明确可用的页面，再观察客户端日志是否记录对应请求。桌面端还应确认操作系统的代理设置已经写入，关闭客户端后是否按预期恢复。若只有部分网站失败，应查看域名解析和路由匹配；若全部连接超时，则优先检查节点地址、端口、协议参数和本地网络。完成基础验证后，再加入 geosite、geoip、广告拦截或分应用规则，每次只改变一组设置并保留前后日志。

查看完整教程 →

OPEN SOURCE ECOSYSTEM

Project V、V2Fly 与 Xray 的关系

客户端负责界面、订阅和系统集成，内核负责协议、传输、路由与出站处理。区分这两层，是理解客户端差异和排查配置问题的基础。

从 Project V 到内核家族

Project V 是 V2Ray 相关技术与工具形成的早期开源生态，核心配置模型围绕入站、出站、路由、DNS、传输与策略组织。随着社区演进，V2Fly 延续并维护 v2ray-core 路线，Xray 则在相近配置思想上发展出另一条内核路线。两者存在大量相通概念，但协议支持、字段细节、传输能力和默认行为可能不同。因此，看到“V2Ray 配置”时不能只看名称，还需要确认客户端实际调用的内核以及订阅生成的配置目标。

图形客户端并不等于内核。v2rayN 主要解决桌面端的订阅管理、节点选择、系统代理、路由编辑、日志查看和内核调用；v2rayNG 与 v2flyNG 则把相似能力放入 Android 的系统连接流程。连接失败时，界面层可能正常显示节点，但内核仍可能因字段不兼容、证书名称不匹配、传输参数缺失或路由标签错误而停止处理。日志中的具体阶段比单一的“已启动”状态更有判断价值。

开源许可规定了代码使用、修改和再分发的边界，不同项目应以各自发布内容中的许可文本为准。对普通使用者而言，开源维护的直接意义是配置格式、问题讨论和变更记录可以被持续审阅。选择客户端时仍应根据平台、内核需求和配置来源判断，而不是把所有采用相似协议名称的客户端视为完全等价。

更新机制也应分层理解：客户端更新负责界面功能、平台适配和订阅管理逻辑，内核更新负责协议实现、路由能力和底层网络处理，规则数据更新则影响域名与 IP 分类。三者不一定同步发布。遇到旧配置在更新后行为变化时，应记录客户端设置、内核类型、规则来源与错误日志，再逐项比较；直接清空全部配置会丢失最有价值的排查上下文。

v2rayN

开源桌面客户端，负责多个桌面系统上的订阅分组、节点管理、代理模式和路由配置。使用时需同时确认界面版本、所选核心类型与系统代理状态。

v2rayNG

开源 Android 客户端，采用 Xray 内核路线。适合需要分应用代理、移动网络切换、二维码导入和常见 Xray 协议配置的设备。

v2flyNG

开源 Android 客户端，采用 v2fly 内核路线。适合需要匹配 V2Fly 配置行为，或希望在移动端保留该内核体系的使用场景。

CHECKLIST

常见问题精选

以下问题按配置链路排序。先检查本地代理接管，再检查节点握手，最后处理路由和 DNS，通常比反复切换节点更容易定位原因。

订阅更新后没有新节点

先确认更新的是当前使用的订阅分组，再检查订阅地址是否完整、更新日志是否返回解析错误。多个分组名称相近时，节点可能已进入另一个分组。

查看订阅问题 →

客户端显示运行但浏览器无法连接

桌面端检查系统代理是否写入以及浏览器是否采用系统设置；Android 检查系统连接是否建立。随后再看节点握手与域名解析日志。

进入故障排查 →

全局代理与规则模式怎么选

全局模式将更多流量交给代理出站，规则模式按匹配条件选择直连、代理或拦截。首次连接可先验证基础链路，再逐步配置分流规则。

查看路由术语 →

延迟低但实际速度仍然慢

ping、真连接延迟与下载测速测量的对象不同。完整速度还受到握手、线路拥塞、服务器负载、传输方式和目标站点响应影响。

了解测速差异 →

LATEST NOTES

配置与排查文章

从路由规则、首次连接和客户端界面三个入口补充操作细节。文章中的步骤与术语页、故障排查页相互对应，便于按问题继续查阅。

进阶技巧

V2Ray 路由规则配置实战：用 geosite 与 geoip 做境内外分流

以域名与 IP 规则演示直连、代理和拦截的匹配顺序，说明出站标签如何与规则对应，并给出验证分流结果的方法。

阅读全文 →
入门指南

V2Ray 首次连接教程：选节点、跑真连接测速、三步验证代理已生效

从导入后的节点列表出发，依次完成真连接测试、活动节点选择、代理启动和浏览器验证，并整理首连失败的检查顺序。

阅读全文 →
入门指南

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

逐块说明服务器列表字段、订阅分组组织方式、日志查看位置和核心设置入口，建立桌面客户端的基础界面地图。

阅读全文 →

查看全部文章 →