Project V 开源客户端

v2rayN 客户端 下载与配置

按设备选择桌面客户端或安卓客户端,再按教程导入订阅、设置路由与 DNS。

  • VMess
  • VLESS
  • Trojan
  • Shadowsocks
  • REALITY

配置图层

v2rayN 核心设置

订阅决定服务器列表从哪来,系统代理或 TUN 决定哪些流量进入客户端,路由再决定这些流量往哪走。遇到问题时,按这三层分别检查,比同时重设所有选项更容易定位。

按来源添加订阅

订阅分组 → 订阅分组设置 → 添加

把不同来源的订阅分别保存,给每一组起便于识别的别名。更新前先选中目标组,再使用更新当前订阅的入口;需要统一刷新时才更新全部。与逐条粘贴服务器不同,订阅更新会重新读取来源返回的列表,手动修改的记录可能被覆盖。需要长期保留的手动配置应单独保存。更新失败时先看提示是下载出错还是内容无法解析,再决定是否调整配置。

查看订阅与服务器过滤说明

平台与安装包

按设备选择客户端

桌面端使用 v2rayN。安卓端在 v2rayNG 和 v2flyNG 之间按内核需求选择。下载前先查设备的处理器架构;同一个客户端名下的安装包,可能适用于不同芯片或安装工具。

下载页分别列出 v2rayN 桌面版与经典 WPF 版。桌面版采用跨平台界面;已有操作习惯或正在对照旧版教程时,可优先查看经典 WPF 版的说明。两者界面位置可能不同,按功能名查找订阅分组、路由和系统代理,不必逐项对照截图。

下载前在「设置 → 系统 → 关于」核对系统类型。首次连接时,可先选择一个服务器,用读取系统代理的浏览器验证;需要覆盖其他应用时,再考虑 TUN。退出后若系统仍尝试连接本地代理,检查系统代理是否已恢复。

在「关于本机」查看芯片或处理器。显示 Apple 芯片时选择 arm64,显示 Intel 处理器时选择 x64。两种安装包对应不同架构,不能仅凭系统名称选择。安装后先打开客户端,确认能够进入主界面,再导入订阅。

打不开应用与打开后无法设置代理,是两类问题。前者先看系统的应用打开提示,后者再查网络相关授权和代理设置。在受管理的设备上,系统可能限制这些设置;不要把管理策略误判为安装包选错。

需要 Xray 内核时选 v2rayNG;需要对照 V2Fly 配置时选 v2flyNG。确认系统支持 arm64 后再选相应安装包,不确定时查看通用版。安装包架构决定能否在设备上安装,内核选型决定能否处理订阅中的协议和传输字段。

如果系统提示安装冲突,先确认正在更新的是同一个应用,以及系统提示的具体原因。若考虑卸载重装,先确认能否恢复订阅和本地设置。首次申请 VPN 权限时,也要检查设备是否已有另一个应用占用该连接。

按发行版选包格式:Debian、Ubuntu 通常使用 deb,Fedora、openSUSE 通常使用 rpm;再按系统架构区分 x64 与 arm64。格式匹配并不等于依赖一定齐全,安装器若提示缺少组件,应先解决依赖,再检查桌面菜单入口。

教程以图形桌面会话为前提。能打开窗口但应用不走代理时,先确认当前桌面环境是否应用了系统代理设置,再看目标应用是否读取它。浏览器测试成功,也不能直接证明另一个应用会沿用同一套设置。

换设备时保留哪些配置

迁移前先分清订阅地址、手动添加的服务器和本机设置。订阅地址可在新设备上重新添加;独立于订阅的手动记录要另行保存;系统代理、虚拟网卡和应用分流通常与原设备有关,需要在新设备上重新确认。备份中若包含订阅链接或连接信息,应与公开的排障截图分开存放。

先在新设备上完成最小配置:导入一个来源、选择一个已知可用的服务器,再用一种接入模式测试。确认基础连接成功后再恢复自定义 DNS 和路由规则。新设备如果连基础配置都过不了,应先核对架构、内核和权限,不要依赖整套旧配置来碰运气。

