客户端入口 / 安装与配置

V2Ray教程站v2rayN 下载与配置

按系统选择开源客户端,从订阅导入到路由分流,对照菜单完成配置。

协议与传输
  • VMess
  • VLESS
  • Trojan
  • REALITY

界面示意:订阅分组负责管理地址,路由规则负责选择出站。装置中的组件叠放用于说明设置关系,并非客户端的拖放操作。

设置面板对照

订阅、路由与代理模式

先让客户端取得服务器配置,再决定应用流量如何进入客户端、由哪个出站发送。订阅更新成功只代表配置已经获取,不代表系统代理已经开启;切换代理模式也不会修复过期的订阅地址。下面四项分别对应配置来源、匹配规则、应用入口与虚拟网卡,排查时按层检查,不必一次改动所有设置。

订阅地址与服务器列表分开管理

在 v2rayN 的“订阅分组设置”中新增分组,填写便于识别的别名,再粘贴完整地址。保存后执行“更新订阅”,确认列表中出现服务器,再选中需要使用的一项。自动更新间隔以分钟计,设置前先确认手动更新能够完成。订阅地址用于获取配置,单条分享链接用于导入一个配置,两者不要混填。与逐条手工录入相比,分组更新适合持续同步服务器变动,但更新不会替代连接测试,也不会自动修正服务端参数。

查看教程 →

按平台选择

客户端下载入口

桌面端选择 v2rayN,安卓端优先了解 v2rayNG,已有 V2Fly 配置需求时再对照 v2flyNG。进入下载页后,先核对处理器架构和安装包格式,再阅读对应平台说明。客户端安装完成后仍需有效的订阅或服务器配置;安装包本身不包含可直接使用的远程服务。

Windows

v2rayN 首推

适合使用桌面图形界面管理订阅、切换服务器与配置路由。下载页提供桌面版和经典 WPF 版入口:桌面版采用跨平台界面,WPF 版保留经典桌面交互。选择时以系统要求、运行环境和已有使用习惯为依据,不要把两种界面的设置路径混在一起。

首次启动先查看日志是否有依赖缺失或端口占用提示,再导入订阅。配置文件应放在可正常写入的位置;升级前退出客户端并备份已有配置。退出后浏览器仍提示代理连接失败时,检查系统代理是否还指向已经停止监听的本地端口,而不是立即删除全部服务器。

macOS

v2rayN

适合在桌面上统一管理订阅分组与代理设置。先打开“关于本机”查看芯片信息:Apple 芯片对应 Apple Silicon 入口,Intel 处理器对应 Intel 入口。两类安装包面向不同架构,不应仅凭文件大小选择,也不应直接套用其他系统的安装步骤。

安装后先完成普通代理连接验证,再考虑 TUN。系统代理是否生效,还取决于当前网络服务和应用自己的设置;终端程序也不一定自动读取桌面代理。遇到系统安全提示时,按安装章节确认来源与处理方式,不要通过随意关闭整套系统保护来绕过问题。切换网络后,重新检查 DNS 与代理入口。

Android

v2rayNG 首推

v2rayNG 使用 Xray 内核,v2flyNG 使用 V2Fly 内核,下载页按此顺序列出两个客户端。多数近年的手机可选择 arm64 包;设备架构不明确时,先查看系统信息,再判断是否使用通用版。协议和传输能力要与服务端参数对应,不能仅凭客户端名称相近就认为配置完全通用。

导入订阅后执行更新,选中服务器,再启动连接并确认系统 VPN 授权。若切到后台后连接中断,检查电池优化和后台活动限制;若仅部分应用未经过代理,检查分应用代理设置。系统通常只允许一个活动的 VPN 服务,同时开启其他同类工具可能替换当前连接,应先保留一个客户端测试。

Linux

v2rayN

适合在有图形桌面的发行版上管理订阅与路由。按发行版选择 deb 或 rpm,再核对 x64 与 arm64 架构。包格式描述安装方式,处理器架构描述可运行的硬件,两项必须同时匹配。桌面环境、系统组件和权限策略存在差异,安装成功并不代表系统代理一定会自动被所有程序读取。

先确认客户端能够启动内核、本地监听端口可用,再从浏览器验证连接。终端程序、沙箱应用与桌面程序可能使用不同代理来源,需要分别检查。启用 TUN 前阅读权限说明,避免与现有虚拟网卡规则叠加。若更新后出现异常,记录发行版、桌面环境与日志错误,按平台章节逐项回退最近的改动。

同一订阅可以包含不同协议的配置。能否使用取决于客户端实际调用的内核及其能力,不取决于安装包名称。更换设备后,重新确认系统权限、代理入口与本地端口;这些本机设置不会因为导入了同一条订阅就自动保持一致。

