PROJECT V 生态 · 图形客户端

V2Ray白话指南:
客户端选择与配置教程

从选客户端开始,依次讲清订阅导入系统代理与 TUN路由分流和 DNS。每一步先给操作结论,再解释设置为什么这样选。

永久免费 代码开源 中文文档 V2Fly · Xray
CONFIGURATION MAP

从能连接,到配置清楚

客户端只是配置入口。真正影响使用结果的是订阅更新、流量接管范围、路由规则和 DNS 解析路径。下面四项按实际配置顺序排列。

SUBSCRIPTION

订阅负责批量维护节点

订阅链接可以理解为一份远程配置清单。把链接加入客户端后,还要执行一次更新,节点才会进入当前分组。之后服务端内容发生变化,也需要重新更新订阅;只重启客户端不会自动刷新清单。建议先确认分组已启用,再选择其中一个节点进行连接测试。

手工导入单个 VMess、VLESS 或 Trojan 链接适合临时测试,长期使用更适合按订阅分组管理。分组名称只用于整理,不改变协议本身。复制链接时要保留完整内容,避免聊天工具换行或截断参数。

subscription.json
{
  "remarks": "日常连接",
  "enabled": true,
  "updateInterval": 24
}
CLIENT ENTRY

按系统进入下载页

桌面端优先使用 v2rayN,Android 可在 v2rayNG 与 v2flyNG 之间选择。下载页会继续区分处理器架构和安装包格式。

查看全部客户端 →

DESKTOP

Windows

Windows 桌面端使用 v2rayN。新一代桌面界面适合从头安装,经典 WPF 版适合延续熟悉的菜单结构。进入下载页后按系统架构选择文件,安装完成再导入订阅。首次测试建议先启用系统代理,确认浏览器连接正常后,再处理 TUN 和自定义分流。

前往下载

DESKTOP

macOS

macOS 使用 v2rayN 桌面版。下载前先在系统信息中确认处理器类型:Apple 芯片选择 arm64,Intel 处理器选择 x64。首次打开时按系统提示完成应用授权。若只需要浏览器和常规桌面程序,先从系统代理开始;需要覆盖更多应用时,再阅读 TUN 权限与路由说明。

前往下载

MOBILE

Android

Android 首选 v2rayNG,它采用 Xray 内核并提供订阅、扫码、路由和 VPN 接管入口;需要 V2Fly 内核时可选择 v2flyNG。多数较新的设备优先选择 arm64,无法确定架构时使用通用版。导入订阅后先更新分组,再选择节点并允许系统建立本地 VPN 连接。

前往下载

DESKTOP

Linux

Linux 桌面端使用 v2rayN,可按发行版选择 deb 或 rpm,并区分 x64 与 arm64。安装后若界面能启动但系统流量没有变化,先检查桌面环境是否接受了代理设置,再查看权限和 TUN 配置。排查时把图形客户端、系统代理和应用自身代理分成三层,不要同时改动。

前往下载
QUICK START

三步完成首次连接

先建立最小可用配置,再逐项增加 TUN、DNS 和分流规则。一次只改一个变量,连接异常时才能知道问题出在哪一层。

查看完整教程 →
  1. 01

    安装与导入

    桌面系统安装 v2rayN,Android 安装 v2rayNG 或按内核需求选择 v2flyNG。打开客户端后找到订阅设置,新增分组并粘贴完整订阅链接,然后执行更新。若列表仍为空,先检查分组是否启用、链接是否被截断,以及更新操作是否真正完成。

    只有单个节点链接时,可以使用从剪贴板导入或扫码入口。订阅和单节点最终都会生成本地配置,但订阅更适合后续批量更新。导入完成后先不要改路由模板,保留默认设置有利于判断节点本身能否建立连接。

  2. 02

    选择节点与接管方式

    从订阅分组中选择一个节点,将它设为当前活动配置。桌面端先开启系统代理,让会读取系统设置的应用通过客户端;Android 端启动连接并确认系统授权。此时只验证基础连接,不要同时启用复杂分流、自定义 DNS 和多层代理。

    需要让更多桌面程序进入客户端时,再考虑 TUN。启用前确认普通系统代理已经工作,并关闭可能占用相同虚拟接口或代理端口的其他程序。TUN 失败不等于节点失效,它更常与权限、路由表、虚拟接口或 DNS 接管方式有关。

  3. 03

    验证并逐项优化

    基础连接建立后,分别测试一个应直连的目标和一个应走代理的目标,再观察客户端日志是否出现对应出站。若只有域名访问异常而直接连接地址正常,应优先检查 DNS;若浏览器正常但特定程序不通,应检查该程序是否读取系统代理或是否需要 TUN。

    最后再加入自定义路由。每次只增加一组规则,保存后重连并复测。遇到问题时按“订阅内容、节点连接、流量接管、路由命中、DNS 解析”的顺序向下排查,比反复切换节点更容易定位根因。

