客户端下载与配置

v2rayNG官网客户端下载

桌面选 v2rayN,安卓选 v2rayNG;从订阅导入到路由分流,按设置项逐步配置。

永久免费 代码开源 中文文档
内核与客户端
Xray · V2Fly
  • v2rayN 桌面
  • v2rayNG Xray
  • v2flyNG V2Fly

图形界面负责管理配置,内核负责连接与规则执行。协议支持取决于实际内核。

开源许可
GPL-3.0

三款客户端均为开源项目;内核及依赖另有各自许可。

协议与安全传输
VMessVLESSTrojanREALITY

按服务端参数导入,不凭名称修改协议。

配置功能

订阅、代理与路由设置

先区分三个环节:订阅提供连接参数,代理模式决定哪些应用进入客户端,路由决定进入后的请求走向。连接异常时按这个顺序检查,比同时改动多个开关更容易定位原因。下面的切片用于解释设置,不代表正在运行的连接。

订阅分组与节点更新

订阅地址用于获取一组连接配置,不等同于节点分享链接。在 v2rayN 中打开订阅分组设置,填写名称与地址,保存后执行更新订阅;v2rayNG 则在侧滑菜单中管理订阅分组。客户端通常只保存地址,不会在保存时自动取得全部节点。首次导入后应确认更新结果,再选择节点测试连接。与逐条手动录入相比,分组便于区分来源,也便于后续刷新配置;更新不会替代服务端账号或套餐的有效性检查。

  • 订阅地址与单节点链接使用不同导入入口。
  • 先保存分组,再执行更新,最后选择节点。
  • 地址可能含访问凭据,不放入公开截图或日志。
v2rayN / 订阅分组设置
别名自定义分组名称
可选地址(Url)粘贴订阅地址
保存后更新订阅
列表为空时检查更新日志
按设备选择

四平台客户端下载

先确认操作系统,再确认处理器架构。桌面端使用 v2rayN,安卓端优先查看 v2rayNG,需要 V2Fly 内核时再考虑 v2flyNG。安装包格式与节点协议是两件事:前者决定能否在设备上运行,后者决定客户端能否使用服务端提供的连接配置。

Windows

v2rayN 首推

提供 Desktop 桌面版与经典 WPF 版入口。Desktop 使用新一代跨平台界面,WPF 保留经典桌面交互;应结合系统要求与使用习惯选择,不必同时安装两版。首次运行遇到依赖提示时,按对应发行说明处理运行库,不要把缺少运行环境误判为节点问题。

解压或安装后先确认主窗口能正常打开,再导入订阅。开启系统代理后,用浏览器进行访问验证;如需让特定应用单独走代理,可在应用内填写客户端显示的本地监听地址与端口。

macOS

v2rayN

按芯片选择 Apple Silicon 或 Intel 安装入口,可在“关于本机”中确认。处理器架构与系统版本都需要符合发行要求。首次启动若出现系统安全提示,应确认文件来源并按系统提供的安全设置处理,不建议为了运行客户端长期降低整体安全设置。

系统代理与 TUN 的授权方式不同,先使用基础代理设置完成连接。切换网络或从休眠恢复后,如果只有部分应用无法访问,先检查代理入口与 DNS 状态,再决定是否重新启动服务。

Android

v2rayNG 首推

v2rayNG 使用 Xray 内核,v2flyNG 是 V2Fly 内核备选。较新的主流设备通常选择 arm64,无法确定设备架构时可查看通用包说明;通用包主要解决安装架构适配,不表示它比专用包连接更快。两款应用各自保存配置,切换客户端后应重新确认订阅和路由。

首次启动连接时需要批准系统 VPN 请求。若后台连接容易中断,可检查电池优化与后台运行限制;若已有其他 VPN 类应用运行,先停止其连接,再启动当前客户端,避免系统接管权发生冲突。

Linux

v2rayN

按发行版的软件包体系选择 deb 或 rpm,再区分 x64 与 arm64。软件包扩展名并不代表所有发行版都能直接安装,仍需检查系统依赖和桌面环境。图形客户端适合管理订阅、节点与路由,不必先手动编写整份内核配置才能开始使用。

不同桌面环境对系统代理的读取方式可能不同,终端程序也不一定使用桌面代理设置。浏览器连接正常而终端不可用时,先检查程序自身的代理配置;只有确有流量接管需求时,再配置 TUN 和对应权限。

查看全部客户端 →下载页集中说明安装入口、架构选择与系统要求。

导入配置 → 确认入口 → 验证路由

首次配置顺序

三步完成基础连接

