PROJECT V CLIENTS · CONFIGURATION

V2Ray官网下载
v2rayN 客户端与配置指南

下载v2rayN 查看教程

面向桌面与 Android 设备的客户端资料入口，集中整理 安装包选择、订阅导入 与 路由分流。内容覆盖 v2rayN、v2rayNG、v2flyNG，以及 Xray、V2Fly 内核相关配置概念。

永久免费 代码开源 四平台入口 中文配置文档
PLATFORMS Windows · macOS · Android · Linux CORES Xray · V2Fly PROTOCOLS VMess · VLESS · Trojan · SOCKS LICENSE Open Source

PLATFORM ENTRY

V2Ray 客户端平台入口

首页仅负责按操作系统分流。进入安装包页面后，再根据处理器架构、软件包格式和客户端内核选择具体文件。桌面设备以 v2rayN 为主，Android 设备可在 v2rayNG 与 v2flyNG 之间选择。

Windows

使用 v2rayN 桌面客户端。安装包页面同时说明新一代桌面界面与经典 WPF 版本的差别，并列出运行环境、解压安装、系统代理开启和端口冲突处理方法。

前往下载

macOS

使用 v2rayN 跨平台桌面客户端。下载前需要确认设备采用 Apple Silicon 还是 Intel 处理器；进入对应标签后可查看架构辨别、首次启动与系统代理设置说明。

前往下载

Android

优先查看使用 Xray 内核的 v2rayNG；需要 V2Fly 内核时可选择 v2flyNG。安装包页按 arm64 与通用架构区分，并说明订阅导入、VPN 权限和后台运行设置。

前往下载

Linux

使用 v2rayN 桌面客户端。安装入口按 deb、rpm 与处理器架构划分，适合常见桌面发行版；安装后仍需根据桌面环境配置系统代理或使用客户端提供的 TUN 功能。

前往下载
查看全部客户端 →

CLIENT CAPABILITIES

v2rayN 配置核心环节

客户端只是配置与内核之间的图形界面。实际使用效果由节点参数、协议字段、路由顺序、DNS 路径和系统接管方式共同决定。下面按四个高频环节拆开说明。

ROUTING

V2Ray 路由分流

路由规则负责决定流量进入代理出口、直连出口还是阻断出口。常见条件包括域名、目标 IP、端口、入站标签与协议类型。v2rayN 可以调用预设规则，也可以载入自定义 JSON。配置时应先建立少量可解释的规则，再逐步增加 geosite 与 geoip 条目；规则越多并不等于匹配越准确。排查异常时要关注从上到下的命中顺序、最终兜底出口和域名解析结果，避免同一目标同时落入相互冲突的条件。

与简单的全局代理相比，路由分流保留了对不同业务流量的控制能力。国内服务直连、特定域名代理、局域网地址绕过和广告域名阻断可以分别处理，也便于从日志中确认具体规则是否生效。

routing.json 
{
  "type": "field",
  "domain": ["geosite:cn"],
  "outboundTag": "direct"
}
查看完整配置教程 →

OPEN SOURCE ECOSYSTEM

Project V、V2Fly 与 Xray 内核关系

V2Ray 不是单一图形客户端的名称。它更常用于指代 Project V 形成的协议、内核与客户端生态。理解内核和界面的分工，有助于判断配置问题发生在哪一层。

从 Project V 到内核家族

Project V 早期建立了 V2Ray Core 及其配置体系，VMess、入站、出站、路由和传输层等概念由此形成。后来社区维护方向出现分支，V2Fly 延续并维护 v2fly-core，Xray 则在兼容既有配置思想的基础上发展 xray-core。两者都属于当前常见的内核实现，但支持的协议扩展、配置字段和发布节奏并不完全相同。

图形客户端通常不直接承担协议处理。v2rayN、v2rayNG 与 v2flyNG 负责订阅管理、节点编辑、参数生成、内核启动、系统代理切换和日志展示，真正的数据连接由其调用的内核执行。因此，同一个节点在不同客户端中的表现可能受内核类型、内核配置模板和客户端版本适配影响。排查时应记录客户端名称、所用内核、协议字段和错误日志，而不是只描述为“V2Ray 无法连接”。

开源许可允许开发者审阅代码、研究配置实现并构建衍生工具，但每个项目的许可文本、依赖项和发布方式需要分别查看。站内文档以公开配置模型和客户端实际界面为基础，重点说明安装、参数含义与排查顺序，不把不同项目混成同一个软件包。

V2FLY

v2fly-core

