Project V 生态 · 客户端指南

V2Ray开源网客户端与分流教程

按系统选择开源客户端,从订阅导入到路由分流,逐步确认流量走向。

01 生态概览

图形客户端与内核

客户端负责编辑和管理配置,内核负责建立连接、处理请求与匹配路由。界面能打开,不代表内核已正常启动。

  • Project VV2Ray 源于 Project V。入站、路由和出站各自有配置,这也是阅读内核日志时区分问题位置的依据。
  • V2Fly社区延续维护 V2Ray 核心。使用 v2flyNG 时,按实际内核查阅协议和规则字段。
  • Xray由 V2Ray 生态分化而来。遇到 REALITY 等配置时,应按 Xray 文档核对参数。
  • MPL-2.0V2Fly 的 V2Ray 核心与 Xray-core 采用的开源协议。客户端各自有独立的许可声明。

02 配置路径

订阅、代理模式与路由规则

从配置来源、流量接管到规则命中,分别验证。出现异常时,先确认故障在哪一层,再调整设置。

先安排例外规则,再确定默认出站

在 v2rayN 的路由设置中,先确认正在使用哪套规则,再按匹配顺序检查出站。内核通常采用首条命中的规则,因此局域网直连和特定域名拦截应放在宽泛的规则之前。域名条件和地址条件需要分别验证;同一条规则内同时填写两类条件,并不表示命中任意一类就行。改完后重新发起请求,从日志确认出站,而不是只凭页面能否打开判断分流是否生效。

出站映射示意,默认出站取决于实际配置
geoip:private             → direct
geosite:category-ads-all  → block
geosite:cn                → direct

03 安装包选择

按系统和架构下载

先选系统,再核对处理器架构。桌面使用 v2rayN;安卓按所需内核选择 v2rayNG 或 v2flyNG。

Windows

v2rayN Desktop / WPF

首次安装可从 Desktop 版入手;已有 WPF 界面使用习惯的用户可选经典 WPF 版。两者主要区别在界面和打包方式,不是两套代理协议。先在系统信息中确认系统类型,再按下载页说明准备运行环境。

解包后从完整目录启动,不要只把可执行文件拖到桌面单独运行。迁移时先备份旧目录里的用户数据,再测试新程序能否读取分组和节点。如果双击后界面未出现,优先核对运行库、目录写入权限和安全软件记录,而不是重新导入订阅。

前往下载

macOS

v2rayN Apple Silicon / Intel

在「关于本机」查看芯片或处理器一栏。Apple Silicon 选 arm64,Intel 选 x64。不要按产品外观或购买年份猜架构,同一系列电脑在不同代际可能使用不同芯片。

安装后先用一条已知可用的配置确认客户端能启动内核。若浏览器可以访问而某个程序仍不能连接,检查该程序是否读取系统代理。已有独立代理设置的应用应单独核对本机地址、监听端口及代理类型,避免沿用另一款客户端留下的设置。

前往下载

Android

v2rayNG / v2flyNG

v2rayNG 使用 Xray 内核。明确需要 V2Fly 内核时,再选 v2flyNG。设备支持 arm64-v8a 时可选 arm64 包;不清楚设备支持哪种架构时可先看通用包,仍须满足系统要求。

首次启动代理服务时,按系统提示确认 VPN 连接权限。如果设备上还有其他占用 VPN 槽位的应用,先停止旧连接再测试。出现锁屏后连接中断时,分别检查 VPN 状态、后台限制和网络切换记录,不要仅凭这一现象判断远端节点已失效。

前往下载

Linux

v2rayN deb / rpm

Debian、Ubuntu 系优先看 deb,Fedora 等采用 RPM 包管理的发行版看 rpm。包格式与处理器架构是两项独立条件。x86_64 对应 x64,aarch64 对应 arm64;换一个包格式不能解决架构不符。

装好后用桌面应用和终端程序分别测试。桌面环境的系统代理未必会影响终端程序,某些工具会使用自身的代理设置或环境变量。若终端独自失败,先查它实际读取哪些设置;若两者都失败,再回客户端确认内核启动和本地监听。

前往下载

04 开源生态

Project V、V2Fly 与 Xray 的关系

判断配置能否迁移,要分别核对客户端、内核和规则库,而不只是看节点名称或导入结果。

一条请求在内核中的处理顺序

inbound → routing → outbound

客户端生成或加载配置;进入内核的请求按路由规则选取出站。

查看内核与路由术语

