V2Ray 客户端下载 · 订阅 · 连接配置

v2rayN 客户端下载与 V2Ray 配置教程

按设备选择客户端,完成订阅导入、系统代理与 TUN,再用真连接测速验证配置。

代码开源订阅分组路由分流

配置主题

订阅、代理与路由

打开使用文档 →

订阅导入 →

把服务提供方给出的订阅地址保存到分组,再执行更新。订阅是获取配置的入口,不等于客户端本身;安装完成后仍需准备可用的连接资料。

代理模式 →

先用系统代理验证浏览器访问,再判断是否需要 TUN。接管方式决定哪些应用流量进入客户端,路由规则则决定进入后的流量走向。

连接验证 →

先测连接能否建立,再检查目标网页和出口地址。单次延迟不能代表下载速度,也不能替代对 DNS、规则命中与实际访问结果的检查。

从一条订阅,整理到一套可用配置

订阅分组设置

多个来源的服务器放在同一列表里,容易混淆更新范围。先在“订阅分组设置”中填写易辨认的备注,粘贴完整订阅地址,保存后执行更新。v2rayN 可按分组筛选服务器,v2rayNG 也可通过订阅分组管理入口维护来源。与逐条粘贴连接链接相比,订阅更适合批量刷新,但更新结果取决于服务方返回的内容。若列表为空,先核对地址、有效期与网络,不要反复重装客户端。订阅地址通常包含访问凭据,截图或求助时应遮住完整地址。

订阅分组与过滤实践 →

订阅分组设置

备注日常订阅
订阅地址示例https://example.com/sub?token=xxxx
启用更新 · 已开启

设置示意,需在客户端内操作。

安装包入口

按系统选择客户端

查看全部客户端 →

桌面设备优先选择 v2rayN;安卓设备优先选择 v2rayNG,需要 V2Fly 内核时再考虑 v2flyNG。安装包要同时匹配操作系统、处理器架构与打包格式,不能只凭文件名中的客户端名称判断。下面的入口会打开下载页并定位对应平台,具体安装要求也在该页集中说明。

客户端负责读取连接配置,不附带可用的订阅服务。安装前准备好服务提供方交付的订阅地址或连接链接,并确认设备时间准确、网络可以正常访问。已有其他代理工具时,先停止其代理接管,避免端口和系统网络设置互相影响。

Windows

v2rayN · 首推

下载页提供桌面版与经典 WPF 版两个入口。桌面版采用新一代跨平台界面,WPF 版保留经典操作布局;选择时结合系统要求和既有使用习惯,不必为了尝试界面而同时运行两套代理。

首次安装应放在有写入权限、便于长期保留的目录,按包内说明启动。先导入订阅,确认内核能正常运行,再开启系统代理。需要 TUN 时,再核对权限与虚拟网卡状态;不要把管理员权限当作所有连接问题的通用解法。

前往下载 →

macOS

v2rayN · 桌面客户端

先在系统的“关于本机”中查看芯片信息,再选择 Apple Silicon 或 Intel 安装包。架构匹配能减少兼容层带来的不确定性;不要把两种安装包理解为功能等级不同,它们首先对应不同的处理器平台。

将应用安装到常用应用目录,首次打开遇到系统提示时,按系统安全设置核对应用来源与允许选项,不要直接关闭整套安全机制。连接前检查已有的网络代理配置,连接后再验证浏览器访问。涉及 TUN 的步骤,以客户端提示和当前系统授权要求为准。

前往下载 →

Android

v2rayNG · 首推

优先使用基于 Xray 内核的 v2rayNG,V2Fly 内核需求可选择 v2flyNG。近年的主流手机通常适合 arm64 包;无法确认设备架构时,可在下载页查看通用包说明,再结合设备信息选择。

安装时仅对当前可信来源授予必要权限。添加订阅分组、更新配置并选中服务器后,点击连接并确认系统 VPN 授权。同一时间通常只能由一个应用接管该通道;若后台断开,应检查省电策略与后台运行限制,而不是不断重复导入同一份订阅。

前往下载 →

Linux

v2rayN · 桌面客户端

按发行版的软件包体系选择 deb 或 rpm,并核对 x64、arm64 架构。deb 常用于 Debian、Ubuntu 等发行版,rpm 常用于 Fedora 等发行版;衍生发行版仍需查看自身的软件包与依赖说明。

安装后先在桌面会话中验证客户端启动和本地监听,再检查浏览器是否遵循桌面环境的系统代理设置。不同应用读取代理的方式可能不同,因此浏览器可访问不代表所有进程都已接管。需要 TUN 时再处理额外权限与路由,避免直接以高权限长期运行所有桌面操作。

前往下载 →

快速上手预览

从导入到首次连接

查看完整教程 →

