开源客户端 · 中文配置说明

V2Ray官网客户端下载与配置

下载v2rayN 查看教程

桌面使用 v2rayN，安卓使用 v2rayNG。按步骤完成订阅、路由与 DNS 设置，再检查应用是否经过代理。

  • Xray 内核
  • V2Fly 内核
  • VLESS · VMess · Trojan

按设备选择客户端

项目背景 Project V代理内核与图形客户端分工 协议术语 VLESS · VMess协议、传输与加密分别设置 设置参考 订阅与分流从分组管理到自定义出站

PROJECT V / V2FLY / XRAY

V2Ray 生态与内核家族

先区分内核与客户端。内核处理协议、连接和路由；图形客户端负责订阅、设置与进程管理。客户端名称相近，不代表内核功能和配置字段完全一致。

Project V

Project V 是理解 V2Ray 技术背景的起点。V2Ray 将入站、出站、路由与传输拆分成可组合的配置模块。一个本地监听入口可以接收应用请求，再根据规则交给不同出站。这种模块化结构，也解释了为什么客户端界面需要分别设置系统代理、服务器和路由，而不是只提供一个连接开关。

查看项目介绍 →

V2Fly

V2Fly 是围绕 V2Ray 持续开展维护的社区项目，其内核实现延续了模块化配置思路。v2flyNG 以这一内核家族作为安卓端的备选方案。已有配置依赖特定功能时，应先核对协议、传输方式和字段支持情况，再决定使用哪一款客户端；同一订阅能够导入，并不等于每个条目都能被当前内核执行。

区分内核与客户端 →

Xray

Xray 从 V2Ray 技术体系发展而来，在协议与传输实现上有自己的维护方向。v2rayNG 使用 Xray 内核，v2rayN 也常用于管理 Xray 配置。VLESS、Trojan 和 REALITY 等名称属于不同层面的设置概念，不能相互替换；具体组合是否可用，需要让服务端要求、客户端字段与内核能力同时对应。

查看进阶配置 →

三款客户端的开源分工

v2rayN 面向桌面设备，将服务器列表、订阅分组、系统代理与路由放在同一管理界面。v2rayNG 面向安卓设备，通过系统 VPN 接口接入应用流量，并提供分应用代理等设置。v2flyNG 同样服务于安卓设备，适合需要 V2Fly 内核的配置。三款产品均有开源项目背景，客户端本身可免费使用；服务器地址和订阅内容仍需另行准备，下载安装不会自动生成可连接的服务。

开源协议与更新范围

开源协议规定代码使用、修改与分发的条件，不同组件应分别查看各自的许可说明。图形界面、代理内核和路由资源可能独立更新，因此更新客户端、更新订阅与更新规则数据是三件事。升级前备份订阅分组、自定义路由和 DNS 设置；升级后先用原有配置验证一次，再逐项启用新功能。遇到错误时记录报错位置与相关设置，通常比连续重装更容易缩小问题范围。

本站按客户端选择、安装和配置任务组织中文说明。项目名称用于说明技术关系；站点品牌不代表 Project V、V2Fly 或 Xray 项目的官方维护身份。界面示意展示设置结构，实际菜单名称以所安装的客户端为准。

四平台客户端下载入口

先确认设备系统与处理器架构，再选择安装包。桌面设备优先查看 v2rayN，安卓设备优先查看 v2rayNG；需要 V2Fly 内核时再考虑 v2flyNG。下载页集中列出安装入口、适用条件与安装前的检查项。

Windows

使用 v2rayN。桌面版采用跨平台界面，WPF 版保留经典桌面界面。先在系统“关于”页面确认架构，再按下载页说明选择；两种界面入口不代表两套服务器，迁移前保留配置备份。

前往下载

macOS

使用 v2rayN。在“关于本机”中查看芯片名称，Apple Silicon 与 Intel 分别选择对应安装包。首次启动时按系统提示确认权限，随后检查网络代理设置，避免其他代理工具覆盖当前值。

前往下载

Android

优先选择 v2rayNG，v2flyNG 为内核备选。主流设备通常选择 arm64，不确定架构时查看通用包说明。首次连接需要允许系统 VPN 请求；开启分应用代理前，先验证默认连接是否正常。

前往下载

Linux

使用 v2rayN。Debian 与 Ubuntu 系选择 deb，Fedora 等发行版选择 rpm，同时确认 x64 或 arm64。图形桌面的系统代理与终端环境变量分别生效，安装成功后应在实际使用的应用中验证。

前往下载

安装完成后，先导入已有订阅或服务器配置，再选择一个可用条目。订阅是一组配置的更新入口，客户端只负责读取和管理内容；订阅地址应作为私密信息保存，不要放进公开截图或分享给无关人员。需要恢复设置时，先判断应恢复订阅内容还是客户端参数，两者的处理方式不同。

