v2rayN · v2rayNG · v2flyNG 使用帮助

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

按系统选择客户端,查找安装配置、订阅导入与路由分流的设置位置和操作顺序。

开源客户端图形界面设置中文配置教程

v2rayN 使用教程

设置位置与作用安装、订阅与代理模式对照

先让一个服务器正常连接,再调整分流和 TUN。下表以桌面界面为线索;不同发行版的菜单名称可能略有变化,请结合当前界面与日志核对。

设置项作用说明v2rayN 桌面
解压目录 → 运行 v2rayN.exe压缩包应完整解压到可写目录,再从目录内启动程序。不要只把主程序拖出压缩包,也不要直接在压缩软件中运行,否则随附内核、依赖和数据目录可能无法正常读取。完整目录运行
设置 → 参数设置 → Core 基础设置先保留默认监听配置,确认内核能够启动,再导入一个可用服务器。若日志提示端口占用,检查已有代理程序后再改端口;依赖报错则按所选安装包的要求补齐运行环境。界面与内核分别检查

第一次配置不必同时调整所有选项。按“启动内核 → 导入服务器 → 设置活动服务器 → 配置系统代理 → 发起请求”的顺序验证,能分清错误发生在数据导入、本地监听还是远端连接。服务器测试结果只反映对应测试条件,不能代替实际应用访问。

查看 v2rayN 安装配置完整步骤 →

客户端与系统选择

V2Ray 客户端下载入口

桌面设备先看 v2rayN,安卓设备先看 v2rayNG。下载前核对操作系统、处理器架构与安装格式;同一客户端的不同安装包并不适合任意互换。具体入口与系统要求在下载页集中列出。

Windows

首选 v2rayN 桌面版;已有经典界面使用习惯时,可比较 WPF 版。桌面版采用跨平台界面,WPF 版面向此系统,两者的菜单布局和运行依赖可能不同。遇到教程截图不一致时,先确认所用界面类型,再寻找同名设置。

压缩包先完整解压到有写入权限的位置。首次运行若出现依赖提示,按安装包说明补齐环境;不要从其他目录拼凑可执行文件。升级前保存配置,退出旧程序后再处理文件,避免两个实例争用监听端口。

前往下载 Windows 客户端

macOS

使用 v2rayN 桌面版,按芯片选择 Apple Silicon 或 Intel 安装包。可先打开“关于本机”查看芯片信息,再对照下载入口;不要只凭电脑的外观或购买年份判断架构。界面与桌面教程相近,但权限确认应以系统实际提示为准。

安装后先导入一组服务器,确认内核运行与浏览器请求都正常。若需要 TUN,再单独处理相关授权。系统代理、应用自带代理与虚拟网卡接管处于不同层级,排查时应明确当前使用哪一种入口,避免多个入口互相干扰。

前往下载 macOS 客户端

Android

优先选择使用 Xray 内核的 v2rayNG;需要 V2Fly 内核生态时,再了解 v2flyNG。多数近年的主流手机适合 arm64 包,无法确定架构时可查看通用包说明。安装前仍应核对设备条件,通用包也不是系统兼容问题的通用解法。

首次连接需要确认系统的 VPN 连接授权。订阅导入完成后,仍要选择服务器并启动连接;只有列表里出现条目不代表服务已经启用。若切到后台后连接中断,再检查电池优化与后台运行限制,不要先把有效订阅反复删除重建。

前往下载 Android 客户端

Linux

使用 v2rayN 桌面版,根据发行版的软件包体系选择 deb 或 rpm,再核对 x64 与 arm64 架构。软件包格式决定安装管理方式,架构决定程序能否在处理器上运行,二者都需要匹配;仅修改文件扩展名不能转换安装格式。

安装后先验证桌面会话中的普通代理连接,再考虑 TUN 所需权限。部分应用不会自动读取桌面环境的代理设置,需要在应用内单独指定入口。出现局部应用无法访问时,应先检查代理继承方式,而不是直接修改整个系统的路由。

前往下载 Linux 客户端

客户端负责读取配置与建立连接,订阅则由对应来源提供。下载安装客户端不会自动生成服务器,也不会自动恢复已经到期的订阅。若已有订阅,保留原始地址并确认可用状态;若只有单个分享链接,应使用服务器导入入口,而不是把它当作订阅地址填写。

查看全部客户端 →

Project V · V2Fly · Xray

V2Ray 开源生态与客户端关系

