开源客户端 · 下载与配置

V2Ray入门指南v2rayN 下载与配置

从订阅导入到路由分流,按实际设置项配置桌面与安卓客户端。

  • VMess
  • VLESS
  • Trojan
  • REALITY
  • Shadowsocks

v2rayN 核心配置

先整理订阅,再确定流量去向。每次只改一类设置,保留可回退的配置。

Subscription / Filter

按来源分组,按名称筛选

香港|日本
(?i)hongkong|japan
^(?!.*测试).*$

订阅分组用于区分不同来源,服务器过滤用于缩小当前列表。先给分组填写容易识别的备注,再添加订阅地址;更新成功后,使用“香港|日本”匹配名称中任一关键字。英文大小写可用内联标记处理,但具体支持情况以当前客户端为准。过滤结果为空时先清空表达式,不要急着删除订阅。与逐条手动导入相比,分组能保留来源关系,后续更新与排错更清楚。订阅地址可能包含访问凭据,截图和分享日志前应遮盖完整链接。

Client / Platform

按平台选择客户端

桌面选 v2rayN,安卓优先了解 v2rayNG。安装包格式和处理器架构在下载页分别说明。

Windows

v2rayN · 桌面首推

适合需要订阅分组、系统代理与精细路由的桌面用户。下载页区分新一代跨平台界面的桌面版,以及保留经典界面的 WPF 版;两者属于同一客户端的不同界面选择,不需要同时安装才能使用代理。

先在系统设置中确认处理器架构,再选择对应安装入口。首次运行后,先导入订阅并选定服务器,确认普通系统代理可以工作,再考虑 TUN。若程序能打开而浏览器无法连接,检查系统代理是否指向客户端实际监听的地址与端口,不要只重复导入同一个订阅。

准备切换界面版本时,先备份订阅分组与路由配置,记录原有设置;不要让两个客户端同时修改系统代理。排查结束或准备退出时,也应确认代理设置已经按预期恢复,避免应用继续访问已经停止的本地端口。

前往下载

macOS

v2rayN · 芯片分包

适合在桌面上统一管理订阅、路由和代理模式。先打开“关于本机”查看芯片信息:Apple Silicon 选择 arm64 入口,Intel 选择 x64 入口。不要根据设备外观或购买年份猜测架构,安装包应与实际硬件匹配。

首次打开遇到系统安全提示时,先确认安装文件来源,再按系统“隐私与安全性”中的提示处理。网络访问、系统代理与虚拟网络接口属于不同层面的权限,普通代理能够连接,不代表 TUN 所需权限也已完成。按当前界面提示逐项授权,通常比反复重装更有效。

从其他电脑迁移配置时,先导入订阅,再对照检查本地端口、规则文件和路径设置。旧设备上的绝对路径不一定适用于新设备。需要处理首次启动拦截时,可阅读平台文章,按顺序核对安全提示与网络授权,不必直接修改整套系统安全设置。

前往下载

Android

v2rayNG 优先 · v2flyNG 备选

v2rayNG 采用 Xray 内核,v2flyNG 采用 V2Fly 内核。两款都是开源图形客户端,选型重点是订阅使用的协议、参数兼容性以及需要的应用设置,而不是把名称相近理解为完全相同。主流较新手机通常选择 arm64,架构不明确时先查看设备信息,再考虑通用包。

首次启动连接时,系统会请求建立 VPN 连接。这里使用的是 Android 的 VpnService 接口,不需要另外填写系统自带 VPN 配置。一次只让一个接管网络的应用工作;若后台运行一段时间后断连,再检查电池优化、后台活动限制和厂商自启管理。

需要只让部分应用使用代理时,先弄清分应用列表当前是“包含”还是“绕过”逻辑,再勾选目标应用并重新建立连接。应用是否被接管,与它访问的目标最终走哪个出站仍是两件事;前者由接管范围决定,后者还要看路由规则。完整操作可继续阅读安卓平台文章。

前往下载

Linux

v2rayN · 按发行版选格式

适合希望用图形界面管理订阅和路由的桌面环境。下载页提供 deb 与 rpm 入口,并区分 x64、arm64 架构。先确认发行版使用的包格式,再确认机器架构;包格式适配与内核协议支持是不同问题,不能靠更换包后缀解决配置不兼容。

安装后先通过客户端界面导入订阅,确认内核可以正常启动。系统代理是否生效还取决于桌面环境和具体应用,部分程序需要单独配置。准备开启 TUN 时,再检查虚拟网络接口权限、已有路由和其他网络接管工具,保留可以恢复的原始网络状态。

若浏览器可用而其他程序无法连接,先判断该程序是否读取桌面代理设置,再决定配置应用代理还是使用 TUN。若客户端启动失败,优先查看日志中的权限、依赖或配置字段提示,不要把界面未启动与远端服务器不可达混为一谈。涉及发行版差异的要求,以下载页说明和实际系统提示为准。

前往下载

查看全部客户端 →还没确定用哪款?先看选型指南。

Project V、V2Fly 与 Xray

