开源客户端下载与配置批注

V2Ray开源网·
v2rayN 客户端下载与配置

按设备选择客户端,逐项确认订阅导入、路由分流与DNS 设置。

永久免费代码开源中文配置指南
  • v2rayN · 订阅分组设置
    备注日常订阅
    地址https://example.com/sub?token=xxxx
    启用更新已启用
    过滤关键字香港|日本

    订阅分组

    分开管理地址、更新与服务器过滤。

  • v2rayN · 路由规则
    匹配条件出站
    geosite:category-ads-allblock
    geoip:privatedirect
    geosite:cndirect

    路由规则

    按域名与地址,为连接选择出站。

  • v2rayN · DNS 设置
    远程 DNShttps://1.1.1.1/dns-query
    直连 DNSlocalhost
    域名策略IPIfNonMatch

    DNS 设置

    同时核对解析服务器与请求路径。

  • v2rayN · TUN 模式
    启用 TUN已启用
    系统代理清除系统代理
    堆栈gvisor

    TUN 模式

    接管系统流量,先确认权限与网络栈。

平台与安装包

客户端下载入口

桌面设备优先选择 v2rayN,Android 设备优先查看 v2rayNG。先确认操作系统与处理器架构,再选择安装包;包格式决定安装方式,内核决定协议与传输支持,这两件事需要分别判断。

初次配置建议从普通系统代理开始。导入已有订阅,选中一条服务器记录,确认内核能够启动,再验证应用请求是否经过客户端。基础连接正常以后,再逐步调整规则和 DNS,避免同时修改多项设置后无法判断问题来源。

客户端下载和连接配置是两个独立环节。安装客户端不会自动生成可用的服务器记录;订阅地址、节点参数与授权信息需要由用户已有的服务配置提供。这里的示意地址只用于说明字段位置,不用于建立实际连接。

查看全部客户端 →

Windows · v2rayN

桌面版使用跨平台界面,经典 WPF 版保留熟悉的 Windows 操作布局。两者都围绕服务器列表、订阅分组和连接设置工作;选择时先看系统要求与使用习惯,不必为了界面差异重建一套订阅。

安装后先确认本地监听端口,再设置系统代理。若浏览器可以访问而某个应用仍不能连接,检查该应用是否读取系统代理,或是否有自己的代理选项。此时先定位流量入口,通常比反复更换节点更有帮助。

启用 TUN 前再检查管理员权限与其他网络工具。退出客户端后若系统网络行为没有恢复,应核对系统代理是否仍指向已经停止的本地端口。

前往下载

macOS · v2rayN

根据设备芯片选择 Apple Silicon 或 Intel 安装入口。可在系统的设备信息中查看芯片名称,前者对应 arm64,后者对应 x64。选对架构有助于减少兼容层带来的不确定性,也便于按照下载页说明排查启动问题。

客户端启动后,需要单独确认当前网络服务的代理设置。切换无线网络、使用扩展网卡或连接其他网络工具后,生效的网络服务可能变化;不能仅凭客户端按钮状态判断所有应用都已采用代理。

遇到系统安全提示时,先确认安装包来源与系统提示内容,按下载页的说明处理。不要为了启动一个程序而整体关闭系统安全机制。

前往下载

Android · v2rayNG

v2rayNG 使用 Xray 内核,适合常见的 Android 订阅导入与连接管理。v2flyNG 是采用 V2Fly 内核的备选,是否合适取决于现有节点配置,而不是客户端名称是否相近。下载页按这个顺序提供入口。

主流设备通常使用 arm64;架构不确定时,先查看系统信息或选择通用包。导入订阅以后,首次启动需要授权系统的 VPN 连接请求。这是客户端接管应用流量的系统入口,与桌面系统代理的工作方式不同。

如果锁屏后连接中断,先检查电池优化与后台运行限制。还应确认是否有其他应用占用了同一个 VPN 连接入口,再区分是后台被结束还是服务器连接失败。

前往下载

Linux · v2rayN

按发行版的包管理方式选择 deb 或 rpm,并继续区分 x64 与 arm64。图形桌面环境、系统依赖和网络权限都会影响使用方式;安装成功后,应先确认界面能正常启动、内核能正常加载,再调整流量接管方案。

桌面环境的系统代理设置并不一定被所有程序读取。有些应用需要单独指定本地 HTTP 或 SOCKS 入口,因此出现“浏览器正常、其他程序不正常”时,应先查看应用自身的代理配置。

TUN 涉及虚拟网卡、路由表和权限。已有容器网络、虚拟机网络或其他隧道工具的设备,建议记录原有设置,并在每次变更后检查本地网络与默认路由是否仍符合预期。

前往下载

配置批注阅览台

先看关键字段,再读设置影响。下面是局部示例,不是可直接替换客户端配置的完整文件。图形界面的字段名称可能随平台和内核变化,配置时应对照实际日志与生成结果。

备注:日常订阅
地址:https://example.com/sub?token=xxxx
启用更新:是
过滤关键字:香港|日本

订阅分组把地址、备注与更新行为放在同一处,适合管理多个来源。先为分组命名,再导入地址并更新,确认服务器记录落入预期分组。过滤关键字支持正则表达式,但筛选结果取决于节点名称;范围写得过窄,可能让更新后的列表看起来为空。与逐条手动添加相比,分组更新便于跟随来源调整,也可能覆盖手工修改。需要长期保留的自定义记录,应独立管理,并在更新前确认影响范围。