V2Fly 社区维护的内核延续 Project V 配置体系，覆盖入站、出站、路由、DNS 与多种传输方式。v2flyNG 以该内核作为 Android 端的一个图形入口，适合需要保持 V2Fly 内核路径的配置。

XRAY

xray-core

Xray 内核与既有 V2Ray 配置概念保持较高关联，同时发展了 VLESS、REALITY 等能力。v2rayN 与 v2rayNG 常在其客户端生态中调用 Xray，具体支持范围仍取决于客户端与内核的组合。

CLIENTS

三款图形客户端

v2rayN 面向 Windows、macOS 与 Linux 桌面系统；v2rayNG 面向 Android 并以 Xray 内核为主；v2flyNG 同样面向 Android，但采用 V2Fly 内核。三者定位不同，不应仅按名称相似程度选择。

更新机制

客户端、内核、GeoIP 与 GeoSite 数据并非同一组件。客户端更新通常涉及界面和配置生成逻辑；内核更新影响协议处理与运行行为；地理数据更新影响路由规则匹配。出现分流失准时，先检查数据文件；出现协议字段不识别时，再核对内核与客户端的适配关系。

配置兼容

分享链接和订阅格式只是配置交换方式，并不能保证所有客户端都支持其中的每个字段。导入成功只表示客户端识别了基础结构，仍需查看传输、安全层、SNI、指纹和路由设置是否完整。跨内核迁移时，应逐项对照字段而不是直接覆盖原配置。

日志定位

有效日志应包含发生时间、连接阶段与错误类型。DNS 解析失败、TCP 连接超时、TLS 握手失败、认证字段错误和路由未命中分别指向不同层级。先确定错误发生在哪一层，再修改对应配置，可以避免同时改动多个变量造成新的干扰。

QUICK DIAGNOSIS

V2Ray 常见问题精选

下列问题覆盖首次安装后最容易混淆的四个环节。需要系统排查时，继续查看教程、概念速查和疑难手册。

v2rayN 导入订阅后为什么没有节点？

先确认使用的是“更新订阅”而不是只新增订阅分组，并检查地址复制时是否缺少开头或结尾字符。随后确认系统时间、当前网络连接和客户端日志。若请求成功但解析结果为空，可能是返回格式与客户端支持范围不一致。不要反复删除全部配置，应保留原订阅项并逐项验证。

查看订阅导入步骤 →
系统代理已经开启，部分程序仍然直连怎么办？

系统代理只对读取该设置的应用生效。先检查目标程序是否有独立代理选项，再确认其是否使用自己的网络栈。需要接管更广流量时可评估 TUN 模式，但应先确保节点在普通代理模式下工作正常，并避免多个网络工具同时修改路由表。

查看系统代理与 TUN 概念 →
节点能够连接，但网页打开缓慢应检查什么？

先区分 DNS 解析慢、连接建立慢和内容传输慢。可以更换目标网站交叉测试，并观察日志中是否反复解析或重连。随后检查路由规则、DNS 查询路径、传输方式和本地网络。不要只依赖单次测速结果，因为不同目标、时间和线路会产生明显差异。

进入速度问题排查章节 →
VMess、VLESS 与 Trojan 应该怎样选择？

协议必须与服务端配置一致，不能在客户端中任意互换。选择时应核对服务端给出的协议、端口、用户标识、安全层和传输参数。若获得的是完整订阅，通常直接导入比手动改写更可靠；若需要手工配置，则应逐字段对照原始资料。

查看协议概念速查 →

FIELD NOTES

V2Ray 配置与使用心得

围绕路由规则、地理数据与 Windows 安装流程整理的长文。文章中的配置片段用于解释字段关系，实际参数仍应以当前客户端界面和服务端配置为准。

路由分流

V2Ray 路由规则配置实战：国内直连与国外代理的分流写法

以 v2rayN 路由设置为例，解释 domain、ip、geosite 规则的匹配顺序，整理直连、代理与广告阻断的常用组合，并说明规则冲突时应怎样从日志和出口标签定位。

阅读全文 →
路由分流

GeoIP 与 GeoSite 数据库怎么更新：文件位置、加载机制与规则引用

解释 geoip.dat 与 geosite.dat 的职责、常见存放位置和加载关系，说明 v2rayN、v2rayNG 更新地理数据后的验证方法，以及数据过期导致路由命中偏差的典型现象。

阅读全文 →
Windows 指南

v2rayN Windows 安装配置全流程：桌面版与 WPF 版选择及常见坑

从安装包类型开始，覆盖运行环境、解压启动、订阅导入、系统代理和连通验证，并整理安全软件拦截、端口占用、权限不足与配置目录迁移等高频问题。

阅读全文 →
查看全部文章 →