V2Ray 配置文件 JSON 结构解析:inbounds、outbounds、routing 逐段读懂

按顺序拆解 V2Ray 配置文件的 log、inbounds、outbounds、routing 与 dns 各段,说明 tag 关联、规则匹配顺序与常见字段写法,配合片段示例对照理解。

本文速览

拿到客户端生成的 JSON,先认清哪一段接收请求、哪一段选择路径、哪一段建立连接。本文用本机 SOCKS 和 HTTP 入站演示标签如何串起规则,再区分路由阶段解析、出站解析与应用自行解析。示例端口仅用于说明,不是客户端默认值。

log:日志与配置骨架

顶层是一个 JSON 对象。log、routing、dns 在本文用法中都是对象;inbounds 和 outbounds 是数组,即使只有一项也保留方括号。顶层键的书写顺序不决定请求路径,但数组内的顺序可能有意义:规则按排列顺序匹配,没有命中规则时通常交给第一个出站。

应用请求本地入站规则匹配出站选择目标连接
{
  "log": {
    "loglevel": "warning"
  }
}

这只是日志片段。排错时可临时把 loglevel 改为 info,重载配置后用同一个应用复现一次;记录足够后恢复 warning。access 和 error 可指定对应日志的输出文件,但配置能被读取不意味着日志目录可写。若故障发生在启动阶段,先看客户端或启动进程提示,不要只等访问日志出现。分享日志前,遮盖订阅地址、认证字段和不宜公开的连接记录。

inbounds:监听地址、本地端口与标签

入站的 listen 和 port 指定监听地址与端口,protocol 决定应用必须使用哪种代理协议,settings 则由该协议解释。把应用的 HTTP 代理填到 SOCKS 端口,即使端口正在监听,也不能完成预期的协议握手。下面两项都只监听本机回环地址,不向局域网开放。

10808
示例 SOCKS 监听端口
10809
示例 HTTP 监听端口

SOCKS 入站

listen
127.0.0.1
port
10808
protocol
socks
tag
local-socks

在应用的 SOCKS 代理设置中填写此端口。

HTTP 入站

listen
127.0.0.1
port
10809
protocol
http
tag
local-http

在应用的 HTTP 代理设置中填写此端口。

先核对监听,再改路由

如果连接本机端口时就被拒绝,先确认内核已启动、端口未被其他进程占用,且应用填写的地址与实际监听地址一致。请求还没进内核,调高路由规则优先级也不会生效。

outbounds:出站协议与默认路径

出站的 protocol 决定如何处理已经接收的目标连接。freedom 用于直连,blackhole 用于阻断。tag 是配置内的引用名,不是协议名:把标签叫作 direct 不会自动开启直连,真正决定行为的是同一项里的 protocol。

{
  "outbounds": [
    {"tag": "direct", "protocol": "freedom", "settings": {}},
    {"tag": "blocked", "protocol": "blackhole", "settings": {}}
  ]
}

routing:标签关联与匹配顺序

routing.rules 自上而下检查,第一条命中的规则决定去向。规则中的 inboundTag 是入站标签数组,outboundTag 是一个出站标签字符串。不同匹配字段同时出现时,请求必须同时满足这些字段。下面第一条只阻断从 SOCKS 入站进入、且目标域名恰为 example.org 的请求;第二条让其余 SOCKS 请求直连。

{
  "routing": {
    "domainStrategy": "AsIs",
    "rules": [
      {
        "type": "field",
        "inboundTag": ["local-socks"],
        "domain": ["full:example.org"],
        "outboundTag": "blocked"
      },
      {
        "type": "field",
        "inboundTag": ["local-socks"],
        "outboundTag": "direct"
      }
    ]
  }
}
进入方式内核取得的目标预期出站
SOCKSexample.org第一条:blocked
SOCKSwww.example.org第二条:direct
HTTPexample.org无匹配:第一个出站 direct

如果交换两条规则,旧的第二条会先接住全部 SOCKS 请求,精确域名规则就没有机会命中。若交换两个出站而保留规则顺序,已明确指定标签的请求仍走原路径,但没有匹配规则的 HTTP 请求会改走新的第一个出站。排查误分流时,分别检查这两处数组顺序,不要把默认出站误认为最后一条路由规则。

dns:区分路由解析与应用解析

顶层 dns 配置的是核心内置 DNS,不是操作系统的全局 DNS 设置。仅添加 dns.servers,不会自动接管所有应用的查询。应用若先解析域名,再只把目标 IP 交给代理,路由就不能仅凭这个 IP 还原原始域名;没有其他域名信息时,上面的精确域名条件不会命中。

{
  "dns": {
    "servers": ["localhost"]
  }
}

这里用 localhost 调用本机解析能力,便于沿用系统已有的解析配置。它不表示在本机端口启动 DNS 服务,也不决定最终连接走哪个出站。若要核对域名规则,先确认测试请求是把域名交给入站,还是在应用侧已经换成了 IP。

配置排错:按启动、入站、路由、出站检查

  1. 先查实际加载的文件。 严格 JSON 使用双引号,最后一项不带尾逗号。上面的代码块分别展示不同顶层字段,不能直接拼接多个根对象。报错若指向某个字段,即使文件是合法 JSON,也仍要检查该字段的类型与核心支持情况。
  2. 确认核心与客户端设置的边界。 v2rayN 桌面端可从「设置」→「参数设置」核对本地监听配置,具体分组以当前版本为准。安卓 v2rayNG 使用 Xray 内核,v2flyNG 使用 V2Fly 内核;基础字段相似不代表扩展字段通用。安卓通过 VPN 接管流量的范围也不能用桌面系统代理设置来推断。
  3. 让同一个测试应用只改一项。 先通过正确的端口验证普通请求,再验证阻断目标。若应用切换到 HTTP 代理后结果不同,先对照入站标签;若同一入站下域名与 IP 请求结果不同,再检查应用把哪种目标形式交给了核心。
  4. 最后检查出站连接。 命中预期标签只说明选对路径,不代表目标一定可达。直连失败时检查本机解析和目标可达性;远端出站失败时,再核对远端端口、协议参数和传输设置。一次只修改一处,重载后重复同一测试,才能定位是哪项变化影响了结果。
客户端下载按平台选择 v2rayN / v2rayNG