Windows
v2rayN · 桌面首选提供 Desktop 与经典 WPF 入口。Desktop 使用新一代跨平台界面,WPF 保留经典桌面操作方式;按使用习惯与运行环境选择。
前往下载 →先确定操作系统,再确认处理器架构。桌面端使用 v2rayN;安卓端根据内核需求,在 v2rayNG 与 v2flyNG 之间选择。
提供 Desktop 与经典 WPF 入口。Desktop 使用新一代跨平台界面,WPF 保留经典桌面操作方式;按使用习惯与运行环境选择。
前往下载 →Apple Silicon 与 Intel 分别使用对应安装包。在「关于本机」查看芯片信息;首次打开时,按系统提示处理应用放行与网络权限。
前往下载 →v2rayNG 使用 Xray 内核,v2flyNG 为 V2Fly 内核备选。主流设备通常选 arm64;不确定设备架构时,查看系统信息或选择通用包。
前往下载 →Debian、Ubuntu 系优先查看 deb,Fedora 等发行版查看 rpm。除包格式外,还需区分 x64 与 arm64,并确认桌面会话和托盘支持。
前往下载 →客户端、内核与订阅是三个不同部分。安装客户端只是获得操作界面和本地代理能力,不会自动产生可用服务器。开始前需要准备有权使用的订阅地址或服务器配置,并确认服务端采用的协议、传输方式和安全参数。仅有服务器名称或地区标签,不能完成连接。
同一个订阅可以包含多种协议,但客户端能否导入,还取决于订阅格式与内核兼容性。不要只根据文件扩展名判断:分享链接、聚合订阅与完整 JSON 的导入入口不同。初次使用建议先导入一个来源明确的订阅,选定一条配置,再检查本地代理是否启动,避免一次叠加多个不确定因素。
安装后先使用默认网络设置完成一次连接。桌面端确认系统代理是否已接管浏览器流量;安卓端确认 VPN 授权已经通过。需要处理游戏、命令行或特定应用时,再评估 TUN 模式或分应用代理。先建立可复现的基本连接,再修改分流规则,更容易判断问题来自哪里。
已有配置的设备,升级前应保留订阅分组、路由规则及自定义 DNS 设置。不要直接将另一个客户端的整个数据目录覆盖过来:界面配置、内核配置和规则文件各有自己的结构。需要迁移时,优先重新导入订阅,再逐项迁移确实使用的自定义设置。
从客户端里的真实设置项理解功能。先解决配置来源,再决定流量如何进入代理、由哪个出站处理,以及域名在哪里解析。
订阅分组适合把不同来源的服务器分开管理。在 v2rayN 的「订阅分组」中添加备注与订阅地址,保存后更新对应分组,再回到服务器列表选择配置。v2rayNG 也可通过订阅分组管理来源。与逐条粘贴分享链接相比,订阅可以集中同步地址和参数,但更新可能替换原有条目。需要长期保留的手动配置应单独整理;过滤表达式先用少量条目验证,避免把需要的服务器一起隐藏。
路由规则决定流量走直连、代理还是阻断,而不是决定应用是否进入客户端。v2rayN 中的系统代理与路由模式需要分别检查;「绕过大陆」也不等于所有应用都会遵循系统代理。规则通常按顺序匹配,局域网地址等明确例外应放在合适位置,再处理域名与地址集合。下方是 Xray 风格的规则片段,需放入相应配置结构,且 direct 出站必须存在。完整配置不能只靠一条规则替代。
{
"type": "field",
"ip": ["geoip:private"],
"outboundTag": "direct"
}
TUN 模式适合不读取系统代理的应用,通过虚拟网卡让更多流量进入客户端。它与「全局路由」不是同一个开关:前者处理流量入口,后者决定进入后的出口。桌面端启用前先确认权限、相关组件与系统支持,避免同时运行其他接管网络的工具。安卓端通常通过系统 VPN 接口工作,不应照搬桌面开关。开启后若局域网访问异常,应检查私有地址排除规则与 DNS,而不是反复更换服务器。
DNS 把域名解析为地址,解析路径需要与路由目标配合。页面打不开时,先看日志是否出现解析超时,再检查服务器是否能建立连接。不要把公共 DNS 地址直接填进所有输入框:本地解析、远程解析和引导解析用途不同。下方展示内核 DNS 的最小结构,不代表完整的分流方案。v2rayNG 的「启用本地 DNS」也需要结合具体配置理解;使用 FakeDNS 时,应同时检查入口与路由是否支持对应工作方式。
{
"dns": {
"servers": ["localhost"]
}
}
Xray 与 V2Fly 属于相关但独立演进的内核项目,支持的协议细节和配置字段并不完全相同。v2rayN 的内核选择应以当前发行包与设置入口为准,不能假设任意配置都能直接切换。安卓端可用 v2rayNG 与 v2flyNG 对照不同内核路线。切换前备份配置,确认传输、安全参数与规则资源兼容,再用同一条服务器配置验证。某个内核能够导入链接,并不代表另一内核也支持全部扩展参数。
客户端负责操作,内核负责连接。理解这层关系,才能判断配置能否迁移、协议是否兼容,以及更新后应该检查什么。
V2Ray 项目的技术背景
分别演进的内核项目
面向用户的图形客户端
Project V 是理解 V2Ray 生态的起点。V2Ray 将协议处理、传输和路由等能力组织在可配置的代理内核中;图形客户端则把常用操作变成服务器列表、订阅分组和设置界面。日常所说的「安装 V2Ray」,往往实际是在安装客户端与其配套组件,而不是直接编辑全部内核配置。
因此,界面上同名的选项不一定对应完全相同的内部实现。一个客户端可能把多项底层参数合并成一个开关,也可能只开放部分设置。排查时应先记录客户端名称、所用内核和运行模式,再查对应文档。把客户端与内核混为一谈,容易把界面操作问题误判成协议问题。
V2Fly 社区持续维护 V2Ray 相关实现;Xray 源于相关技术路线,随后独立发展。两者共享部分概念,但协议支持、传输扩展与配置要求会随各自演进发生变化。遇到 VLESS、VMess、Trojan 或 REALITY 等配置时,应逐项核对内核能力和服务端参数,而不是只看客户端是否显示了对应名称。
分享链接通常只表达一条服务器连接所需的信息,完整 JSON 还可能包含入口、出站、路由与 DNS。两者不能简单视为可互换文件。将完整配置迁移到另一内核时,要检查字段含义、出站标记与规则资源;将链接导入另一客户端时,也应确认扩展参数没有被忽略。
v2rayN、v2rayNG 与 v2flyNG 均以开源方式发布,客户端项目采用 GPL-3.0 许可;内核及随附组件有各自的许可证,分发与修改时需分别阅读。开源说明代码可以按许可条件被阅读、研究和修改,不等于每个发行包都经过独立审计,也不替代对订阅来源和服务端运营方的判断。
桌面端优先考虑 v2rayN,主要因为服务器管理、订阅分组与路由设置集中在桌面操作流程中。安卓端先看 v2rayNG;已有明确 V2Fly 兼容需求时,再考虑 v2flyNG。这里的选择依据是平台与配置需求,不是虚构的性能排名。详细差异可查看客户端选型指南。
客户端更新可能调整界面、配置生成方式或配套内核。更新前记录当前可用的服务器配置、系统代理状态和自定义规则,保留配置备份;更新后先用原有网络环境验证基本连接,再检查订阅更新、DNS 与 TUN。不要在升级的同时重写全部路由,否则很难判断变化来自哪个环节。
维护状态与具体兼容范围应以项目发布说明和实际发行包为准。本站首页只提供稳定的选型逻辑,安装包信息集中在下载页。若更新后某项设置入口变化,先确认当前客户端与平台,再参考对应教程,避免照着旧截图盲目寻找相同位置。
订阅地址可能带有访问凭据,应当按敏感信息保管。截图、日志和求助内容中,不应直接公开完整订阅地址、用户标识或服务器认证参数。需要说明问题时,可以保留协议类型、字段名称与错误信息,移除能够识别账户的内容。服务器列表导出文件也可能包含同类信息。
客户端提供的是本地连接与管理能力,服务质量还取决于网络环境和服务器。切换应用并不能修复失效订阅,也不会自动改变服务端限制。先确认配置来源有效、账户状态正常,再检查本地设置,能够减少重复安装和反复导入造成的混乱。
从安装包部署、订阅格式到服务器选择,按具体问题阅读。操作前先确认客户端与平台,不把不同内核的配置片段直接混用。
在 Ubuntu、Debian、Fedora 等发行版上用 deb 或 rpm 包安装 v2rayN,处理依赖与托盘图标问题,并通过桌面自启动项实现登录后自动运行。
阅读桌面部署说明 →解释 Base64 订阅、完整 JSON 配置与 vmess:// / vless:// 分享链接各自的结构,以及在 v2rayN 和 v2rayNG 里导入、导出与相互转换的做法。
阅读订阅格式说明 →订阅里节点很多时,先看真连接延迟,再结合流量倍率、地理位置与 VLESS/VMess/Trojan 协议差异做取舍,给日常浏览、视频与远程办公分别配合适的节点。
阅读服务器选择说明 →