参考 inbounds / routing / outbounds 配置逐段讲解

v2rayN 下载与 V2Ray 配置参考

整理四平台客户端入口,以真实配置字段说明订阅导入、代理模式与路由规则。

代码开源 Xray / V2Fly 内核 JSON 配置参考

V2Ray 客户端下载入口

先确认操作系统与处理器架构,再选择客户端和安装格式。

Windows v2rayN · Desktop / WPF

桌面优先选择 v2rayN。Desktop 使用跨平台界面,WPF 保留经典桌面操作方式。两者都围绕服务器列表、订阅分组与路由设置组织操作,选择时先看界面习惯,再确认安装要求。

首次启动后,先导入已有订阅或分享链接,再选择活动服务器。设置系统代理前确认本地监听端口,退出时恢复代理设置,避免应用继续访问已经停止的本地服务。

前往下载
macOS v2rayN · Apple Silicon / Intel

使用 v2rayN 的桌面界面管理配置。在“关于本机”查看芯片信息:Apple Silicon 对应 arm64,Intel 处理器对应 x64。安装格式相同不代表处理器架构相同,应先确认芯片再下载。

导入配置后先测试普通系统代理。需要接管不读取系统代理设置的应用时,再查阅 TUN 模式要求。系统权限、网络服务与客户端内核是三个不同的检查位置,不宜同时更改。

前往下载
Android v2rayNG / v2flyNG

优先使用基于 Xray 内核的 v2rayNG;需要 V2Fly 配置兼容性时,再考虑 v2flyNG。主流较新手机通常选择 arm64,不能确定架构时可查看设备信息,或选择体积更大的通用安装包。

首次连接需要确认系统的 VPN 授权。同一时间运行其他占用该接口的应用,可能影响连接。若后台连接中断,先检查系统电池管理和后台运行权限,再判断是否属于服务器问题。

前往下载
Linux v2rayN · deb / rpm

使用 v2rayN 图形界面管理服务器与订阅。Debian、Ubuntu 系发行版通常选择 deb;采用 RPM 包管理体系的发行版选择 rpm。同时区分 x64 与 arm64,安装格式不能替代架构选择。

桌面环境的系统代理支持程度可能不同。浏览器可用而其他程序不能连接时,应检查该程序是否读取桌面代理设置。TUN 还涉及权限、路由与 DNS,不应仅凭安装成功判断接管已经生效。

前往下载

V2Ray 配置结构

从本地监听到远端出站,按字段理解每一段流量处理过程。

inbounds:应用流量的入口

入站定义内核接收流量的方式。常见本地配置使用 SOCKS 监听,并将地址限制为回环接口。应用需要把代理地址与端口指向这里,流量才会进入后续路由。端口已被占用时,应先检查其他客户端或重复启动的进程,而不是更换远端服务器。与只提供连接按钮的使用方式相比,查看入站字段可以区分“应用没有交给代理”和“代理已经接收但出站失败”这两类问题。

{
  "inbounds": [{
    "tag": "socks-in",
    "listen": "127.0.0.1",
    "port": 10808,
    "protocol": "socks",
    "settings": { "udp": true }
  }]
}

阅读顺序建议从入站开始:先确定应用把连接送到哪里,再看路由如何选择出站,最后核对远端协议与解析方式。客户端界面的订阅、测速、系统代理属于管理与系统集成功能,不一定对应内核配置中的同名字段。区分这两层,才能判断某个问题应该修改界面选项、运行配置,还是操作系统设置。

Project V、V2Fly 与 Xray 内核生态

客户端提供操作界面,内核执行协议、路由和解析。两者分别更新,也分别影响兼容性。

Project V:模块化代理配置的背景

Project V 是理解 V2Ray 生态的起点。其配置思路不是把全部功能收进一个服务器地址,而是将接收连接、匹配规则、建立出站和处理解析分开描述。一个运行实例可以同时配置多个入站和多个出站,再通过标签建立引用。对日常用户而言,图形客户端隐藏了大部分配置细节;对需要排查问题的用户而言,这些边界正好提供了逐段检查的顺序。

“V2Ray 客户端”通常是一个类别名称,并不表示所有应用都使用完全相同的内核和设置格式。同样一条分享链接,客户端需要先识别协议及附加参数,再转换成实际运行配置。遇到导入失败时,应先确认分享格式是否受支持;导入成功但启动失败时,再检查内核能否识别生成的字段。这比反复切换代理模式更接近问题发生的位置。

V2Fly 与 Xray:共同来源,不同演进

V2Fly 延续了 V2Ray 的社区维护路线,Xray 则从相关代码基础发展出自己的实现与扩展。两者在不少基础概念上相通,例如入站、出站与路由标签,但协议扩展、传输选项、DNS 行为和字段支持并不总是同步。某份配置在一个内核中能够运行,不代表直接复制到另一个内核后也会得到相同结果。

