客户端下载与配置文档

V2Ray官方网站 · v2rayN
客户端下载与全平台配置

从客户端选择到订阅导入,按步骤完成路由与代理配置。

  • VMess
  • VLESS
  • Trojan
  • REALITY

订阅导入与分组管理

订阅把一组连接配置集中在一个更新入口。v2rayN 可在订阅分组中填写地址,再更新对应分组;v2rayNG 可通过订阅分组设置完成同类操作。相比逐条录入,分组更适合区分不同来源,也便于单独更新和定位异常。首次导入后先确认列表出现配置,再选择一条作为活动配置。更新订阅只刷新配置内容,不等于开启系统代理。地址中可能含访问凭据,分享截图前应遮挡完整链接,转换订阅时也要先确认接收方的可信程度。

查看教程 →
订阅分组订阅分组设置
备注个人订阅
地址填写订阅提供方给出的完整地址
更新订阅按分组更新

按平台选择客户端

先确认系统与处理器架构,再选择对应安装包。下载页集中列出各平台入口与安装要求。

查看全部客户端 →

Windows

v2rayN 首推

桌面版与经典 WPF 版

Windows 电脑可选择 v2rayN。桌面版采用跨平台界面,WPF 版保留经典桌面界面;两者的菜单位置与设置组织可能不同,跟随教程时应先确认所用界面。日常使用通常从订阅管理、活动配置、系统代理三个入口开始,不必一次调整全部参数。

下载前在系统设置中查看设备架构与系统信息,再核对下载页中的运行要求。安装后先保持默认监听设置,导入已有配置并测试浏览器访问。若启用 TUN 时出现权限提示,应按安装说明处理;普通系统代理可用而某个应用仍无法访问时,先确认该应用是否读取系统代理,不要直接归因于订阅失效。

macOS

v2rayN

Apple Silicon 与 Intel 双架构入口

Mac 用户可通过 v2rayN 管理订阅与路由。下载前打开“关于本机”,查看显示的是 Apple 芯片还是 Intel 处理器,再选择对应安装包。架构选择依据硬件信息,而不是电脑外观或购买年份;选对架构有助于减少运行环境带来的兼容问题。

完成安装后,从应用程序目录启动客户端,并按系统提示处理所需权限。遇到系统安全提示时,先确认文件来源与应用信息,不建议直接关闭整个系统的安全保护。第一次连接仍建议从系统代理开始,确认配置可以使用后再考虑 TUN。若退出应用后浏览器无法联网,检查网络设置中的代理是否仍指向已经停止的本地监听端口。

Android

v2rayNG 首推

v2rayNG · Xray / v2flyNG · V2Fly

安卓设备首选 v2rayNG,需要 V2Fly 内核配置时可考虑 v2flyNG。多数较新的主流手机使用 arm64;如果无法确认设备支持的架构,可先阅读下载页说明,再判断是否需要通用安装包。安装包架构决定能否正常安装运行,内核家族则影响协议与参数的兼容范围。

首次开启连接时,系统可能请求建立 VPN 连接的许可,应核对发起请求的应用后确认。连接后保留必要的后台运行权限,避免省电策略在锁屏时终止服务。若正在使用另一项占用系统 VPN 通道的服务,需要先处理冲突。配置导入成功并不代表网络已接管,还应检查客户端连接状态、系统提示与实际应用访问结果。

Linux

v2rayN

deb / rpm,按发行版与架构选择

Linux 桌面可使用 v2rayN 图形客户端。选择安装包时需要同时考虑发行版的软件包格式和设备架构:deb 与 rpm 不能只按文件大小选择,x64 与 arm64 也不能混用。先在系统信息中查看发行版与处理器信息,再通过下载页找到对应入口。

安装后使用桌面应用菜单启动,先确认窗口可以正常打开,再导入订阅。不同桌面环境对系统代理设置的支持存在差异,部分应用还需要在自身设置中指定代理。TUN 涉及虚拟网卡、权限与路由,首次配置应按平台章节逐步检查。若本机同时运行其他网络服务,先确认监听端口未被占用,并保留原有网络设置,便于出现问题时恢复。

首次连接的三个步骤

先把基础链路跑通,再细调 DNS、分流与应用接管范围。

