Windows · v2rayN
提供新一代桌面界面与经典 WPF 界面。首次使用可优先选择桌面版;已有固定操作习惯或需要经典菜单结构时,可在下载页查看 WPF 版说明。
桌面系统使用 v2rayN,Android 可在 v2rayNG 与 v2flyNG 之间选择。下列入口会打开下载页对应的平台面板,安装包类型、架构选择和系统要求都在面板内说明。
提供新一代桌面界面与经典 WPF 界面。首次使用可优先选择桌面版;已有固定操作习惯或需要经典菜单结构时,可在下载页查看 WPF 版说明。
按照设备处理器选择 Apple Silicon 或 Intel 安装包。进入系统的“关于本机”即可查看芯片类型,安装后的订阅与路由菜单和其他桌面版本保持相近。
v2rayNG 使用 Xray 内核,适合作为常用入口;v2flyNG 使用 V2Fly 内核,可按服务端配置与使用偏好选择。主流设备通常选择 arm64,无法确认时可查看通用版。
Debian、Ubuntu 等系统选择 deb,Fedora、Rocky Linux 等系统选择 rpm。下载页同时区分 x64 与 arm64 架构,并列出安装前需要确认的桌面环境条件。
客户端的关键价值不只在于导入一个连接。订阅如何更新、系统代理接管哪些程序、路由规则按什么顺序匹配、TUN 模式何时需要启用,都会直接影响实际使用结果。本区按照真实设置项拆分六类能力,先给出操作入口,再解释适用边界和检查方法。
{
"routing": {
"domainStrategy": "IPIfNonMatch",
"rules": [
{
"type": "field",
"ip": ["geoip:private"],
"outboundTag": "direct"
}
]
}
}
在 v2rayN 中可通过“订阅分组 → 订阅分组设置”保存订阅地址,再执行“更新全部订阅”获取服务器列表。分组名称用于整理不同来源,不会改变节点参数。若更新后列表为空,应依次确认地址是否完整、返回内容能否被客户端解析、当前网络是否允许请求以及客户端日志是否出现格式提示。相比逐条粘贴分享链接,订阅更适合持续维护一组会发生变化的配置。
系统代理主要接管遵循操作系统代理设置的浏览器和桌面程序。v2rayN 启动内核后,还需要在托盘菜单中选择相应的系统代理状态;仅启动客户端并不等于所有程序都已使用代理。遇到某个应用连接方式不同的情况,应先检查该应用是否读取系统代理,再决定是否配置应用自身代理或使用 TUN。这样可以避免把程序兼容问题误判为节点故障。
routing 段可按域名、IP、端口、协议或入站标签选择出站。常见做法是先处理局域网和私有地址,再匹配需要直连或代理的目标,最后保留默认出口。规则之间并非相互覆盖,而是按配置顺序寻找匹配项。修改后应重点检查域名策略、规则顺序与 outboundTag 是否对应已有出站;如果标签拼写不一致,内核通常会在启动日志中给出明确提示。
TUN 模式通过虚拟网络接口处理流量,适合部分不读取系统代理设置的程序。启用前应确认客户端所需权限、虚拟接口状态和本机其他网络工具是否存在冲突。排查时不要同时频繁切换多项设置:先关闭系统代理测试 TUN,再恢复单一路由方案,并通过日志确认 DNS 与出站选择。清晰的变量控制比反复重装更容易定位问题。
v2rayN 是桌面图形客户端,可配合其支持的内核处理连接;v2rayNG 以 Xray 内核为主要实现,v2flyNG 则对应 V2Fly 内核路线。两类内核都源于 Project V 生态,但配置支持范围和功能演进节奏并不完全相同。选择时应以服务端协议、传输参数和客户端支持情况为准,不宜只按名称判断。遇到导入成功但启动失败时,内核兼容性是需要检查的一项。
内核启动失败、订阅解析异常和端口占用通常都会留下可定位的日志。排查时从错误发生时间附近开始,优先读取第一条包含字段名、端口或配置段的有效错误,而不是只看最后一行退出信息。端口占用检查本机监听程序,配置错误检查对应 JSON 字段,传输不匹配则对照服务端参数。每次只修改一个变量并重新启动,能够保留清晰的因果关系。
先建立一条可以复现的基础连接,再逐步加入自动更新、路由与 TUN。初次配置时一次只改变一个选项,出现问题时更容易判断发生在哪个环节。
桌面系统进入 v2rayN 对应平台面板,Android 根据内核需求选择 v2rayNG 或 v2flyNG。安装前确认处理器架构与安装包类型,避免把架构不匹配误认为程序无法启动。首次打开后先保持默认路由和默认端口,不急于调整高级参数。
在客户端的订阅分组设置中新增地址,保存后执行更新。服务器列表出现后,选择一条配置并设为活动服务器。若列表为空,先查看订阅更新日志;若节点存在但不能启动,再查看内核日志,不要把两类问题混在同一轮排查中。
确认活动服务器后启动内核,再根据应用类型选择系统代理。常规浏览器通常先测试系统代理;不读取系统代理的程序再评估 TUN。基础连接稳定后,最后加入绕过局域网、域名匹配和指定出口等路由规则。
客户端、内核、协议配置与订阅服务分别承担不同职责。理解这些边界,有助于判断问题属于界面操作、配置内容、内核兼容还是远端服务。
Project V 奠定了 V2Ray 配置体系的基本结构:入站负责接收本机流量,出站负责定义转发目标,routing 在两者之间执行匹配,dns 与 log 则提供域名解析和运行记录。V2Fly 社区继续维护 V2Ray Core 及相关规范,Xray 在同一技术脉络上发展出独立内核。两者共享不少配置概念,但具体字段、协议扩展和发布节奏可能存在差异。
因此,“客户端支持某种分享链接”和“当前内核能够完整处理对应参数”是两个不同判断。图形客户端可以解析订阅、生成配置并管理进程,真正执行协议握手、路由和转发的是内核。服务端参数发生变化时,应同时核对客户端解析能力与内核支持范围,而不是只检查界面中是否出现服务器名称。
v2rayN、v2rayNG、v2flyNG 以及相关内核均采用开源方式维护。源代码、配置格式和变更记录由各项目公开管理,功能讨论、问题修复与兼容调整由维护者和社区参与者持续推进。开源属性便于开发者理解配置如何生成,也让高级用户可以根据日志和字段定义定位行为差异。
不同组件可能采用不同的开源许可证,许可证约束的是代码复制、修改和再发布方式,不代表所有客户端由同一团队维护。使用文档时应明确对象:v2rayN 的菜单路径不能直接套用于移动端客户端,Xray 的扩展字段也不应假定在每个 V2Fly 配置中都能使用。按组件查阅对应说明,能减少概念混用。
客户端更新通常包含界面调整、订阅解析变化、配置生成修正和内核管理能力;内核更新则更集中于协议实现、传输行为、路由与 DNS。发生“更新前可用、更新后异常”时,应先记录改变的是客户端、内核还是订阅内容,再逐层回看日志。若同时替换多个组件,很难判断真正影响结果的变量。
日常维护可采用固定顺序:先更新订阅并观察节点列表,再启动当前已知配置,最后才调整代理模式和路由。对于长期使用的规则,应保留规则目的、匹配条件和出口标签说明。这样即使界面菜单调整,也能从配置语义恢复原来的行为,而不是依赖某个按钮位置。
面向 Windows、macOS 与 Linux 的图形客户端,集中管理订阅分组、服务器列表、系统代理、路由规则、TUN 与内核日志。适合需要在桌面端维护多组配置并观察运行状态的用户。
以 Xray 内核为主要实现的移动端客户端,支持扫码、剪贴板与订阅方式导入配置。常用操作围绕配置列表、活动节点、路由设置和连接日志展开。
采用 V2Fly 内核路线的移动端选择,界面操作与常见订阅流程保持清晰分层。适合明确需要 V2Fly 内核兼容范围或希望对照两类内核行为的使用场景。
多数配置问题可以先按发生阶段分类。列表没有内容,重点看订阅请求与解析;程序不能启动,重点看内核日志;只有部分应用不生效,重点看流量接管方式。
先确认保存的是完整订阅地址,再查看更新日志中的网络请求和解析提示。能够打开地址不等于返回内容符合客户端支持的订阅格式;若近期更换了订阅来源,还应检查分组中是否保留了旧地址。
查看订阅导入步骤 →检查活动服务器是否已选中、内核是否正在运行,以及托盘菜单中的系统代理状态。部分程序有独立代理设置或不会读取系统设置,需要单独配置,或在确认权限与冲突后使用 TUN。
查看连接与验证步骤 →从日志中找到第一条明确错误,常见线索包括端口被占用、出站标签不存在、配置字段类型不正确或传输参数缺失。修正一项后重新启动,不要同时改端口、路由和内核。
查看完整排查路径 →全局代理适合短时间验证节点与内核能否正常工作;确认基础连接后,再切换到路由分流并逐条加入规则。先验证默认出口,再增加局域网、域名和 IP 规则,可以更快发现匹配顺序问题。
查看路由分流章节 →围绕主界面分区、日志定位和 JSON 配置结构整理具体操作。文章按单一问题展开,便于在完成基础教程后继续查阅。