V2Ray 配置文件 JSON 结构拆解:inbounds、outbounds 与 routing 各段含义

逐段解读 V2Ray 配置 JSON:log、inbounds 本地监听、outbounds 出站与 freedom/blackhole、routing 规则匹配顺序,配合可对照的示例片段。

本文速览

适合已经用 v2rayN 导入订阅、开始阅读核心配置的用户。本文用一份只有本地入口和两个出站的 JSON,说明端口填在哪里、规则如何引用出站,以及未命中规则时请求会走哪条路径。示例不需要远端节点,也不应直接覆盖日常配置。

顶层结构:把一条请求从入口读到出口

应用请求本地入站规则匹配指定出站

读配置时先找应用实际连接的地址和端口,而不是先找订阅里的服务器地址。应用把请求交给入站后,核心才拿请求携带的目标信息匹配路由。规则选出出站,出站再决定直连目标、经远端代理转发,还是终止请求。

最小 JSON:两个本地入口与两个出站

下面使用 V2Ray v4 风格的 JSON 字段。示例把 SOCKS 和 HTTP 入口分开,便于在应用里分别验证。端口是本文为演示选用的值,不代表 v2rayN 的默认设置;若端口已被占用,应同时修改配置和应用端填写的端口。

10808
示例 SOCKS 监听端口
10809
示例 HTTP 监听端口
2
示例出站数量
{
  "log": { "loglevel": "warning" },
  "inbounds": [
    {
      "listen": "127.0.0.1",
      "port": 10808,
      "protocol": "socks",
      "tag": "local-socks",
      "settings": { "auth": "noauth", "udp": false }
    },
    {
      "listen": "127.0.0.1",
      "port": 10809,
      "protocol": "http",
      "tag": "local-http",
      "settings": {}
    }
  ],
  "outbounds": [
    { "protocol": "freedom", "tag": "direct", "settings": {} },
    { "protocol": "blackhole", "tag": "block", "settings": {} }
  ],
  "routing": {
    "domainStrategy": "AsIs",
    "rules": [
      {
        "type": "field",
        "domain": ["full:example.org"],
        "outboundTag": "block"
      }
    ]
  }
}

这份配置只有一条规则:核心收到的目标域名恰好是 example.org 时选中 block,其余请求落到首个出站 direct。示例不包含 DNS 分流、远端节点或流量嗅探。保存为 JSON 时,不要给最后一个数组元素加尾逗号,也不要在代码中插入说明性注释。

inbounds 和 log:先确认应用接入了核心

listen 决定核心在哪个本地地址接收连接。这里使用回环地址 127.0.0.1,只供本机应用访问。不要为了排查连接失败就改成 0.0.0.0:那会扩大入口的监听范围,而示例并未配置代理认证。

  1. 核对入口协议。 应用选择 HTTP 代理时填 127.0.0.1:10809;选择 SOCKS5 时填 127.0.0.1:10808。本地入口用 HTTP 不代表只能访问 HTTP 网页,支持 CONNECT 的应用也可经该入口访问 HTTPS 目标。示例的 SOCKS 入口关闭了 UDP。
  2. 核对测试应用是否遵循代理设置。 系统代理只是向遵循该设置的应用提供入口,不能保证所有流量都会进入核心。验证时优先用能单独指定代理的应用,以免把绕过代理的访问结果当成路由结果。
  3. 核对核心日志。 warning 用于日常记录警告及更严重的问题。排查时可临时改成 debug,重载后重试一次,再恢复原级别。端口绑定失败应先解决监听冲突;日志中没有请求记录也不能单凭这一点判定入站失败,要结合日志级别和应用设置。

outbounds:协议定义行为,标签供规则引用

freedom 让核心直接连接目标,仍受本机网络和解析结果影响。它不是让应用绕过本地代理:应用已经把请求交给核心,只是核心没有再把请求转交给远端代理。blackhole 则用于终止匹配的流量;应用可能看到连接关闭或请求失败,不一定会显示一个明确的拦截页面。

protocol
决定出站实现。订阅生成的远端代理出站可能使用 VMess;远端地址和协议参数属于该出站,不是本地监听参数。协议专用的 settings 不能从 freedom 原样搬过去。
tag
是配置内的引用名称。direct 和 block 不是协议关键字。若把 block 改名,必须同步修改引用它的 outboundTag,并保持出站标签唯一。
数组顺序
当没有规则命中时,首个出站接收请求。把 blackhole 移到本例首位,会让原本应直连的未匹配请求也被终止。

routing:按顺序匹配,不按规则精确度排名

核心从上到下检查 routing.rules,使用第一条满足条件的规则。若同一条规则同时配置了 inboundTag 和 domain,两项都要匹配。比如给示例规则增加 "inboundTag": ["local-http"] 后,从 SOCKS 入口进入的相同域名就不会命中该规则。

核心收到的目标是否命中示例出站
example.org命中完整域名block
www.example.org未命中,子域名不等于完整域名direct
example.com未命中direct
字面 IP 地址未命中,示例不恢复目标域名direct

结论:先确认核心收到的是域名还是 IP

如果用 SOCKS 测试域名规则,选择能把目标域名交给 SOCKS5 代理的客户端选项。若应用已在本地解析并只提交 IP,先修正测试入口,再调整规则。AsIs 不为路由匹配主动解析域名,也不负责从 IP 反推出原域名。

若要覆盖根域和子域,可改用 domain:example.org。如果前面已经存在一条涵盖同一目标的宽规则,例如把该域及所有子域送往直连,后面的 full:example.org 拦截规则不会得到执行。要保留这个例外,就把完整域名规则放在宽规则之前。

v2rayN 配置常见问题

为什么手改 JSON 后,切换节点就恢复了?

先确认编辑的是独立配置还是 v2rayN 生成的运行文件。对于生成的文件,切换节点或重新启动核心时可能被重建。要长期修改普通节点的路由,使用客户端的路由设置;要单独验证整份 JSON,保留独立副本并用对应核心加载。

能把这段 JSON 直接填进订阅地址吗?

不能。订阅地址用于获取节点列表,本例是供核心读取的配置对象。先核对当前节点类型和内核,再决定是在 v2rayN 中调整路由,还是独立加载配置。不要把不同内核的字段名视为可互换。

改完以后两个测试域名都打不开,先查哪里?

先检查核心是否成功加载,再用同一应用、同一代理入口测试 example.com。它应选中 direct,但仍要求本机能解析并连接目标。确认这一对照请求后,再测试 example.org;仅凭两个页面都打不开,不能证明拦截生效。

下载v2rayN