首次使用建议从系统代理或默认 VPN 模式开始。待浏览器与常用应用验证通过，再配置分流、局域网共享或 TUN。一次只调整一项，保留能正常工作的基础配置，排错时就有明确的对照条件。

查看全部客户端 →

订阅、路由与连接设置

按“配置来源 → 流量去向 → 应用范围 → 域名解析”的顺序检查。下面的设置切片保持展开，便于逐项对照；任务选项卡用于查看各步骤的检查重点。

先确认配置是否已读入。 更新后查看当前分组与服务器列表，不要把空列表当成网络连接故障。订阅更新失败时，先记录日志中的错误类型，再检查地址和更新方式。

对照订阅分组设置 ↓

订阅分组与服务器过滤

在“订阅分组设置”中为不同来源单独建组，填写完整订阅地址，再执行更新。分组解决的是来源管理，不会自动改变服务器的协议或可用状态。更新后先确认当前选中的组，再用名称过滤缩小列表；列表为空时检查过滤条件，避免把“没有匹配条目”误判成订阅失效。与直接导入单个分享链接相比，订阅能持续刷新配置，但手工修改的条目也可能在更新时被覆盖，重要调整应另行保留。

查看订阅分组与多订阅管理 →
v2rayN / 订阅分组设置
分组名称更新方式启用 默认分组手动更新是
服务器过滤按名称筛选当前分组
更新前确认来源，更新后检查当前分组。

域名与 IP 路由分流

先选一个接近需求的路由预设，再添加少量自定义规则。域名匹配与 IP 匹配属于不同条件，规则顺序也会影响最终结果。示意中的局域网地址交给直连出站，示例域名交给代理出站；这些文字用于说明匹配语法，并不是可以直接粘贴运行的完整配置。相比只切换全局模式，按目标分流能保留局域网访问，但需要同时理解 DNS 与目标匹配的关系。每次修改后保存，并使用同一个目标复测。

查看路由规则与出站匹配 →
路由匹配项 / 语法示意
域名条件 → proxydomain:example.com
私有域名 → directgeosite:private
局域网网段 → directip:192.168.0.0/16
匹配条件与出站标签分别填写；具体字段以客户端规则编辑器为准。

VPN 模式与分应用代理

v2rayNG 首次连接会请求系统 VPN 权限，允许后才能通过虚拟网络接口接入流量。需要只处理部分应用时，再进入“分应用代理”，确认当前使用包含名单还是绕过名单；两种模式下，同一个勾选动作含义不同。与桌面系统代理相比，VPN 模式的接入范围更广，但仍要结合应用名单、路由和系统限制判断实际行为。修改名单后按客户端提示重新连接，并检查后台电池限制，避免把进程被暂停误判成服务器断开。

查看安卓连接与验证步骤 →
v2rayNG / 连接设置示意
VPN 模式
分应用代理
允许来自局域网的连接
启用流量嗅探
先确认名单模式，再勾选应用。此处为静态设置示意。

DNS 解析与连接排查

域名打不开而直接访问地址可用时，先检查 DNS 日志，而不是立即更换所有服务器。确认解析请求走本地网络还是代理通道，再检查上游解析器是否可达。加密 DNS 地址本身也可能需要先解析，设置不当会形成启动依赖。与单纯更换一个 DNS 地址相比，按域名分流的解析策略更精细，但需要与路由保持一致。FakeDNS 会返回映射地址，启用前应阅读配套设置，排错时先回到简单、可验证的解析路径。

查看 DNS 优化与 FakeDNS →
DNS / 基础字段示意
本地解析器示例223.5.5.5
加密解析器格式示例https://dns.example.com/dns-query
查询策略UseIPv4
example.com 地址仅用于展示格式；实际解析器需自行选择并验证可达性。

设置生效后的验证顺序

先确认内核进程已启动，再检查本地监听端口，随后检查系统代理或 VPN 状态，最后在目标应用中发起请求。客户端显示“已连接”只能说明连接流程已启动，不能代替应用层验证。浏览器能访问而终端不能访问时，应分别检查浏览器扩展、终端代理环境变量与应用自身设置。日志可以帮助判断错误发生在解析、建立连接还是协议握手阶段；分享日志前应移除订阅地址、身份信息和服务器凭据。

如果只是某个站点异常，保留当前客户端与服务器，先复测其他目标，再查看该目标匹配到的路由。若全部应用同时异常，则先检查本地网络和内核运行状态。按影响范围逐步排查，可以避免在订阅、DNS、路由三个页面来回修改后失去原始线索。基础流程见使用文档，按症状查找处理方法可进入帮助中心。

技术笔记与配置解析

先读与当前症状对应的文章，再决定是否需要改动配置。下面三篇按发布日期倒序排列，分别覆盖应用代理范围、配置文件结构和桌面安装。需要虚拟网卡或局域网共享时，可从文章列表继续查看相关专题。

查看全部文章 →