v2rayN · v2rayNG · v2flyNG 客户端

V2Ray帮助中心客户端下载与配置

按平台选择客户端,跟随中文配置教程完成订阅导入,再检查路由与连接状态。

客户端选择与平台下载

先确认操作系统与处理器架构,再选择安装包。客户端负责读取配置,连接所需的订阅或服务器参数需要另外准备。

Windows

选择 v2rayN。桌面版采用跨平台界面,经典 WPF 版保留熟悉的桌面操作布局。首次使用可先按下载页说明安装桌面版;已有配置的用户应先导出备份,再决定是否更换界面版本。

前往下载 →

macOS

选择 v2rayN,并在「关于本机」查看芯片信息,区分 Apple Silicon 与 Intel 安装包。首次打开若出现系统安全提示,应先确认应用来源,再按「隐私与安全性」中的说明处理放行与网络权限。

前往下载 →

Android

优先查看采用 Xray 内核的 v2rayNG,使用 V2Fly 配置时也可了解 v2flyNG。主流设备通常选择 arm64,架构不确定时查看通用版说明。首次连接需要同意系统的 VPN 连接请求。

前往下载 →

Linux

选择 v2rayN,按发行版的软件包管理方式区分 deb 与 rpm,再确认设备使用 x64 还是 arm64。桌面环境的系统代理设置与应用行为可能不同,安装后应分别验证浏览器与目标应用的实际连接。

前往下载 →

常用设置与配置路径

把订阅、路由和解析分开检查。每次只调整一类设置,保留能够恢复的原始配置。

先添加分组,再更新订阅

订阅地址用于获取服务器配置,不是直接填写到服务器地址栏的内容。在 v2rayN 的「订阅分组」中添加来源,填写便于识别的备注并保存,再执行「更新订阅」。列表为空时,先切回「全部」检查筛选,再查看更新日志。不同来源单独建组,后续更新、停用和删除都更容易定位。与逐条手工录入相比,订阅可以集中刷新参数,但有效期与内容仍由提供方决定;订阅地址应按凭据妥善保管。

了解配置 →

界面示意用于说明配置关系,具体菜单位置可能随客户端构建变化。路由片段需要合并到完整配置中使用;开始修改前,先确认当前使用的内核与配置格式。

从订阅导入到连接验证

先用最少设置建立可用连接,再逐步启用分流和接管功能。遇到问题时,回到上一步确认结果。

  1. 准备配置并导入

    安装客户端后,先确认手头的是订阅地址、分享链接还是完整配置文件。订阅地址应保存在订阅分组中;分享链接则按客户端的剪贴板导入入口处理。不要把网页说明地址误当成订阅地址,也不要在公共截图中展示完整链接。

    在 v2rayN 中保存分组后执行「更新订阅」,确认服务器列表出现内容。安卓端可通过 v2rayNG 的添加或导入菜单读取已有配置。导入失败时先看日志里的请求错误,区分链接失效、响应格式不符与网络请求失败,再决定下一步。

  2. 选择服务器与代理方式

    从导入的列表中选定一项,并在 v2rayN 中「设为活动服务器」。桌面端需要浏览器读取系统代理时,选择「自动配置系统代理」;安卓端启动连接后,按系统提示同意 VPN 请求。先采用客户端现有的基础路由,不急着叠加自定义规则。

    系统代理不是所有应用都会遵循的统一开关。浏览器可用但某个应用不能连接时,应先检查该应用自己的代理设置。只有明确需要接管这类流量时,再阅读 TUN 配置章节,避免把权限问题与服务器问题混在一起处理。

  3. 测试连接并保留基线

    执行「测试真连接延迟」后,还需要打开实际使用的网站或应用验证。列表测试结果只反映指定测试目标的连接情况,不能代表所有域名、传输协议和应用都可用。测试时尽量保持目标一致,并记录使用的代理模式和路由设置。

    连接正常后再备份配置,逐项加入路由例外、DNS 或 TUN 设置。每改一项都复测;出现异常时恢复刚才的可用状态。排查记录可以保留错误类型和发生时间,但应移除订阅地址、用户标识及其他访问凭据。

Project V · V2Fly · Xray

开源生态与
客户端职责

先区分界面、内核与服务配置,再理解为什么同一份订阅在不同环境下可能表现不同。

代码开源图形化管理社区维护

Project V 与内核家族

Project V 是围绕网络代理技术形成的开源项目生态,V2Ray 是其中的重要组成部分。V2Fly 社区延续了相关内核的维护,Xray 则是从相关技术基础发展出的另一条内核路线。它们共享部分协议概念和配置习惯,但功能演进、扩展字段与支持范围并不完全一致。因此,看到「V2Ray 配置」时,还需要进一步确认实际使用的内核,而不是仅凭文件名判断兼容性。

协议名称只是连接条件的一部分。相同的 VLESS 或 VMess 配置,还可能搭配不同传输方式、安全层和路由设置。使用 REALITY 等特定能力时,应核对内核支持及服务端要求;参数不能靠猜测补齐。若日志明确指出字段不识别,优先检查兼容性与配置来源,不要先把所有网络设置恢复为默认值。

三款客户端各自负责什么

v2rayN 为桌面环境提供服务器列表、订阅分组、路由与系统代理等图形化管理入口,适合需要在多个订阅来源之间整理配置的用户。客户端把界面选项转换为内核运行所需的配置,最终连接仍由所选内核执行。界面能保存设置,并不意味着服务器一定接受这些参数;连接结果需要结合启动日志与实际访问共同确认。

v2rayNG 面向安卓设备,采用 Xray 内核路线,通过系统 VPN 接口处理代理连接,并提供订阅管理和分应用等设置。v2flyNG 同样面向安卓设备,采用 V2Fly 内核,可作为匹配相应配置时的备选。选择时先看订阅要求和功能需求,再看界面习惯;不要因名称接近就默认两者的扩展参数、配置导出格式和行为完全相同。

开源协议与使用边界

这三款客户端均有公开的开源代码,客户端与所集成的内核分别遵循各自的开源许可。许可说明的是代码使用、修改与分发条件,不是对外部订阅内容或网络服务质量的保证。阅读相关信息时,应把客户端项目、内核项目与订阅提供方分开看待;界面相同,也可能连接到完全不同的服务环境。

日常使用中,订阅链接、分享链接和导出的配置文件可能包含账号标识、访问令牌或密钥材料。需要求助时,保留报错文字、操作步骤与模式名称通常已经足够,不宜直接公开完整配置。本站文档侧重客户端设置与技术概念,服务有效期、服务器权限和订阅内容需要向相应提供方确认。

客户端、内核与规则分别更新

更新客户端主要影响管理界面和集成功能,更新内核可能改变协议支持与运行行为,更新 GeoIP、GeoSite 数据库则影响分类规则的匹配范围。这三件事不应混为一次操作。若只遇到个别域名分流不符,可以先检查规则顺序和数据库;若内核无法启动,再核对配置字段与内核能力。

更新前导出可用配置,记录当前代理方式与路由预设。更新后先验证基础连接,再检查自定义出站、DNS 和 TUN,不要同时引入多处新设置。订阅更新也可能改变服务器列表,重要的手工修改应单独记录,避免下一次刷新覆盖后难以还原。建立这样的检查顺序,比单纯追求更新频率更有助于保持配置可解释。

配置问题的专题说明

按具体症状阅读:先定位后台、解析或协议差异,再进入对应设置。以下为最近发布的三篇文章。