Project V · 客户端与配置参考

V2Ray入门指南 v2rayN 下载与配置

从订阅导入到路由分流,对照客户端菜单与 JSON 字段,检查本地端口、系统代理和 DNS。

  • VLESS / VMess
  • Trojan / REALITY
  • Xray · V2Fly
选择平台
先定位菜单,再改字段

客户端设置
与配置入口

先区分三个层次:订阅保存远端连接参数;系统代理决定应用是否把请求交给客户端;路由决定已经进入内核的连接从哪里出去。导入成功,只说明参数已读取,不代表浏览器已经使用代理。

右侧按常用菜单整理六类设置。先完成一个订阅分组和一个可用连接,再调整路由与 DNS。每次只修改一项,并保留修改前的值;发生错误时,才能把日志变化对应到具体操作。

查看配置字段 →

菜单名可能随界面调整

找不到相同按钮时,按功能定位“订阅分组”“参数设置”“路由设置”。图示是设置项关系示意,不是连接状态。代码中的 direct 需要对应已定义的出站标签,不能只复制一条规则就期待完整配置运行。

订阅链接与分组更新

订阅适合集中维护多条连接。在 v2rayN 打开“订阅分组设置”,新增分组并粘贴完整地址,保存后执行“更新订阅”。安卓端在“订阅分组设置”填写地址,再返回主页更新。它与逐条导入分享链接的区别是后续可按分组刷新。更新报错时先检查地址有效期、系统时间和网络路径,不要反复删除原有分组。订阅地址可能包含访问凭据,截图与求助日志中应隐藏完整链接。

  • 订阅分组设置 → 地址(Url)
  • 更新订阅 → 不通过代理 / 通过代理
  • 自动更新间隔 → 按需设置
先选系统,再选架构

V2Ray 客户端下载入口

桌面选择 v2rayN,安卓优先查看 v2rayNG。安装包架构取决于设备处理器,不取决于订阅使用的协议。以下入口进入下载页对应的平台面板,再按设备选择安装包。

Windows

v2rayN · 桌面客户端

下载页提供 Desktop 桌面版与经典 WPF 版入口。前者采用跨平台界面,后者保留熟悉的经典操作布局。选择前先查看系统要求,已有配置的设备应先导出备份,不要直接覆盖唯一一份工作配置。

首次运行后,先导入订阅并选定活动连接,再设置系统代理。若浏览器仍无法访问,检查本地端口是否被其他程序占用,以及安全软件是否阻止客户端启动内核。先看日志中的具体错误,再考虑重装。

前往下载

macOS

v2rayN · 按芯片选择

在系统菜单打开“关于本机”,查看显示的是芯片名称还是 Intel 处理器。Apple Silicon 设备选择 arm64,Intel 设备选择 x64。先确定架构,再进入下载页选择相应安装入口,避免仅凭设备年份判断。

安装后检查系统代理是否已应用到当前网络服务。无线网络与有线网络可能保留不同设置;切换网络后若连接异常,应重新查看当前服务的代理地址和端口。独立设置代理的应用仍需在应用内部检查。

前往下载

Android

v2rayNG · v2flyNG

优先查看使用 Xray 内核的 v2rayNG;需要 V2Fly 内核环境时,再了解 v2flyNG。主流较新设备通常选择 arm64,无法确定架构时查看通用包说明。两个客户端分别管理配置,安装其中一个不会自动迁移另一个的订阅。

首次连接需要确认系统 VPN 授权。同一时间的其他 VPN 类应用可能影响连接建立,应先确认当前由哪个应用接管流量。启用“分应用代理”后,检查选择的是允许列表还是排除列表,避免把测试浏览器排除在外。

前往下载

Linux

v2rayN · deb / rpm

先按发行版的软件包体系选择 deb 或 rpm,再区分 x64 与 arm64。桌面客户端适合在图形环境中管理订阅和路由;包格式相同不代表所有系统依赖都相同,安装前应阅读下载页对应的系统要求。

不同桌面环境和应用对系统代理的处理可能不同。浏览器能访问而其他程序失败时,先检查该程序是否读取桌面代理设置,再查看它自己的 HTTP 或 SOCKS 入口。不要把单个应用未接入代理误判成整个订阅不可用。

前往下载

客户端是本地连接工具,订阅与远端服务需要另行配置。更换平台时可以复用兼容的订阅,但系统代理、应用范围和本地端口应在每台设备上分别确认。