每次只改变一个环节。先让配置进入客户端,再确定接管范围,最后验证实际请求;这样即使出现异常,也能知道应该回到哪一步检查。

  1. 添加订阅并更新配置

    在 v2rayN 中打开订阅分组设置,为来源填写备注,完整粘贴订阅地址后保存,再执行更新订阅;在 v2rayNG 中从订阅分组入口完成相同准备。复制时注意首尾空格、缺失参数和换行,网页上的登录地址通常不能直接当作订阅地址使用。

    更新后先确认当前分组确实出现了服务器。列表为空时,查看更新提示,核对服务是否有效、网络是否能访问订阅入口。已有配置不要急着全部删除,可先备份原设置,再单独验证新分组,避免排查时失去原本可用的参照。

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

    对准备使用的服务器进行真连接测试,再设为活动服务器。桌面端先选择自动配置系统代理,并使用默认或内置的路由方案完成基础验证;安卓端选中配置后点击连接,阅读并确认系统 VPN 授权提示。界面的连接状态只说明接管流程已经启动,仍需下一步的实际访问测试。

    系统代理、TUN 与路由不是同一组开关。前两者解决流量如何进入客户端,路由决定进入后的出口。普通浏览器访问正常以后,再按应用需求开启 TUN 或增加规则。若设备上还有其他代理、网络加速或 VPN 工具,应先暂停它们的接管功能。

  3. 验证访问并记录基线

    打开一个明确需要通过代理访问的目标,检查页面能否完整加载,再用可信的出口地址查询服务确认请求路径。测试前注意浏览器缓存和独立代理扩展,必要时使用新的浏览器会话。真连接测试成功而网页失败时,优先比较两者的目标、DNS 与路由,而不是只更换服务器。

    确认可用后,记下活动分组、代理方式和路由选择,作为后续调整的基线。故障发生时先恢复这套组合,再检查订阅是否过期、本地端口是否冲突和系统时间是否准确。求助时可以提供经过遮挡的错误提示与操作步骤,不公开订阅地址和连接凭据。

连接前的设置核对

订阅分组已添加并更新
活动服务器手动选择
系统代理自动配置
路由方案绕过大陆
启用 Tun 模式 · 已关闭

静态界面示意。网页中的设置不会改变设备网络,请在客户端内操作。

连接失败时,先看哪一层?

订阅更新失败,先看地址与访问条件;列表存在但连接失败,先看服务器参数与内核日志;只有某个应用失败,先看接管范围与路由。把问题缩小到一层,再决定是否调整设置。

按现象查找常见问题 →

开源生态与维护

客户端与内核的分工

查看术语手册 →

V2Ray 不是一款固定界面的软件名称。Project V 生态围绕代理协议、传输方式与路由能力发展,图形客户端把这些能力组织成订阅、服务器、代理模式与日志等可操作的入口。理解这层分工,比记住某个按钮的位置更有用。

Project VV2FlyXray

本站整理三款客户端的安装入口与中文配置说明。客户端软件、内核项目和提供订阅的服务方各有职责:客户端不会自动生成可用的服务,内核能够识别协议也不代表服务端配置一定正确,订阅是否有效仍由服务提供方决定。

Project V、V2Fly 与 Xray

Project V 提供理解 V2Ray 体系的背景。V2Fly 持续维护 V2Ray 相关项目,Xray 则是从相关技术体系发展出的另一条内核路线。两者存在共同概念,但功能演进、协议支持与配置细节并不完全相同。教程中看到的协议名、传输类型和安全选项,最终都需要所用内核支持。

因此,遇到导入成功却无法运行的配置,应核对协议与内核能力,而不是只看客户端能否显示该条目。服务方给出的配置说明、客户端当前内核选项和错误日志,应放在一起判断。术语相近不等于参数可以直接互换。

三款开源客户端的选择

v2rayN 是面向桌面系统的开源图形客户端,适合集中管理订阅、系统代理与路由。v2rayNG 面向安卓,采用 Xray 内核,适合移动设备上的配置导入和连接管理。v2flyNG 同样面向安卓,为需要 V2Fly 内核的用户提供另一种选择。三者都是客户端,不是订阅服务的销售入口。

选择时先看设备平台,再看服务方使用的协议和传输配置。没有明确兼容需求时,桌面优先使用 v2rayN,安卓优先使用 v2rayNG;已有稳定环境则先保留设置,不必为了名称差异反复迁移。不同客户端的界面与导出格式可能不同,迁移前先确认订阅可以重新导入。

开源协议与配置隐私

开源意味着软件源代码按各项目的许可条款提供,使用、修改和再分发需要遵循对应协议;客户端与内核是不同项目,不能把其中一个项目的许可简单套用到整个组合。开源属性也不能替代对安装来源、系统权限和连接配置的审慎判断。

订阅地址、连接链接和导出的配置文件可能带有访问凭据。分享问题截图时,应遮住完整地址、账户标识和认证内容;公开日志前,也要检查是否包含这些信息。备份文件应保存在受控位置,替换设备或转交旧设备前,清理已经保存的配置与自动更新任务。

客户端更新与订阅更新

客户端更新改变程序界面、兼容能力或内核组合;订阅更新则从服务方重新获取服务器配置。这两个操作解决的问题不同。服务器过期通常需要检查订阅状态,协议选项不受支持则可能涉及客户端或内核能力,不能把每次连接失败都归结为程序需要升级。

计划更新前,先保存订阅分组、路由与必要的自定义设置,阅读安装要求和变更说明。更新后先用原来的可用配置验证,再逐项恢复额外设置。如果只在某一应用中异常,保留其他已验证条件,检查该应用的代理方式。稳定、可复现的操作记录,比同时调整多项参数更便于定位问题。

技术笔记

安装、测速与分流实践

查看全部文章 →

基础连接可用后,再按目标阅读专项笔记。首次安装关注运行环境和初始设置;连接选择关注真连接测试与实际访问;需要自定义流量走向时,再深入域名、IP 与规则顺序。每篇笔记围绕一个操作问题展开,便于对照当前配置逐项验证。