OPEN SOURCE ECOSYSTEM

Project V、内核与客户端的关系

把内核、图形界面和订阅服务分开理解,很多配置问题会简单得多。它们处在不同层级,名称相近,但职责并不相同。

PROJECT V

Project V 是生态背景

Project V 形成了一套可组合的网络代理工具与配置模型。常见配置由入站、出站、路由、DNS 和传输参数组成:入站接收本机应用流量,出站决定流量如何离开,路由负责把不同目标交给指定出口,DNS 则提供域名解析结果。图形客户端把这些结构转换成菜单、开关和订阅分组,让日常使用不必从空白配置文件开始。

理解这一层的意义在于:客户端界面里的“系统代理”“路由模式”“远程 DNS”并不是互不相关的独立功能,它们最终会转成内核能够读取的配置。连接失败时,应该确认问题发生在界面保存、配置生成、内核启动还是网络出口,而不是把所有异常都归到节点。

CORE FAMILIES

V2Fly 与 Xray 是两个内核家族

V2Fly 延续 Project V 的社区实现与配置体系,Xray 则在相近配置思路上维护自己的功能集合。两者都能处理常见的入站、出站、路由和 DNS 任务,也都支持多种传输组合,但具体字段、功能边界和更新节奏可能不同。复制配置时应先确认目标客户端使用哪个内核,不能只看节点名称相同就假定全部选项可以互换。

VMess、VLESS、Trojan 等名称描述的是协议或配置方式,V2Fly、Xray 描述的是执行配置的内核家族,v2rayN、v2rayNG、v2flyNG 则是用户直接操作的客户端。把这三层分开,可以避免把协议能力、内核能力和界面功能混成同一个概念。

CLIENT LAYER

三款客户端负责不同平台入口

v2rayN 是桌面端图形客户端,覆盖 Windows、macOS 与 Linux,负责订阅管理、节点切换、系统代理、TUN、路由模板和日志查看。它并不是一种新协议,而是把内核配置组织成桌面界面。不同桌面系统的权限模型和代理设置入口不同,因此同一个选项在各平台上的启用过程会有差异。

v2rayNG 面向 Android,通常搭配 Xray 内核;v2flyNG 同样面向 Android,但以内核家族差异作为主要选择依据。两者都可以导入订阅和单节点配置,也都通过系统提供的本地 VPN 接口接管应用流量。选择时先看订阅内容与所需内核能力,不必只根据界面名称判断。

LICENSE & MAINTENANCE

开源协议与维护节奏要分别看

客户端和内核由不同项目维护,各自有明确的开源许可、发布节奏和兼容范围。开源意味着代码、许可边界与变更记录可以公开审阅,但不代表所有组件会在同一天更新。客户端发布通常还要完成界面适配、内核集成和平台打包,因此客户端更新与内核更新存在时间差是正常现象。

日常使用不需要追逐每一次变更。出现协议兼容、系统升级或明确故障时,再阅读更新说明并升级更稳妥。更新前记录当前订阅分组、路由模式和 DNS 设置,升级后先验证基础连接,再恢复自定义规则。这样可以把“程序更新带来的变化”和“原有配置问题”分开判断。