Windows
v2rayN 提供桌面版与经典 WPF 版。桌面版采用跨平台界面,WPF 版保留经典窗口布局。先按下载页列出的系统要求选择,不把界面差异当作节点性能差异。
安装前退出正在运行的旧实例,避免两个进程争用本地监听端口。需要迁移时先备份订阅分组和路由设置,保留一个可工作的配置,再验证新环境。涉及 TUN 的权限问题,应在普通系统代理连接成功后单独处理。
前往下载 Windows 客户端配置索引 / 从入口到流量路径
先让一个节点完成连接,再逐项增加分流与接管功能。下方片段用于解释设置与内核配置的对应关系,不是可整段替换的完整配置;不同内核的字段不能混用,界面名称也可能随客户端更新略有调整。
订阅分组 › 订阅分组设置 › 添加
在“订阅分组设置”添加名称与订阅地址,保存后从“订阅分组”执行更新。先尝试不通过代理更新,只有地址确实需要代理访问时再切换更新方式。订阅管理比逐条导入链接更适合批量维护,但更新成功只代表取回内容,不代表每个节点都能连接。导入后选择一个节点设为活动服务器,再做真连接测试。订阅地址通常含访问凭据,不要发到公开截图或交给来历不明的转换页面。
{
"outbounds": [
{ "tag": "proxy", "protocol": "vmess" }
]
}
片段只展示 Xray 出站结构;服务器地址、用户信息与传输参数由导入内容生成。
查看订阅导入步骤 →设置 › 路由设置 › 预设规则
先从“路由设置”的预设规则开始,确认大陆域名、私有地址与其余流量分别走哪条出站,再增加自定义规则。规则通常自上而下匹配,宽泛规则放在前面可能遮住后面的精确规则。与只切换全局代理相比,分流能保留局域网服务的原有路径,但依赖域名分类数据和解析结果。排查某个网站时先看命中的出站,不要同时修改节点、DNS 和规则。片段中的出站标签必须在实际配置中存在。
{
"routing": {
"domainStrategy": "IPIfNonMatch",
"rules": [
{ "type": "field", "ip": ["geoip:private"], "outboundTag": "direct" },
{ "type": "field", "domain": ["geosite:cn"], "outboundTag": "direct" }
]
}
}
查看 geosite 与 geoip 规则手记 →
主窗口 › 系统代理 › 自动配置系统代理
选择活动服务器后,在主窗口将“系统代理”设为“自动配置系统代理”。它会修改系统代理入口,但不会强制接管所有应用;自带代理设置的程序仍需单独检查。到“参数设置”的“Core:基础设置”确认本地混合监听端口,再让应用连接同一个端口。相较 TUN,这条路径更便于检查浏览器流量,也更适合首次验证。退出客户端前清除系统代理,避免系统继续指向已经停止监听的本地地址。
{
"inbounds": [
{
"tag": "http",
"listen": "127.0.0.1",
"port": 10808,
"protocol": "http"
}
]
}
这里用 Xray 的 HTTP 入站说明本地代理入口,不代表图形界面生成的全部监听配置。
查看系统代理验证步骤 →设置 › 参数设置 › TUN 模式设置
TUN 通过虚拟网络接口接管流量,适合不能手动设置代理的应用。先用系统代理确认节点可用,再检查“TUN 模式设置”,按平台要求授予网络配置权限后启用。与系统代理相比,TUN 的影响范围更广,也更容易和其他虚拟网卡、企业网络软件发生路由冲突。首次测试保留默认参数,观察直连网站和局域网服务是否正常。出现断网时先关闭 TUN 恢复基线,再分别检查路由与 DNS,不要连续叠加多个接管工具。
{
"inbounds": [
{
"type": "tun",
"tag": "tun-in",
"address": ["172.19.0.1/30"],
"auto_route": true
}
]
}
这是 sing-box 的 TUN 入站片段,不应粘贴到 Xray 配置中。
查看 TUN 连接问题诊断 →设置 › DNS 设置
DNS 决定域名先被解析成什么地址,路由再决定连接交给哪条出站。进入“DNS 设置”时先确认正在配置的内核,不要把不同内核的字段直接拼接。按域名选择解析服务器,可以减少所有域名共用单一解析路径带来的误判,但解析服务器本身也必须可达。启用加密 DNS 不等于解析请求必然经过代理,还要检查其连接路由。若域名访问失败而地址连接正常,先看解析日志和缓存,再调整远程 DNS。
{
"dns": {
"servers": [
{
"address": "223.5.5.5",
"domains": ["geosite:cn"],
"expectIPs": ["geoip:cn"]
},
"https://dns.google/dns-query"
]
}
}
Xray DNS 结构示例。实际解析服务器与访问路由应结合当前网络测试。
查看 DNS 分流配置手记 →设置 › 参数设置 › Core 类型设置
图形客户端负责管理节点,真正建立连接的是内核。进入“Core 类型设置”时,先核对节点使用的协议、传输方式与安全参数,再决定对应内核;不能只因名称相近就假定字段完全兼容。多内核的价值在于适配不同配置,而不是保证切换后一定更快。更改后重新启动连接,检查日志是否出现不支持的字段或协议。保留原来可工作的配置,逐次验证单一改动,比一次替换全部设置更容易定位问题。
{
"log": {
"loglevel": "warning"
},
"outbounds": [
{ "tag": "direct", "protocol": "freedom" }
]
}
Xray 的日志与直连出站片段;其他内核应使用各自对应的配置语法。
查看内核启动与配置报错排查 →先保存原有配置,再导入订阅、选择活动服务器、执行真连接测试,最后启用系统代理。每完成一步就确认结果,避免把订阅下载失败、节点连接失败和浏览器未使用代理混成同一个问题。若已经修改过多项参数,可以先退出其他代理工具,关闭 TUN,回到单节点加系统代理的最小测试环境。
真连接测试会尝试经过节点访问测试目标,Tcping 则主要反映服务器端口的连接情况。两者测试对象不同,端口能连通不代表协议握手成功,测试目标暂时不可达也不必然说明节点完全失效。比较结果时保持网络、目标和测试方式一致,再打开实际需要使用的网站验证,不以单个数字判断全部体验。
按完整教程完成首次连接 →客户端选型 / 系统与处理器
桌面系统使用 v2rayN,安卓设备优先选择 v2rayNG,需要 V2Fly 内核时再考虑 v2flyNG。下载页按系统和处理器整理安装入口;客户端安装完成后仍需要有效的节点信息,安装包本身不提供可用服务器,也不会自动生成订阅。
v2rayN 提供桌面版与经典 WPF 版。桌面版采用跨平台界面,WPF 版保留经典窗口布局。先按下载页列出的系统要求选择,不把界面差异当作节点性能差异。
安装前退出正在运行的旧实例,避免两个进程争用本地监听端口。需要迁移时先备份订阅分组和路由设置,保留一个可工作的配置,再验证新环境。涉及 TUN 的权限问题,应在普通系统代理连接成功后单独处理。
前往下载 Windows 客户端v2rayN 按 Apple Silicon 与 Intel 提供入口。在系统的“关于本机”查看芯片或处理器,再选择对应安装包,不根据电脑外观或购买年份猜测架构。
首次打开时按照系统安全提示确认应用来源与所需权限。连接验证先从浏览器开始,再检查系统代理设置;如需开启 TUN,另外核对网络权限和其他网络扩展。切换 Wi-Fi 后若连接异常,应重新检查默认网络路径。
前往下载 macOS 客户端首选使用 Xray 内核的 v2rayNG,v2flyNG 作为 V2Fly 内核备选。主流设备通常选择 arm64,不能确认架构或遇到安装不兼容时,再查看下载页的通用版说明。
导入节点后需要同意系统的 VPN 连接请求。系统通常只允许一个此类连接保持活动,启用其他网络接管应用可能使当前连接断开。若前台正常、锁屏后失效,优先检查电池优化和后台运行限制,再排查节点本身。
前往下载 Android 客户端v2rayN 提供 deb 与 rpm 安装入口,并区分 x64 和 arm64。先确认发行版使用的包管理方式,再核对处理器架构;包格式和架构是两项独立条件。
图形桌面的系统代理设置未必会被终端程序继承。浏览器连接成功后,仍应检查目标应用是否读取桌面代理,或是否配置了独立的代理入口。TUN 还涉及网络权限与路由,远程维护环境下应先准备恢复原网络配置的方法。
前往下载 Linux 客户端同一订阅可以包含多种协议,但客户端与内核不一定支持其中的每一项。安装后若部分节点无法导入,应先看报错中的协议或传输字段,再判断是否需要调整客户端或内核。不要为解决一个节点的问题反复重装整个系统,也不要覆盖尚未备份的路由配置。
迁移配置时只保留必要数据。订阅地址、节点链接与导出的配置文件可能包含账号信息,分享日志前先删除这些内容。首页用于选型和阅读操作路径,具体安装包与更新信息集中放在下载页,便于按当前系统重新选择。
查看全部客户端 →开源生态 / 客户端与内核的边界
图形界面
v2rayN / v2rayNG / v2flyNG
连接内核
Xray / V2Fly
配置内容
入站 / 出站 / 路由 / DNS
V2Ray 源于 Project V 的模块化网络工具体系。日常搜索中的“V2Ray 客户端”常同时指图形界面和连接内核,实际使用时需要把两层分开理解:图形界面保存订阅、组织节点并生成配置,内核读取配置后处理入站、路由和出站。浏览器能否访问,还取决于操作系统与应用是否把请求送到这个入口。
这种分层解释了一个常见现象:主窗口可以正常打开,订阅列表也能显示,但内核可能因端口占用或配置错误而未能启动。因此“程序已打开”不是“代理已生效”的充分条件。排查时先确认内核日志,再核对本地监听和系统代理,最后检查网站访问结果,能少走许多重复重装的弯路。
V2Fly 延续 V2Ray 的社区维护路线,Xray 是从 V2Ray 发展而来的另一条内核路线。两者有共同的技术背景,也各自演进协议支持、传输能力与配置细节。理解共同概念有助于阅读配置,但不能据此假定所有新字段都能互换。遇到协议特性、流量探测或 DNS 行为差异时,应回到当前实际运行的内核判断。
v2rayN 的多内核管理可以把不同配置集中到图形界面中,但具体可用组合仍受客户端实现与内核支持范围限制。选择内核时,优先满足节点所需协议和传输参数,再考虑已有路由规则是否兼容。若连接原本正常,切换内核后失败,应先检查配置兼容性,而不是直接认定服务器不可用。
v2rayN、v2rayNG 与 v2flyNG 都是开源图形客户端。v2rayN 和 v2rayNG 采用 GPL-3.0 许可,v2flyNG 采用 GPL-3.0 许可;V2Fly 与 Xray 内核采用 MPL-2.0 许可。客户端与内核是不同项目,许可适用范围应分别查看。开源意味着代码及相应许可条件可供研究与审阅,不代表任意来源的二次打包都具有相同维护质量。
桌面端的重点是订阅管理、系统代理和多内核配置,安卓端还要配合系统 VPN 接口与后台运行策略。v2rayNG 面向 Xray 内核配置,v2flyNG 提供 V2Fly 内核路线。选型应围绕设备、协议和既有配置展开,而不是把客户端名称当作速度排名;同一客户端在不同节点与网络下的表现也会不同。
客户端更新、内核更新和路由分类数据更新解决的是不同问题。界面更新可能调整设置入口,内核更新可能影响协议行为,分类数据更新则可能改变域名或地址的匹配结果。更新前记录当前活动服务器、系统代理状态和路由预设,保存必要配置;更新后先验证原有连接,再启用新增功能。
不建议在同一次排查中同时替换订阅、内核、DNS 与整套路由。保留能工作的基线,每次只变更一类设置,结果才有可比性。若更新后仅个别域名异常,检查规则命中与 DNS;若内核无法启动,检查日志中的字段错误与端口占用。遇到持续问题时,可以从问题诊断页按症状逐章核对。
进入 v2rayN 问题诊断 →配置手记 / 最近文章
先区分“节点未建立连接”和“连接后请求走错路径”。最近三篇手记分别处理 DNS 泄漏、解析分流与网页无法访问,按日志、系统代理和路由结果逐项核对,避免只凭客户端状态栏下结论。
用在线检测页判断解析请求是否绕过代理,再通过 TUN 模式、远程 DNS 与流量探测设置,检查客户端内的解析路径。
阅读检测与设置手记 →拆解 dns 模块的 servers、domains 与 expectIPs 字段,说明大陆域名与境外域名的解析分流,以及 DoH 服务器的连接路径。
阅读 DNS 配置手记 →按系统代理、监听端口、节点可用性、系统时间、路由规则和防火墙的顺序核对,定位连接后仍然无法访问的原因。
阅读连接排查清单 →