Windows
v2rayN桌面版采用跨平台界面,经典 WPF 版保留熟悉的操作布局。新安装可以先了解桌面版;已有使用习惯与配置时,先比较界面差异再决定。安装完成后,确认客户端能够正常启动内核,再导入订阅,别把程序启动成功直接当作代理已经生效。
桌面设备先看 v2rayN,安卓设备先看 v2rayNG;需要 V2Fly 内核时,再了解 v2flyNG。安装包取决于系统与处理器,连接方式取决于配置与内核。这两件事分开判断,就不容易选错。下载页集中列出具体入口与安装要求,首页只帮你确定方向。
客户端负责保存配置、启动内核和设置流量入口,不会凭空生成可用的远端服务。开始之前,你需要准备有权使用的订阅地址或服务器参数。已有旧配置时,先保留分组与自定义路由,再安装或迁移;第一次使用则先按教程完成单条连接验证,暂时不用同时开启所有高级选项。
桌面版采用跨平台界面,经典 WPF 版保留熟悉的操作布局。新安装可以先了解桌面版;已有使用习惯与配置时,先比较界面差异再决定。安装完成后,确认客户端能够正常启动内核,再导入订阅,别把程序启动成功直接当作代理已经生效。
先在系统的“关于本机”中确认芯片,再选 Apple Silicon 或 Intel 对应入口。导入订阅后,检查系统代理是否启用,以及浏览器是否沿用系统设置。需要 TUN 时再单独处理权限,首次连接不必把系统代理与虚拟网卡一起打开,避免出现难以分辨的变量。
v2rayNG 使用 Xray 内核,v2flyNG 提供 V2Fly 内核方向的备选。多数较新的手机可先看 arm64,架构不确定时查设备信息或考虑通用包。首次连接需要确认系统的 VPN 授权;之后如果切到后台就断开,再检查电池优化、后台权限和其他占用 VPN 通道的应用。
按发行版的软件包体系选择 deb 或 rpm,再核对处理器架构。图形客户端的系统代理设置未必覆盖终端程序,每个应用是否读取代理都要分别确认。若浏览器能访问而命令行不能,先看该程序的代理设置与环境,而不是直接更换整套服务器配置。
先分清三层:应用把请求交给本地入口,内核根据规则选择出口,DNS 为需要的连接提供解析结果。客户端把这些配置集中到图形界面;遇到问题时,沿这条路径检查,比反复导入同一条订阅更有效。
订阅把多条服务器配置集中到一个更新入口。先建立分组,再粘贴你有权使用的地址,更新后确认列表实际出现了配置。普通更新失败时,可以在已有连接可用的前提下尝试通过代理更新。订阅地址可能包含访问凭据,不适合贴到截图或公开日志中。与逐条手动录入相比,分组更容易保留来源和更新边界;但自定义备注、排序与路由应单独备份,避免把远端更新误当作本地设置的永久存档。右侧示例仅展示 JSON 中保存 URL 的形式,不是客户端订阅文件格式。
{
"url": "https://example.com/sub"
}
VMess、VLESS 与 Trojan 是不同的出站协议,不是可以随意互换的标签。导入后还要核对端口、传输方式以及 TLS 等安全设置;协议相同,也不代表所有参数都兼容。图形客户端便于保存和切换多种配置,实际能否运行仍由所选内核决定。先按服务端提供的完整参数使用,连接成功后再考虑调整传输选项。右侧是直连与阻断两种基础出站,适合先理解 tag 如何被路由引用;它不包含远端服务参数,不能替代可用的代理配置。
{
"outbounds": [
{
"tag": "direct",
"protocol": "freedom"
},
{
"tag": "block",
"protocol": "blackhole"
}
]
}
路由决定一条连接交给哪个出站,规则从上向下匹配,因此例外通常要放在宽泛规则之前。geosite 用于域名集合,geoip 用于地址集合,两者依赖相应数据库。开始时先保留少量明确规则,例如局域网地址直连,再逐项加入需要的域名。与全部流量使用同一出口相比,分流能减少对本地服务的干扰,但需要维护规则顺序与出站标签。示例中的 direct 必须在出站中真实存在;修改后用具体目标验证匹配结果,不要仅凭规则已保存就判断生效。
{
"routing": {
"domainStrategy": "IPIfNonMatch",
"rules": [
{
"type": "field",
"ip": ["geoip:private"],
"outboundTag": "direct"
}
]
}
}
DNS 配置不仅是填一个解析器地址,还涉及谁发起查询、查询经由哪条路径,以及结果如何参与路由。内核内置 DNS 不会自动接管系统里所有应用的解析。遇到域名访问失败时,先区分解析失败与连接失败,再检查查询策略和实际出口。相较于不断更换解析器,保持应用、系统和内核之间的边界清晰更有帮助。示例展示服务器列表与 IPv4 查询策略的写法,并非所有网络都适用的推荐值;修改前记录原设置,每次只动一项,才能判断变化来自哪里。
{
"dns": {
"servers": [
"1.1.1.1",
"localhost"
],
"queryStrategy": "UseIPv4"
}
}
系统代理让遵循系统设置的应用使用本地代理入口,TUN 则借助虚拟网络接口处理流量;两者的权限要求和影响范围不同。首次配置建议先用系统代理完成验证,再按实际需求了解 TUN。右侧是本地 SOCKS 入站示例,不是 TUN 配置;监听回环地址时只接受本机连接。与直接开放局域网监听相比,这个起点更容易控制访问范围。如果确实需要其他设备接入,还应一起检查防火墙、认证与网络边界,不能只把监听地址换成所有接口就结束。
{
"inbounds": [
{
"tag": "socks-in",
"listen": "127.0.0.1",
"port": 10808,
"protocol": "socks",
"settings": {
"udp": true
}
}
]
}
客户端界面与代理内核分别承担不同工作,界面中出现某个选项,不等于当前内核一定能识别对应字段。切换之前先确认配置使用的协议、传输和安全特性,再查看内核支持范围。与仅按名称判断相比,启动日志能更直接指出不支持的字段或参数。建议保留一份可用配置,切换后先运行最小连接测试,再恢复自定义路由与 DNS。右侧是常见日志级别示例,不是选择内核的开关;内核选择通常在客户端设置中完成,不能靠给 JSON 增加一个自造字段实现。
{
"log": {
"loglevel": "warning"
}
}
“V2Ray”在日常讨论中常被用作一个大类名称,但具体操作时,最好把项目生态、代理内核和图形客户端分开理解。Project V 提供了模块化代理工具的思路,入站接收请求,路由决定去向,出站执行连接。V2Fly 延续 V2Ray 的社区开发,Xray 则形成另一条内核分支。它们有共同的技术背景,也有各自演进的功能,不能把名称相近理解为配置始终通用。
客户端负责操作界面,内核负责处理连接。v2rayN 把订阅、服务器列表、系统代理与配置选项集中到桌面界面,再调用相应内核工作。v2rayNG 面向安卓设备,采用 Xray 内核;v2flyNG 则提供 V2Fly 内核路线。三款客户端都属于代码开源的软件项目。选择时先看设备,再看配置要求,没必要为了统一名称而在不同设备上强行追求完全相同的界面。
协议支持需要具体到特性。VMess、VLESS、Trojan 描述的是协议层面的选择,传输方式与 TLS、REALITY 等安全设置又是另外的维度。某条配置能否运行,取决于客户端能否正确导入、内核能否识别,以及服务端参数是否一致。看到“支持 VLESS”还不足以判断一条带特定传输与安全选项的配置是否兼容。遇到无法启动的情况,先看报错字段,再核对支持范围,比反复更换客户端更有针对性。
开源协议也要分项目看。v2rayN、v2rayNG 与 v2flyNG 采用 GPL 系列许可,V2Fly 与 Xray 内核项目采用 MPL 2.0。许可证说明源码使用、修改与分发的条件,并不等于远端服务的使用授权。你使用的订阅、服务器和网络仍有各自的管理边界。日常使用未必需要研究每条许可条款,但如果要重新分发、修改或集成代码,就应阅读相应项目的许可文本,而不是把“开源”简单理解为没有条件。
更新同样分层:客户端更新改变界面与集成功能,内核更新影响协议实现,订阅更新替换远端配置,规则数据库更新影响域名与 IP 集合。四种更新解决不同问题,不必在故障时一起执行。例如某个网站被错误分流,可以先检查规则顺序与数据库;若内核明确报告字段不受支持,再核对内核能力;如果只有一个订阅分组更新失败,则先检查地址、权限与更新路径。
保留能回退的配置,比追求一次设置到位更实际。调整前记下当前出站、路由模式、DNS 与代理入口,每次只改一组内容。确认浏览器访问正常后,再测需要使用的其他应用。对后台应用、游戏或命令行程序,不要默认它们都遵循系统代理;对 TUN,也不要默认开启后就覆盖了所有网络情形。流量入口、路由与解析都需要结合设备环境验证,界面上的开关状态只代表设置,不代表结果。
连接测试要读懂含义。TCPing 更接近端口连通性检查,真连接测试会继续涉及协议握手及测试目标。测试结果受到本地网络、服务端状态、解析与目标响应共同影响,单次成功不能代表所有应用都可用,单次失败也不能直接证明客户端有问题。你可以固定一套测试步骤:选中配置、启动内核、确认代理模式、访问预期目标,再对照日志检查。保持步骤一致,结果才有可比性。
这里的中文说明把“怎么操作”和“为什么这样配置”分开:教程讲安装后的连续步骤,配置参考解释字段和片段,疑难解答按症状收敛检查范围,技术笔记讨论某一项具体机制。本站是独立的客户端资料整理站,不是远端连接服务提供方。准备好你有权使用的配置后,可以先完成基础连接,再决定是否需要复杂分流;阅读顺序服务于眼前的问题,不必一次看完所有章节。
基础连接完成以后,再按问题深入。下面三篇分别解释首次验证、内核选择和 FakeDNS,避免把不同层面的设置混在一起调整。
解释 FakeDNS 如何用保留网段的虚拟地址换取域名信息,与 sniffing、TUN 模式如何配合,哪些场景值得开启、哪些情况反而会出问题。
阅读笔记:FakeDNS 工作原理梳理 Project V 之后 V2Fly 与 Xray 两条分支的形成过程,对比 VLESS、XTLS、REALITY 等特性支持差异,说明 v2rayNG 与 v2flyNG 该怎么选。
阅读笔记:Xray 与 V2Fly 内核区别导入订阅后先做什么:区分 TCPing 与真连接测试的结果含义,挑选可用节点,再用系统代理模式与浏览器访问检查确认流量确实走了代理。
阅读笔记:v2rayN 首次连接步骤