先区分项目、内核与客户端,再判断一条配置应该改在哪里。

生态分层

Project V
项目与工具体系
V2Fly / Xray
内核实现与各自演进
v2rayN / v2rayNG / v2flyNG
面向用户的图形客户端
对照客户端与内核 →

从 V2Ray 项目到内核家族

Project V 是围绕代理通信构建的项目体系,V2Ray 是其中广为人知的工具。随着社区发展,V2Fly 社区延续了 V2Ray 的维护与演进;Xray 则从相关代码基础上形成独立分支,并发展出自己的功能与配置支持。理解这段关系,可以避免把三个名字当作同一软件的三个别称。它们有共同的技术背景,但如今应分别查看各自的配置能力,不能把某个分支新增的功能直接套到另一分支上。

“V2Ray 订阅”在日常交流中常被用来泛指一组代理服务器配置,但这个称呼本身并不保证所有客户端都能解析其中的内容。订阅可能包含多种协议、传输方式与安全参数,客户端还需要把这些信息转换成目标内核认识的配置。因此,导入成功只是第一步;还应确认选中的服务器参数完整、内核启动正常,以及实际连接走到了预期出站。

客户端负责管理,内核负责执行

v2rayN 提供桌面图形界面,用于组织订阅分组、选择服务器、管理路由并调整代理模式。其实际网络能力由所用内核及相关组件共同决定,可选项应以当前发行包和界面为准。v2rayNG 是 Android 上采用 Xray 内核的开源客户端;v2flyNG 则是采用 V2Fly 内核的安卓备选。三款客户端都以图形操作为主要入口,但菜单位置、导入格式和高级选项并不完全一致,教程中的设置名称应与实际界面对照。

遇到 REALITY 协议相关配置时,需要进一步区分协议、传输层和安全机制。REALITY 不是在任意服务器上点一下就能启用的通用加速选项,连接双方必须具备相互匹配的配置与实现支持。来自订阅的关键参数不应凭经验修改;缺少必要参数时,应先核对配置来源。单纯更换客户端图标或切换界面版本,并不会自动补齐远端配置,也不会改变服务器支持的协议。

开源许可说明什么

开源意味着代码在相应许可证条件下可供查看、使用、修改或分发,不等于所有相关项目采用同一许可证。V2Fly 的 V2Ray 核心以 MIT 许可证发布,Xray 核心采用 MPL 2.0;图形客户端、内核与附带组件还可能分别适用不同条款。日常安装使用时,可以通过客户端的项目信息了解组成;准备修改代码或重新分发软件时,则应逐项阅读对应许可证,而不是把内核许可直接当作整个安装包的许可。

代码公开也不替代本地权限管理。订阅地址可能关联账户权益,配置中可能包含服务器地址和访问凭据,日志也可能记录访问目标。分享截图时保留错误类型和必要字段即可,敏感内容应遮盖。开启“允许来自局域网的连接”前,要确认监听地址、认证方式与防火墙范围。它改变的是其他设备能否访问本地代理端口,不是让当前电脑连接更稳定的必要条件。

更新客户端,也检查配置与规则

客户端程序、代理内核、订阅内容以及 geoip、geosite 规则数据,是不同的更新对象。客户端更新可能改变界面与配置生成逻辑;内核更新可能调整字段支持;订阅更新取得服务器参数;规则数据库更新则影响域名和地址分类。某个网站没有按预期分流时,应先确认命中的规则及顺序,再判断是否需要更新数据文件,不必把所有组件一次替换。

更新前备份自定义路由和 DNS 设置,记录当前采用的代理模式。更新后先用原有配置确认基本连接,再逐项启用新功能。若问题只在修改后出现,回退最近一项通常比同时调整端口、DNS 和路由更容易定位。还要注意,部分图形客户端会重新生成运行配置,直接编辑生成文件可能在下一次启动时被覆盖;需要长期保留的设置,应放进客户端支持的自定义入口。

把连接问题拆成可验证的环节

订阅更新失败与服务器连接失败不是同一类问题。前者先核对订阅地址是否完整、是否仍然有效,以及更新请求采用的网络路径;后者则需要检查当前服务器、协议参数、系统时间和内核日志。能看到服务器列表,也不代表系统代理已经启用;浏览器能够访问,也不代表所有应用都会读取同一代理设置。沿着“导入、启动、接管、解析、路由”的顺序检查,可以减少没有依据的反复重装。

日常配置建议从系统代理开始,确定基础连接后再引入路由分流;确有应用接管需求时,再开启 TUN。DNS 与 FakeDNS 等高级主题需要配合内核和路由策略理解,不适合只复制一个开关。教程按导入订阅、选择模式和验证连接展开;进阶配置手册再分别讨论过滤规则、自定义出站及复杂 DNS 场景。若已经出现具体报错,可先到常见问题查对应环节,再决定调整哪一项。

Notes / Configuration

配置实践与平台文章

从权限与后台运行等具体问题切入,补充日常设置背后的工作方式。

查看全部文章 →