查看完整教程 →
  1. 导入订阅,确认配置来源

    准备完整的订阅地址,在客户端的订阅分组设置中新增一个分组,填写便于辨认的备注后保存,再执行更新。若拿到的是单条分享链接,应使用对应的导入入口,不要把它当作订阅地址填写。更新完成后检查列表是否出现配置;出现空列表、格式错误或请求失败时,先核对地址是否完整、是否过期,以及当前网络能否访问订阅服务。

    订阅地址可能允许他人读取连接配置,应按敏感信息保存。排查问题时只提供必要的报错文字,不公开完整地址、身份字段或连接凭据。需要转换格式时,优先确认客户端是否已经能够直接识别,避免不必要地把订阅交给额外服务。详细步骤见订阅导入教程。

  2. 选择配置,设置接管方式

    从列表中选定一条活动配置,然后选择合适的系统代理或连接模式。桌面端可先使用自动配置系统代理,让遵循系统设置的浏览器发起请求;安卓端则按客户端提示启动连接并确认系统授权。此时先采用现成路由方案,暂缓修改监听地址、DNS 与复杂规则,减少同时变化的条件。

    系统代理与路由负责不同环节:前者决定应用如何把请求交给客户端,后者决定收到请求后使用哪个出站。即使选择全局路由,不读取系统代理的应用也不一定会被接管。确有覆盖更多应用的需求时,再参照系统代理与 TUN 说明逐项启用,并检查是否与其他网络工具冲突。

  3. 验证访问,再调整路由

    打开目标站点,同时测试一个预期直连的站点与一个局域网资源,确认代理访问、直连访问和本地网络都符合预期。客户端启动成功只代表服务已经运行;列表中的测试结果也不能替代真实应用访问。必要时查看日志中与本次请求相关的错误,区分解析失败、连接超时、认证异常或规则命中不符。

    基础连接可用后,再逐项修改路由或 DNS,每次只改一个条件并重新验证。需要撤销调整时恢复上一组设置,而不是同时重置所有选项。结束使用前正常停止连接,确认系统网络设置恢复;如果只有某个应用出现问题,先检查它自身的代理设置。分流操作可继续阅读路由规则入门,平台权限问题则查阅全平台安装配置大全。

Project V 生态与内核区别

理解客户端与内核的分工,可以减少选型和迁移时的误解。图形界面负责保存订阅、选择配置、组织设置与展示日志;内核读取生成的配置,处理协议、传输、路由和连接。界面中的一个开关是否生效,既取决于客户端如何生成参数,也取决于内核是否支持这些参数。因此,不能仅凭应用名称或同一个协议标签判断所有功能都一致。

Project V、V2Fly 与 Xray 的关系

Project V 是围绕 V2Ray 形成的开源代理工具生态。V2Fly 延续并发展相关核心实现,Xray 则是在这一技术背景下形成的另一条内核分支。它们共享部分概念与配置习惯,但功能演进、参数支持和具体行为并不完全相同。讨论“V2Ray 内核区别”时,应明确是在比较哪一种核心实现,而不是把所有相关图形客户端都归为同一个程序。

VMess、VLESS、Trojan 是连接协议相关名称,REALITY 属于安全层相关技术,不能把它们当作同一层级、可以任意替换的选项。完整连接还可能包含传输方式、域名、端口及身份字段等参数。客户端能识别分享链接,只能说明格式被解析;是否能够连接,还要看内核支持、服务端设置与当前网络条件是否匹配。对协议做调整前,应先取得准确参数。

三款开源客户端的职责

v2rayN 面向桌面使用,适合集中管理订阅、切换配置并调整路由。v2rayNG 面向安卓设备,使用 Xray 内核;v2flyNG 同样面向安卓设备,以 V2Fly 内核作为连接基础。三者均属于开源客户端,具体功能应以各自的安装包和界面说明为准。选择时先看设备平台,再看配置要求,不必为了名称相近而在多个应用间反复迁移。

桌面端与移动端的系统接管方式不同,同一份订阅在两端导入后,系统权限、后台运行策略和 DNS 行为仍可能不同。例如,电脑上的应用可能读取系统代理,而安卓设备通常需要由客户端发起系统 VPN 连接。迁移配置时可以复用合法持有的订阅,但不应假定另一台设备会自动继承路由模式、权限授权与后台设置。

开源协议与组件边界

代码开源意味着相关代码可以按所采用的许可证条件阅读、使用和再分发,并不表示所有组件都采用相同许可。图形客户端、内核和随包分发的组件可能各自附带许可证说明。个人使用之外,如果计划修改程序、重新打包或分发,应分别查看适用条款,保留要求保留的版权与许可信息。开源属性也不替代对订阅来源、配置内容和系统权限的判断。

客户端下载与远程服务同样是两个边界。客户端提供本地管理和连接能力,远程服务的可用性、权限与访问条件由相应服务决定。安装成功后没有配置,或已有订阅无法更新,都不能仅由客户端是否免费推断原因。本站内容围绕工具安装与配置展开,实际使用时仍应遵守所在地适用的法律法规、网络管理要求与服务条款。

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

社区维护会带来界面调整、兼容性修复与功能变化。客户端升级、内核更新、订阅刷新和规则数据更新是不同操作:订阅刷新改变连接配置,规则数据更新影响分类匹配,内核更新可能改变参数支持,客户端升级则可能调整界面或配置生成方式。遇到问题时先记录刚刚发生的是哪一种变化,再决定是否需要恢复旧设置或重新导入。

更新前保留必要配置,并妥善保护备份中的敏感信息;更新后依次验证启动、订阅读取、实际连接与路由行为。不要只检查窗口能否打开。若教程中的菜单与当前界面不完全一致,可按“订阅管理”“系统代理”“路由设置”等功能名称寻找对应入口。需要完整的平台操作路径时,阅读安装大全;需要判断三款应用的适用范围时,查看客户端对比。

配置专题与故障排查

基础连接完成后,按具体问题阅读专题。每次调整一个环节,保留可复现的测试结果。

查看全部文章 →