生态与维护

Project V、V2Fly 与 Xray

客户端负责呈现设置与管理配置,内核负责建立连接和运行路由规则。两层的项目可以独立发布,因此遇到连线问题时,既要会找界面上的设置,也要知道实际由哪个内核处理。

Project V 的生态分工

Project V 是早期项目生态的名称,V2Ray 是其中的核心代理程序。原有项目逐步由社区接续之后,V2Fly 延续了 V2Ray 的维护与发布;Xray 则从相关代码基础分出,独立演进。今天在客户端里看到的名称,可能指整个生态,也可能指某一个正在运行的内核,阅读教程时要结合上下文区分。

图形客户端将订阅条目整理为可选的服务器配置,并把路由和网络模式转换成内核能使用的设置。看不见服务器列表,往往先查导入或更新;列表能选、内核却起不来,则更值得先查日志,而不是再把同一个地址导入一遍。

内核与协议的兼容范围

判断 V2Fly 和 Xray 是否适合一份配置,要同时看协议、传输和连接安全机制。VMess、VLESS 或 Trojan 是协议名称,WebSocket 是传输方式,REALITY 是连接安全机制。只看到列表里的协议缩写,无法判定其余字段是否也受支持。

例如,服务端要求 VLESS 与 REALITY 及特定流控组合时,应使用支持整套组合的内核,并按服务端参数配置,而不是只把协议菜单改成 VLESS。迁移完整配置时还要核对 DNS 和出站字段,因为连接参数兼容,不代表同一份自定义路由也能原样使用。

三个开源客户端的定位

v2rayN 是以 GPL-3.0 发布的桌面图形客户端,提供订阅、内核选择、路由和网络模式设置。v2rayNG 与 v2flyNG 是开源安卓客户端,分别面向 Xray 和 V2Fly。它们处理的是本机连接配置,不替用户提供订阅或远端服务器。

阅读许可证时,应区分客户端与随客户端使用的内核、组件。客户端的开源许可证说明适用于其代码的条款;内核与其他组件仍应分别查看其许可。免费获取客户端也不等于拥有某项远端服务,后者由实际服务提供方决定。

客户端、内核与订阅的更新

客户端发布可能调整界面与平台适配,内核发布可能改变配置字段与协议支持,订阅刷新则重新读取服务端提供的服务器列表。这三种更新彼此独立:订阅成功并不表示程序已经升级,同一个软件下载包也不能保证不同来源的订阅表现一致。

更新前记录当前所用内核、路由方案和接入模式。更新后先重测一项原本正常的操作,再启用自定义设置。若异常始于一次订阅刷新,优先比对该组的配置变化;若异常始于程序升级,则先查设置迁移或内核启动提示。

使用心得

内核选型与协议笔记

正在选安卓客户端,先看 Xray 与 V2Fly 的差异;想弄清一个名称指图形客户端还是内核,先看生态关系。已拿到 REALITY 配置时,再对照安全机制和流控字段,避免把两处选项当成同一件事。

常见问题精选

订阅更新成功,为什么还是无法连接?

更新成功只表示客户端拿到了服务器列表;选中一条记录后,检查内核是否启动、应用是否把流量交给客户端,再按故障排查说明区分连接失败与域名解析失败。

为什么只有一个应用不走代理?

先确认该应用是否读取系统代理、是否配置了自己的代理,或在 VPN 模式下是否被排除;只有确认流量已经进入客户端后,才需要检查路由规则与出站标签。

刚改过 DNS 或 TUN,应该怎么恢复排查?

恢复到最近一次可用的模式,保持服务器不变,先检查常用应用和局域网访问,再逐项恢复 DNS 或 TUN 设置;若某一步复现异常,就按常见问题继续查该层设置。

一个订阅能在两种客户端中通用吗?

能否读取订阅取决于返回的格式,导入后能否连接还取决于实际内核和配置字段;两台设备能否同时使用,则要另外看服务提供方的规则,可先参照订阅与节点相关术语区分这三件事。