这些设置存在先后关系:订阅提供服务器记录,内核加载连接参数,路由决定出站,DNS 为域名提供地址,系统代理或 TUN 则决定应用流量怎样进入客户端。排查时顺着这条链路检查,比一次性重置全部设置更容易保留有效信息。

阅读配置示例时,还要区分客户端选项与内核字段。订阅备注、过滤关键字属于配置管理;路由规则和 DNS 片段则由客户端生成或传递给内核。把界面文字直接当成 JSON 字段使用,可能导致配置无法解析。需要完整操作路径时,可继续阅读进阶配置手册。

客户端与内核

Project V 开源生态

V2Ray 是 Project V 生态中的网络代理工具,核心工作是协议处理、传输与路由。日常使用时接触更多的 v2rayN、v2rayNG 与 v2flyNG,则是围绕内核提供操作界面的客户端。它们把服务器参数、订阅更新和启动控制集中起来,让配置不必完全依靠手工编辑。

这个分层解释了一个常见现象:客户端可以正常打开,但内核仍可能启动失败。图形界面负责管理配置,内核负责读取配置并建立连接;两部分的运行状态不能相互替代。遇到错误时,应先确认报错来自界面、配置生成还是内核输出,再决定是否调整节点参数。

V2Fly 与 Xray:共同背景,分别核对

V2Fly 延续 V2Ray 的社区维护工作,Xray 则从相关代码基础发展出另一条内核分支。两者共享一部分概念和使用习惯,但协议特性、传输能力与配置细节并不始终一致。讨论“V2Ray 内核区别”时,应落到具体字段与功能,而不是把整个生态看成一个可以任意互换的程序。

节点名称只是一段备注,不能完整表达它的连接要求。以 VLESS 配置为例,还需要确认传输方式、TLS 或 REALITY 等安全层设置,以及相关参数是否与服务端一致。选择客户端之前,先了解现有配置依赖的内核能力;已有连接可以稳定工作时,也没有必要只因另一个分支名称更新而立即迁移。

三款客户端:平台与配置需求分开选择

v2rayN 面向桌面使用,提供服务器列表、订阅分组、路由管理与多内核配置入口,适用于需要在图形界面中集中整理连接的用户。跨平台界面让桌面设备之间的操作思路更接近,但系统代理、权限和网卡处理仍由各操作系统决定,不能假设所有平台的行为完全相同。

v2rayNG 面向 Android,使用 Xray 内核处理连接,并通过系统 VPN 接口接收应用流量。其使用重点包括订阅导入、活动节点选择、应用分流与后台运行限制。v2flyNG 同样面向 Android,但采用 V2Fly 内核;它适合作为符合该内核能力范围的备选,而不是把所有节点都转换成另一种协议的工具。

这三款客户端均以开源项目形式维护。开源使代码与修改过程可以被讨论和审阅,免费使用则与服务器资源是不同层面的事。客户端本身不提供订阅服务,也不决定服务端线路质量;出现速度、流量额度或节点地区问题时,需要分别查看客户端设置和已有服务配置。

开源协议:说明代码使用条件

开源协议约束代码如何被使用、修改与分发。V2Fly 的 V2Ray 核心与 Xray 核心采用 MPL 2.0,v2rayN、v2rayNG 与 v2flyNG 客户端采用 GPL 系列协议。客户端和内核是不同项目,分发软件或修改代码时,应分别阅读所涉及项目的许可文本,不能只参考外层客户端的名称。

对普通使用者而言,理解这一点的直接价值是分清来源和边界:客户端由社区维护,内核也有独立的演进节奏,本站负责整理中文下载与配置说明。文档中的示例用于解释设置含义,不代表某个节点、某条线路或某种配置在所有环境下都能得到相同结果。

更新顺序:保留基线,再验证变化

客户端更新可能涉及界面调整、配置生成逻辑和随包组件;内核更新可能涉及协议处理与字段支持。两者相关,却不应被当成一个完全同步的版本体系。首页侧重选择与使用思路,具体安装入口和当前发布信息集中在下载页,便于在同一处核对平台与包格式。

更新前记录当前使用的内核、活动节点、路由方案和本地监听端口,并保存必要配置。更新后先用原来可用的节点测试基本连接,再核对订阅更新、分流和 DNS。若出现差异,查看日志中最早的错误行,判断是配置字段改变、权限变化,还是应用没有采用新的代理入口。

不要在同一次测试中同时换客户端、换内核、换服务器并开启 TUN。每增加一个变化,判断原因就多一层不确定性。保留一个已知可用的配置基线,并一次只改一项,可以让排查结果更容易复现,也便于回到正常状态。

配置阅读的四个常见入口

订阅更新失败。先确认地址没有被截断,再检查请求日志中的状态和响应内容。如果本地已有节点,导入问题与已有连接是否可用可以分开测试。具体步骤见订阅更新排查。

浏览器正常,其他应用异常。先确认应用读取哪种代理入口。系统代理不是接管所有网络流量的开关;需要更广接管范围时,再对照TUN 模式说明核对权限与网络栈。

域名失败,地址可以连接。优先检查解析路径、返回结果和路由域名策略。能通过地址访问并不证明所有 DNS 配置正确,可从DNS 设置章节区分解析失败与连接失败。

协议名称相同却无法导入。继续核对传输、安全层与参数格式。有些信息编码在链接中,有些由订阅生成;名称相同不等于配置完全相同。先读VLESS 名词解释,再查内核对照。

配置原理与排查文章

快速上手解决操作顺序,专题文章解释背后的网络行为。需要定位复杂问题时,先确定流量在哪一层中断,再选择对应文章;不要把路由器部署、内核兼容与节点测速混成同一个问题。

查看全部文章 →