查看全部客户端 →
界面、内核、协议分开看

Project V 与开源内核生态

“V2Ray”常被用于指代一组工具与配置习惯。实际排查时,仍需写清客户端名称、内核类型和连接协议。同一个界面能导入链接,不等于底层内核支持链接中的每一项参数。

Project V

配置与代理工具生态

从本地入站接收请求,经规则选择出站;图形客户端在这套结构上提供菜单与配置管理。

  • V2Fly → 社区延续维护的 V2Ray 项目
  • Xray → 从 V2Ray 发展出的独立内核项目
  • v2rayN / v2rayNG / v2flyNG → 图形管理入口

Project V:先理解配置结构

Project V 是围绕网络代理工具形成的开源项目体系,V2Ray 是其中广为使用的实现。其配置通常把监听入口、远端连接、路由匹配和解析行为拆成不同模块。这样的组织方式有利于逐段定位问题:应用没有请求记录,先检查入口;有记录但目标被送错出口,再检查路由;域名打不开而地址可达,则继续查看解析环节。不要在一次测试中同时替换订阅、内核和 DNS,否则很难判断哪个改动产生了效果。

V2Fly 与 Xray:共同背景,不等于字段通用

V2Fly 由社区延续维护 V2Ray 项目;Xray 从 V2Ray 发展而来,随后形成独立的功能演进路线。两者共享一部分概念和配置习惯,但协议支持、安全参数和字段细节会随实现变化。看到“未知字段”或“协议不支持”时,应先确认运行的是哪个内核,并对照相应说明。REALITY 属于传输安全相关配置,不能仅凭链接标题判断兼容性,更不能把它当作所有协议都能直接套用的独立节点类型。

三款客户端:图形界面管理连接参数

v2rayN、v2rayNG 与 v2flyNG 都属于开源图形客户端。v2rayN 提供桌面环境中的订阅、路由和内核管理;v2rayNG 主要围绕安卓与 Xray 内核运行;v2flyNG 提供安卓上的 V2Fly 内核选择。它们的开源许可分别由各自项目声明约束,不能把某个内核的许可直接套到所有客户端。选择时先看系统与所需功能,再看已有配置是否兼容,而不是按名称相似程度判断能否替换。

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

三种更新的对象不同。客户端更新改变界面和配置生成逻辑;内核更新改变实际连接实现;订阅更新主要刷新服务提供方发布的连接参数。域名与地址匹配所用的规则文件又是另一类资源。订阅更新成功不会自动解决系统代理未开启,也不会保证规则数据库已经更新。维护时先备份订阅分组与自定义规则,读清更新说明,一项一项操作;出现问题时记录报错原文,不要只记录“不能用”。

从现象回到具体设置

导入成功,为什么浏览器仍未使用代理?

导入只负责保存连接参数。继续选择活动连接,确认系统代理已开启,再看浏览器是否遵循系统设置。如果日志里没有对应请求,先检查入口,不要立即修改远端端口。操作顺序见系统代理设置。

全局代理是否会接管所有程序?

路由中的全局通常影响进入内核后的出站选择,不会强制所有程序接入。终端、游戏或独立网络组件可能需要自己的代理配置。先明确应用请求从哪里进入,再讨论是否分流,见连接验证方法。

分享链接与完整配置文件有什么区别?

分享链接通常描述单条远端连接,完整配置还包含本地监听、DNS 和规则。分享链接导入后,客户端会结合本地设置生成运行配置。不要将配置文件直接填入订阅地址栏,先阅读JSON 结构总览。

节点测速结果可以代替实际访问吗?

单项测试只能反映对应的测试目标和请求方式。测试有响应,不代表每个应用、域名或协议都正常。选定连接后,还应通过实际应用访问并对照日志;需要切换连接参数时,先看协议参数说明。

阅读配置字段时,建议从 inbounds 入站到 outbounds 出站建立连接路径,再检查 routing、dns 与 policy。配置示例用于说明字段关系,实际端口、标签与服务器参数应以设备上的设置为准。

按操作场景继续查

近期配置说明

完成首次连接后,再处理共享、迁移与解析策略。每篇说明围绕一个操作场景展开,先确认适用条件,再修改客户端设置;涉及凭据或地址的截图,应先隐藏敏感内容。