例如,使用 REALITY 或 XTLS Vision 相关参数时,需要检查当前内核是否具备相应能力,以及服务端要求的组合是否一致。选择内核的依据应是配置所需功能和客户端集成情况,而不是仅看产品名称。排查前记录当前客户端、实际启动的内核及其设置入口,能避免拿一套实现的文档解释另一套实现的报错。

三款客户端:平台与内核的对应关系

v2rayN、v2rayNG 与 v2flyNG 都是代码开源的图形客户端。桌面使用 v2rayN 管理服务器、订阅与路由;Android 优先考虑采用 Xray 内核的 v2rayNG,v2flyNG 则面向 V2Fly 内核使用需求。这里的选择首先取决于操作系统,其次取决于协议能力和配置兼容性,并不是把三款软件按同一套性能指标简单排序。

v2rayN 的界面设置还可能影响运行时使用的组件。选择服务器后,应留意其协议与客户端实际调用的内核是否匹配。移动端则还要考虑系统 VPN 接口、应用分流和后台限制。把桌面的本地 SOCKS 端口照搬到手机界面,并不能替代移动系统的流量接管过程;相同服务器参数在不同平台上需要配合各自的网络入口。

客户端选型指南集中比较这三款软件的适用平台、配置方式与使用边界。已有可以正常工作的配置时,不必为了统一界面而同时更换客户端、内核和路由方案。每次只改变一项,保留原有设置,才能在结果发生变化时判断原因。

开源协议:客户端与内核分别阅读

代码开源意味着项目按照相应许可证公开源代码和使用条件,但客户端、内核与附带组件可能采用不同许可。V2Fly 核心使用 MIT 许可,Xray 核心使用 MPL-2.0;客户端还应查看各自随发行内容提供的许可文本。个人使用、修改源码和重新分发是不同情形,不能仅凭“开源”两个字推导所有权利与义务。

对普通安装使用,重点是确认软件名称、平台与组件说明。对需要再分发或修改的工程场景,应逐项阅读适用许可,保留要求保留的声明。开源属性也不替代配置审查:路由会把流量交给哪里,订阅会更新哪些服务器,允许哪些地址访问本地监听端口,都由实际配置决定,需要在运行环境中确认。

更新机制:程序、内核、订阅、规则分开处理

客户端更新负责界面与配置生成逻辑,内核更新影响协议实现,订阅更新刷新服务器条目,规则资源更新则影响域名或地址分类。这四种操作解决的问题不同。新协议字段无法识别时,先查内核支持;订阅中的服务器地址变化时,更新对应分组;规则文件缺失时,检查资源设置与运行日志,而不是只重装客户端。

调整之前可保留现有配置与自定义规则。更新后先验证活动服务器能启动,再确认系统代理或 TUN 是否按预期接管,最后测试常用应用和局域网访问。如果同时更换内核、清空订阅并重写 DNS,即使连接恢复,也很难确定有效的修改是哪一项。保留清晰的操作顺序,比频繁尝试互不相关的开关更利于长期维护。

连接验证:区分测速、握手与实际请求

服务器列表中的测试结果只代表某一种测试条件。端口能够建立连接,不能证明协议握手必然成功;握手成功,也不能证明目标网站的解析和路由都正确。使用 V2Ray 节点测速时,应先了解测试使用的目标和方式,再结合实际请求判断。不要把单个测试结果当作所有应用都能访问的结论。

建议按固定顺序验证:先看客户端是否启动内核,再用明确设置了代理的应用发起请求,随后检查系统代理,最后测试 TUN。每一步都保留对应日志。出现超时先确认请求停在哪一段,出现握手错误再核对身份、安全和传输字段。日志中的本地端口、出站标签与目标域名,通常比笼统的“连接失败”提示更有定位价值。

代理模式:接管范围与分流策略不是一件事

系统代理决定遵循该设置的应用是否把连接交给本地代理;路由策略决定进入内核的流量走哪个出站。界面中的“全局”通常指向一种路由选择,并不必然覆盖所有进程。某个应用不读取系统代理时,即使选择全局路由,它的连接仍可能没有进入内核。需要扩大接管范围时,再评估 TUN,而不是只重复切换分流规则。

因此,排查“浏览器正常、其他程序失败”应先看接管入口;排查“部分域名走错路径”应看规则顺序和 DNS。桌面操作可先阅读 系统代理与全局代理说明,移动端则结合 v2rayNG 使用教程检查系统授权与应用范围。更多具体问题集中在 FAQ,配置字段的默认值与引用关系则在 配置参考中逐段说明。

协议、配置与使用文章

按具体问题继续阅读:身份字段、客户端操作与协议选择。