先分清内核、客户端和订阅,再决定需要更新或修改哪一部分。名称相近不等于功能完全相同,配置能导入也不等于所有连接条件都已满足。

Project V 与内核家族

Project V 是理解 V2Ray 生态的起点,其中的代理内核负责协议处理、传输、路由与连接建立。V2Fly 社区延续 V2Ray 相关项目的维护,Xray 则从相关技术基础上发展出自己的内核与功能路线。日常交流常把整个生态统称为 V2Ray,但具体功能是否可用,需要看客户端实际调用的内核,以及该内核是否实现对应选项。

VMess、VLESS 和 Trojan 是协议名称,WebSocket、gRPC 等属于传输方式,TLS 与 REALITY 又涉及连接的安全与握手设置。这些名称不处于同一层级,不能只凭其中一个词判断配置是否完整。连接参数应与服务器端一致;手动修改时要明确修改的是协议、传输还是安全选项,不能把不同教程中的字段随意拼在一起。

图形客户端与代理内核

v2rayN、v2rayNG 与 v2flyNG 都属于开源图形客户端。图形界面让用户维护服务器、订阅地址和常用选项,再把这些信息转换为内核可以读取的配置。它们并不是同一个程序的三种皮肤:v2rayN 面向桌面环境,v2rayNG 主要围绕 Xray 内核提供安卓配置入口,v2flyNG 则作为 V2Fly 内核路线的安卓备选。

这种分层也决定了排查顺序。窗口无法打开,应先看安装与运行环境;窗口正常但内核启动失败,应看日志、监听端口和配置生成结果;内核运行而某个服务器连接失败,再核对远端参数与网络条件。把界面启动成功当作连接成功,容易跳过真正需要检查的环节。涉及跨内核迁移时,还要核对协议和高级选项是否都能被目标客户端表达。

开源协议与配置隐私

开源意味着软件代码按对应许可证公开,并在许可证规定的条件下使用、修改和分发。生态中的不同项目可能采用不同许可证;以 V2Fly 的 V2Ray 核心和 Xray 核心为例,它们采用 MPL 2.0。客户端项目有各自的许可说明,不能把某一个内核的许可证直接套用到所有界面程序、依赖与附带资源上。需要再分发或修改时,应分别阅读相关项目的许可文件。

开源属性与订阅服务质量是两件事。订阅地址、服务器凭据和本地配置依然需要妥善保管;共享截图时应遮住完整订阅链接,导出的配置也不适合公开发送。使用订阅转换服务前,要理解对方可能读取完整配置。优先确认客户端能否直接导入原始格式,确需转换时再评估处理范围,而不是把“格式转换”当成所有导入失败的第一步。

更新机制与日常维护

客户端更新、内核更新、订阅更新和路由资源更新各自解决不同问题。客户端更新通常影响界面与配置生成;内核更新影响协议实现和运行行为;订阅更新刷新来源提供的服务器;规则与域名资源更新则可能改变分流结果。遇到异常时先记录最近改动,不要同时更新所有组件,否则很难判断是哪一项改变了行为。

日常维护可以从保存配置开始。升级前记录当前系统代理、监听端口和路由选择,备份中如含订阅地址与凭据,应放在受控位置。升级后先用原有设置检查内核启动,再做实际请求,最后验证自定义分流。若只有特定应用异常,优先比较该应用与浏览器的代理入口;若所有请求都失败,再检查本地服务和当前服务器。

系统代理、路由与 TUN 的边界

系统代理解决“哪些应用把请求交给客户端”,路由规则解决“请求进入内核后走哪个出口”,TUN 则通过虚拟网络接口接管流量。这三个概念经常出现在同一教程中,但不能互相替代。启用系统代理后仍有应用直连,可能只是应用没有读取系统设置;启用 TUN 后访问异常,也可能与域名解析、网卡路由或其他网络工具有关。

建议先使用系统代理完成基础验证,再按需要调整路由,最后评估是否启用 TUN。每次修改后,用相同应用访问相同目标,并查看相应时间的日志。这样得到的对比更有意义。日志可能包含服务器信息,向他人求助前应清理敏感内容,同时保留错误类型、发生顺序与设置背景,便于继续排查。

安装与故障排查文章

v2rayN 配置问题与排查步骤

按具体症状选择文章。记录操作前后的变化、当前界面类型与日志中的错误信息,比重复导入相同配置更有助于定位问题。

查看全部文章 →