跳转到正文
客户端选择 · 订阅配置 · 连接排查

V2Ray 客户端下载 v2rayN 配置教程

从订阅导入开始,按顺序设置路由分流与TUN 模式。

  • VMess
  • VLESS
  • Trojan
  • REALITY

CLIENT WORKFLOW

订阅、分流与代理接管

先把节点导入客户端,再决定哪些流量进入内核。界面负责管理配置,内核负责建立连接;系统代理与 TUN 则决定应用流量怎样到达内核。把这三层分开检查,比同时改动多个开关更容易定位问题。

订阅地址用于获取一组节点配置,不等于单个节点的分享链接。在「订阅分组设置」中新建分组,填入备注与地址,保存后执行「更新订阅(不通过代理)」。若当前网络无法访问订阅地址,且已有可用连接,再尝试通过代理更新。按来源分别建组,方便单独更新与排查。与逐条手填相比,订阅能集中维护节点字段,但更新是否成功仍应以日志和节点列表为准。

路由按域名、目标地址等条件选择直连或代理出站。先在「路由设置」中选择适合当前网络的规则,再检查默认出站;不要把系统代理开启误认为全部流量都经过同一出口。需要访问本地设备时,应保留私有地址直连规则。与单一出口配置相比,分流可以分别处理不同目标,但规则顺序和域名解析结果都会影响命中。修改后用同一应用复测,并结合日志确认实际选择的出站。

系统代理主要作用于遵循系统代理设置的应用,适合先验证浏览器连接。TUN 通过虚拟网络接口接管流量,适用于不读取系统代理的程序,但需要相应权限与路由支持。先让普通代理连接正常,再启用「TUN 模式」,避免把节点故障和虚拟网卡故障混在一起。与只设置系统代理相比,TUN 的覆盖范围更广,也更容易受其他虚拟网卡、DNS 设置和网络工具影响。退出后应检查系统网络是否恢复。

内核负责解释配置并执行连接,图形界面中的同名字段不代表所有内核都支持相同组合。在 v2rayN 的「设置」中检查对应配置类型的内核选择,按节点协议和传输要求选择 Xray 或 sing-box。切换前记录原选项,切换后检查启动日志。与固定内核客户端相比,多内核提供更多适配空间,但不能只靠切换修复错误凭据或失效节点。涉及特定安全机制时,应同时确认客户端与内核的字段支持。

v2rayN · 订阅管理

订阅分组设置

备注按来源命名
订阅地址填写完整 URL
首次获取更新订阅(不通过代理)
完成后查看更新日志
分组 → 更新 → 选择活动节点

首次配置:一次只验证一层

导入完成后,先选中一个节点并设为活动服务器,再检查内核是否启动。节点出现在列表中,只能说明配置已经读入,不能说明远端服务一定可达。测试时保留日志面板,记录是启动时报错,还是访问目标时超时;这两种情况对应的检查方向不同。

随后开启系统代理,用浏览器访问一个明确的测试目标。若浏览器正常而其他程序失败,先查该程序是否使用系统代理,不要立即重装客户端。需要扩大流量接管范围时,再阅读 TUN 权限与 DNS 部分。不同系统、界面分支的菜单名称可能略有差异,应按功能定位,具体流程见快速上手教程。

订阅地址与节点参数:分开保存

订阅地址通常包含访问凭据,应按账户信息保管。截图求助前,遮住地址中的查询参数以及节点的身份字段。订阅无法更新时,先检查地址是否完整、是否过期、返回内容是否为登录页面;已经导入的节点能否连接,则需要另查节点状态。两条链路可以独立失败,不能用其中一条的结果代替另一条。

PLATFORM SELECTOR

按操作系统选择客户端

桌面平台从 v2rayN 开始;Android 优先了解 v2rayNG,再按内核需求考虑 v2flyNG。下载页集中提供架构选择与安装说明。客户端只负责读取和运行配置,安装完成后仍需准备可用的订阅地址或节点参数。

Windows

v2rayN 首推

下载页提供桌面版与经典 WPF 版入口。桌面版使用跨平台界面,WPF 版保留经典操作布局;按使用习惯选择即可,不必为同一份订阅同时安装两套界面。安装前确认系统与处理器要求,首次启动后先找到「订阅分组设置」,再导入配置。

需要 TUN 时,按客户端提示检查管理员权限。若启用后网络中断,先关闭 TUN,确认系统代理路径能正常连接,再检查虚拟网卡和其他网络工具。正常退出客户端后,也应确认系统代理设置已按预期恢复。

前往下载 Windows 客户端 →

macOS

v2rayN

先在系统菜单的「关于本机」中查看芯片信息,再选择 Apple Silicon 或 Intel 对应入口。架构选择决定程序能否按预期运行,不影响订阅地址的写法。将应用放入应用程序目录后启动,再完成订阅导入与活动节点选择。