了解本站文档范围

  1. Project V:从入站到出站的配置模型

    Project V 是 V2Ray 生态的起点。对日常使用最有帮助的是它的配置模型:入站接收请求,路由决定流量交给哪个出站,出站再直连、转发或按配置拒绝。图形客户端的节点列表只是配置的一部分,并不能说明所有应用请求都会进入内核。比如浏览器和同机命令行工具可以各有代理设置,即使它们访问同一个地址,实际流量也可能经过不同入口。

    因此,从桌面界面看到已经选中节点时,仍要区分两件事:内核是否成功监听,以及目标应用是否真的把请求送到这个监听入口。如果日志里没有出现目标请求,应该先检查应用接入方式。此时反复变更远端传输参数,不会让未到达内核的流量改变路径。

  2. V2Fly 与 Xray:共同的配置思路,不同的实现

    V2Fly 是社区对 V2Ray 核心的延续维护。Xray 从这一技术脉络分化,作为独立项目发展。两者在入站、路由、出站等基本概念上相通,但协议、传输方式和安全字段会随各自实现演进。客户端能解析分享链接,只能说明链接被识别;并不能证明所选内核支持其中的每个参数,更不能证明远端使用了同样的组合。

    迁移时先核对协议、传输和安全层,再决定用哪个客户端和内核。以 REALITY 为例,应按 Xray 的对应文档检查安全层设置,不要把显示在分享链接中的协议名当成完整配置。若普通配置能连而某个节点报不支持,应保留完整错误类型,优先核对该节点的字段和内核实现。

  3. 三个开源客户端各自管理什么

    v2rayN 是桌面端图形客户端,管理订阅、服务配置、代理模式和路由;实际能使用哪些内核,要看所选发行包和配置。v2rayNG 面向安卓,主要提供 Xray 配置入口;v2flyNG 同样面向安卓,但使用 V2Fly 内核。三者都可以管理节点,却不能把对方的界面选项、导入格式和默认路由当成一回事。

    首次配置不必同时安装两款安卓客户端。先按节点要求选内核,再导入一条配置完成基本测试。若要比较两款,保持测试网络和目标一致,并确认每轮只有待测客户端的 VPN 服务在运行。这样才能区分差异来自客户端、内核还是接管流量的方式。

  4. 开源协议与社区发行

    V2Fly 的 V2Ray 核心和 Xray-core 使用 MPL-2.0。它是文件级开源协议;分发经过修改的受覆盖代码时,应按该协议履行相应的源码义务。客户端和内核是不同项目,其他随包组件也可能有自己的许可。查阅或再分发时,应分别看项目和组件随发行包附带的许可声明,不要用某个内核的许可概括整个客户端。

    社区会分别维护界面、核心实现和规则数据。文档中的设置名称用于定位功能,既不代表所有界面布局相同,也不代表一次客户端更新会自动刷新订阅和规则库。选包时先关注系统、架构和内核能力;诊断时则以本机配置和实际日志为准。

  5. 订阅、规则库和客户端分别更新

    更新客户端改动的是程序,刷新订阅改动的是节点来源,更新规则库改动的是匹配数据。这三项最好分开进行。更新前保留一份可用配置,记录当前规则集和本地监听端口。更新后先复测同一个目标,再验证本地服务直连和需要代理的请求是否仍走预期路径。

    若订阅更新后只有个别配置失败,先比对这些配置的传输参数;若规则库更新后只有某类域名走向异常,检查分类是否变动,及是否被前面的规则提前匹配。若客户端更新后所有请求都失败,先看内核启动和监听错误。按改动范围缩小排查面,比同时重装、刷新订阅和改 DNS 更容易找到原因。

05 资讯与排查

最新配置与排查文章

启动失败先看本地监听,安装失败先核对软件包,流量走向异常再看路由与规则库。

V2Ray 本地端口被占用:定位冲突进程与修改监听端口

用系统自带命令找出占用 10808、10809 端口的进程,说明在 v2rayN 中修改本地 SOCKS 与 HTTP 监听端口的步骤,以及改完后需要同步调整的设置。

改端口前,先确认占用者是不是已运行的客户端。若是旧实例,退出它并重新启动通常比改配置更直接。确实要保留两个程序时,再为它们分配不同端口。修改后,用同一应用复测,并确认应用没有继续读取旧代理地址。

v2rayN Windows 版安装配置全流程:WPF 版与 Desktop 版怎么选

从选包、解压、首次运行到导入订阅一步步走完,对比 WPF 版与 Desktop 版的差异,并汇总缺少运行库、杀软拦截、路径含中文等常见问题。

用首次启动作为分界:界面未出现时先查运行环境;界面出现却无节点时,再查导入和订阅更新。两类问题要看不同的提示。

GeoIP 与 GeoSite 规则库更新方法及路由规则写法

介绍 geoip.dat 与 geosite.dat 的用途、在客户端内更新规则库的路径,以及 geosite:cn、geoip:private 等常用写法在分流规则中的组合方式。

验证规则时,分别准备一个域名请求和一个直接使用地址的请求。若只有其中一种走向异常,先检查匹配对象是否与规则类型一致。

下载客户端