客户端负责使用已有连接配置,本身不提供可直接使用的远程服务。准备好有效的订阅地址或节点分享链接后,再开始下面的流程。参数必须来自可信来源;若只有服务器地址而缺少认证与传输设置,不能仅靠客户端自动补齐。

  1. 01 / 导入

    保存订阅并更新列表

    v2rayN 在订阅分组设置中保存地址,随后从订阅菜单执行更新;v2rayNG 在侧滑菜单中进入订阅分组设置,再返回列表更新订阅。单个分享链接应使用剪贴板导入或扫码入口,不要直接填进订阅地址栏。导入后先检查协议类型与传输参数是否完整,再选中一个节点作为当前连接。

    如果列表仍为空,先看更新日志,区分地址无法访问、返回内容不被识别以及订阅已经失效。重复新建同一分组通常不能解决这些问题。整理分组时保留清晰的来源说明,但不要把订阅地址复制到公开求助内容中。

  2. 02 / 接入

    选择代理方式并启动服务

    桌面端可先使用自动配置系统代理,让遵循系统设置的浏览器进入客户端;安卓端点击连接后,按系统提示批准 VPN 请求。此时先保留默认路由,不同时启用多套流量接管工具。若客户端显示启动错误,应先处理本地端口占用、权限或参数错误,再检查远端连接。

    “全局路由”与“系统代理”不是同一开关:前者决定进入客户端的流量如何出站,后者决定应用是否把请求交给客户端。只修改路由,无法让忽略系统代理的应用自动接入。了解这个区别后,再决定是否需要 TUN。

  3. 03 / 验证

    访问验证与退出恢复

    打开目标网站,观察页面能否加载,再检查客户端日志中的连接错误。延迟测试只是辅助信息,不等于网页、视频或特定应用一定可用。若浏览器正常而某个应用失败,先看该应用是否使用代理;若全部失败,再检查节点参数、系统时间、订阅状态和 DNS。

    完成基础验证后再逐项加入分流规则,每改一项都验证目标访问和局域网访问。停止使用时,桌面端检查系统代理是否已清除,安卓端确认 VPN 连接已停止。记录有效的设置组合,后续更换节点时就能减少重复排查。

查看完整教程 →操作菜单可能随发行形态调整,以实际界面为准。

开源项目与能力边界

Project V、V2Fly 与 Xray

客户端、内核、协议与订阅属于不同层次。下载客户端解决本地操作界面的问题,内核负责执行连接,协议定义通信方式,订阅则分发配置。理解这些关系,有助于判断更新该应用、调整规则,还是向配置提供方确认参数。

从 Project V 到内核家族

Project V 是围绕代理通信工具形成的开源生态,V2Ray 是其中广为使用的核心项目。V2Fly 延续 V2Ray 的社区开发;Xray 从相关代码基础发展出独立项目,并扩展了自己的协议与传输能力。两者有共同背景,但当前功能、配置细节与更新节奏并不完全一致,不能把其中一方的全部教程直接套用到另一方。

对日常使用而言,最重要的不是单独比较内核名称,而是核对节点所需能力。一个节点通常由协议、传输、安全层和认证参数共同组成。VMess、VLESS 是协议名称,REALITY 则是安全传输相关方案,不能把这些词当成同一层的可互换选项。配置中任一关键字段不匹配,都可能导致连接无法建立。

阅读配置的四个层次
图形客户端导入、选择、设置
执行内核连接、解析、路由
协议与传输通信方式与安全参数
订阅内容可更新的节点配置

三款客户端分别负责什么

v2rayN 面向桌面使用,通过图形界面管理服务器、订阅、系统代理和路由,并提供多内核配置能力。不同平台与发行形态的菜单位置可能有所差异,遇到界面不一致时,应先确认正在使用的是哪种桌面发行包。内核可选项也以实际安装内容为准,不能仅凭教程截图认定所有平台拥有完全相同的选项。

v2rayNG 面向安卓设备,使用 Xray 内核,并通过系统 VPN 接口接入流量。v2flyNG 则采用 V2Fly 内核,适合需要相应内核能力的配置。两者名称相近,但不是同一应用的皮肤,也不共享全部设置。若迁移订阅,应分别检查协议兼容、路由模式、应用分流以及系统授权,不能只确认节点名称相同就认为迁移完成。

开源许可与服务来源分开理解

三款客户端均以 GPL-3.0 许可开放源代码,内核及其他依赖遵循各自项目的许可。开源意味着源代码和许可条款可供查阅,并对使用、修改和分发作出约定;它不代表远程订阅服务由客户端项目提供,也不能替代对订阅来源的判断。客户端免费下载与远程服务是否收费,是两个独立问题。

订阅地址可能包含用于获取个人配置的访问凭据,节点配置也可能包含认证信息。备份时应将其视为敏感资料,只保存在可信位置。分享日志或截图前,检查订阅地址、服务器认证字段和二维码是否暴露;需要求助时优先提供错误类型、操作顺序和经过处理的参数结构,而不是整份原始配置。

客户端更新、订阅更新与规则更新

更新订阅通常只刷新服务方提供的节点参数,不会升级客户端程序。更新客户端可能改变界面、内核和配置生成方式,也不保证远程节点随之恢复。地理分类数据、路由规则和 DNS 设置又是另外的维护对象。遇到问题时应先确定变化发生在哪一层,再做对应操作,避免反复更新却没有触及真正原因。

升级前保留订阅来源、自定义路由和必要设置的备份。升级后先验证原先可用的基础连接,再逐步检查应用分流、局域网访问和 TUN 行为。如果某个新参数无法识别,应核对客户端与内核的支持情况;不要为了消除提示随意删掉安全相关字段,也不要将整份旧配置直接覆盖到不同内核而跳过检查。

从基础连接进入配置阅读

能够稳定导入和连接后,可以按入站、出站、路由的顺序阅读生成的配置。入站描述本地如何接收请求,出站描述如何连接目标或上游,路由通过标签把两者联系起来。首页窗口中的直连规则只有在对应出站和分类数据存在时才有意义,单独复制片段不能形成完整配置。

继续学习时,先在术语表区分协议、传输、内核与分流,再用客户端对比核对适用平台。需要系统整理配置顺序和日常维护时,阅读使用手册;具体连接异常则从帮助中心按现象逐项排查。保留一次有效配置,比在多个不相关的选项间反复切换更有参考价值。

配置与使用文章

协议选择与平台教程

下面三篇分别解释协议差异、桌面安装和节点选择。先掌握基础连接流程,再按实际问题阅读专题;节点名称中的地区或协议标注只能提供线索,具体行为仍需结合完整参数与实际连接结果判断。

查看全部文章 →