遇到系统安全提示时,阅读提示内容并核对应用来源,通过系统设置中的对应入口处理,不要直接关闭整套安全机制。首次使用先验证系统代理;需要 TUN 时,再按提示授权并检查网络扩展或虚拟接口状态,菜单细节参见安装大全。

前往下载 macOS 客户端 →

Android

v2rayNG / v2flyNG

v2rayNG 使用 Xray 内核,作为优先选择;v2flyNG 使用 V2Fly 内核,适合明确需要该内核配置的场景。多数较新的设备可以选择 arm64,架构不明确时再查看通用版说明。不要仅凭应用名称接近,就认为两者支持的协议组合完全一致。

添加订阅后执行更新,选中配置,再点击连接并确认系统的 VPN 授权提示。若切到后台后连接经常中断,检查电池优化与后台运行限制。连接建立但部分应用仍失败时,再查应用分流设置;排查期间避免同时运行其他占用 VPN 接口的工具。

前往下载 Android 客户端 →

Linux

v2rayN

按发行版的软件包体系选择 deb 或 rpm,再核对 x64 与 arm64 架构。软件包格式与处理器架构是两个独立条件,不能只看其中一个。安装后从桌面应用入口启动,先完成普通代理验证,再处理 TUN 权限与系统服务相关设置。

桌面环境的系统代理设置未必会被所有程序读取。浏览器可以连接而其他应用失败时,先查应用自己的代理选项。启用 TUN 后若出现解析异常,检查系统 DNS 管理方式与其他虚拟网络接口;不要同时在多个设置入口反复更换 DNS,以免失去可复现的测试条件。

前往下载 Linux 客户端 →

PROJECT V / V2FLY / XRAY

开源生态与内核边界

客户端名称、协议名称与内核名称分别描述不同层次。理解它们的关系,可以减少选型时的误判,也能解释为什么同一条配置在不同客户端中可能得到不同结果。

Project V:配置模型与工具生态

Project V 是围绕网络代理工具形成的项目生态,V2Ray 是其中的重要组成。入站接收本地流量,出站负责连接目标或远端服务,路由规则在两者之间选择路径。常见的订阅管理与图形客户端,是在这类配置能力之上提供更易操作的界面,而不是另一套与内核无关的连接原理。

因此,导入订阅、选择节点和开启系统代理并不是同一个动作。订阅解决配置来源,活动节点决定使用哪份远端参数,系统代理或 TUN 决定流量入口。排查时按这条链路逐层检查,比把所有异常统称为「客户端连不上」更具体。

V2Fly 与 Xray:共同来源,不同演进

V2Fly 社区延续 V2Ray 的开发与维护,Xray 则从相关代码基础分叉并沿自己的方向演进。两者共享部分概念与协议背景,但配置字段、传输支持和特性进度不能简单互换。VLESS、XTLS Vision、REALITY 等配置要求,应核对所用内核的具体支持,而不是只看界面是否提供相似输入框。

需要迁移配置时,先确定原内核,再检查目标内核接受的字段。未知字段报错属于配置兼容性问题;连接超时则可能发生在网络、远端服务或握手阶段。两类错误不宜用同一种修复办法,也不能仅凭内核名称判断连接质量。

三款客户端:图形界面与开源许可

v2rayN、v2rayNG 与 v2flyNG 均以开源项目形式维护,分别提供桌面与 Android 的图形配置入口。v2rayN 提供多内核管理能力;v2rayNG 以 Xray 内核为基础;v2flyNG 对应 V2Fly 内核。选择客户端时,先看平台和配置需求,再看是否需要特定界面或内核特性。

开源许可规定代码使用与再分发条件,不等于所有相关组件都采用同一份许可。V2Fly 的主要代码采用 MIT 许可,Xray 的主要代码采用 MPL 2.0,客户端及其依赖也有各自的许可说明。普通使用关注功能兼容性;涉及修改、打包或再分发时,应分别阅读相关许可文本。

更新机制:界面、内核与规则分开看

客户端更新可能改变菜单布局和配置生成方式,内核更新可能调整字段支持,路由数据更新则影响域名或地址分类。出现变化时,先记录改动的是哪一层,再决定是否需要迁移设置。不要把升级客户端当作处理全部连接故障的固定步骤。

更新前保留自己的配置记录,更新后先用原本可用的节点和同一个目标复测。若只有某个协议组合失败,查内核启动与握手日志;若只有部分目标走错出口,查路由规则及其顺序。分享日志时只保留诊断所需信息,遮住订阅地址与身份字段。本站提供独立的中文操作说明,不替代上游项目的许可和功能文档。

查看项目介绍 →

CONFIGURATION NOTES

配置详解与故障排查

从日志中的具体错误继续阅读。内核无法启动,先看端口与字段;内核正常但连接失败,再看握手与证书;需要理解配置之间的关系,则从入站、出站和路由结构开始。每次只改动一个条件,保留修改前后的结果。