查看全部客户端 →

开源生态与配置边界

Project V、V2Fly 与 Xray

图形客户端、代理内核和远程服务器是三个不同层次。客户端提供菜单和配置管理,内核负责协议处理与流量转发,服务器提供远程连接端点。区分这三层,才能判断问题发生在安装、参数兼容、应用接管还是远程连接阶段。

项目关系:共同历史,分别演进

Project V 围绕网络通信工具形成项目体系,V2Ray 是其中的核心项目。V2Fly 延续社区对 V2Ray 的维护与开发;Xray 从 V2Ray 发展而来,随后形成独立的功能演进路线。日常所说的“V2Ray 客户端”常常泛指这一生态里的图形工具,并不意味着它们都使用同一个内核,或者具有完全相同的配置字段。

阅读教程时,先识别客户端名称,再确认正在使用的内核。服务端要求某种协议、传输方式或安全设置时,应对照实际支持情况填写。尤其是涉及 VLESS 与 REALITY 的配置,应先确认内核能力和服务端参数,不能靠随意更换字段名称实现兼容。订阅导入只是把参数交给客户端解析,最终仍需要内核支持这些参数。

三款客户端:界面管理与内核执行分工

v2rayN 是面向桌面平台的开源图形客户端,提供服务器管理、订阅更新、路由与代理设置。其可用内核及具体功能取决于安装包和当前配置。v2rayNG 是面向安卓设备的开源客户端,使用 Xray 内核;v2flyNG 同样面向安卓设备,使用 V2Fly 内核,适合已有相应配置需求的使用场景。选择顺序应由设备平台和参数兼容性决定。

这三款工具都不是订阅服务本身。客户端下载、订阅地址获取、远程服务可用性属于不同事项;更换客户端不会自动延长订阅有效期,也不会改变服务端的流量或连接限制。若订阅更新后没有服务器,先检查分组地址和更新结果;若列表存在但连接失败,再检查选中的配置、协议参数与日志。把问题限定到一层,比重复导入相同地址更有效。

开源协议:分别理解界面与内核

开源意味着代码在相应许可证下开放,使用、修改和分发仍应遵守项目的许可证条款。V2Fly 的 V2Ray 内核采用 MIT 许可证,Xray-core 采用 MPL-2.0;客户端有各自的许可说明,不能直接用内核许可证概括整个安装包及其依赖。对于需要二次分发或修改的场景,应分别阅读客户端、内核与附带组件的授权要求。

社区维护让问题修复和功能演进能够持续进行,但开源属性不替代实际配置检查。订阅地址通常带有访问凭据,分享截图前应遮盖完整地址、用户标识和其他敏感参数。排查问题时优先提供菜单位置、错误类型和已做过的操作,不要把整份含凭据的配置直接发布。站内示意地址仅用于解释字段格式,不能作为实际服务使用。

更新机制:订阅、客户端与规则数据分别处理

更新订阅会重新获取服务器配置;更新客户端会改变图形界面及随包提供的组件;更新路由数据则会影响域名集合或地址集合的匹配。这三种操作处理的对象不同。连接异常时不要把它们同时执行,否则很难确定是远程配置变化、内核行为变化,还是分流结果变化。先保留现有配置并记录错误,再选择与问题对应的更新动作。

升级客户端前,确认退出正在运行的实例,并备份订阅分组和自定义路由。升级后先验证原先能够使用的服务器,再测试新增功能。自动更新订阅的间隔应符合实际使用频率和服务方要求,频繁请求不一定能提高可用性,还可能触发请求限制。若订阅地址已经失效,调整间隔也无法修复,应先处理地址本身。

连接验证:区分测试结果与应用行为

服务器测试有结果,并不等于每个应用都已经经过代理。先用浏览器验证目标访问,再查看客户端日志中是否出现对应连接,最后确认路由选择是否符合预期。真连接测试、TCPing 与实际网页加载关注的环节不同,不应只凭一个测试数字判断整条链路。网络切换、DNS 缓存与目标站点状态也可能影响结果。

如果只有一个应用失败,优先检查应用自己的代理选项和接管范围;如果所有应用都失败,检查内核是否启动、服务器是否选中、本地端口是否监听。需要全局代理时,也要区分“让应用进入代理”和“把已进入的连接交给代理出站”。前者通常由系统代理或 TUN 决定,后者由路由规则决定。具体操作顺序可对照入门指南,平台权限差异则查阅使用文档。

配置专题

订阅导入与首次安装

按遇到的问题继续阅读。还没有服务器列表,先看订阅导入;客户端不能正常启动,先看首次安装;已经能够连接,再了解节点测试与选择。每次保留一个明确的检查目标,避免同时切换服务器、代理模式和路由规则。