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

以一份精简示例配置为线索,逐段解释 log、inbounds、outbounds、routing、dns 各字段的作用,帮你看懂客户端导出的完整配置。

本文速览

拿到 v2rayN 导出的核心配置后,先找本机监听端口,再顺着规则里的标签定位实际出站。本文用一份直连与拒绝并存的样例,说明如何读默认出站、区分 DNS 与路由问题,并判断应该修改客户端设置还是检查核心日志。

V2Ray JSON 示例:先看连接流向

先把配置读成一条连接的路径。inbounds 定义核心从哪里接收连接,routing 决定连接交给谁,outbounds 定义接手后怎么处理。log 和 dns 是辅助配置,不是每条连接都要依次经过的两站。

应用请求本地入站路由匹配出站处理

下面使用 V2Fly V2Ray 传统 JSON 写法。样例不需要远端账户,也不依赖规则数据文件。应用必须主动连接本地 SOCKS 入口才会进入这条路径;启动核心本身不会修改系统代理。示例端口是教学值,不代表 v2rayN 的默认设置。

{
  "log": {
    "loglevel": "warning"
  },
  "inbounds": [
    {
      "tag": "local-socks",
      "listen": "127.0.0.1",
      "port": 10808,
      "protocol": "socks",
      "settings": {"auth": "noauth", "udp": false}
    }
  ],
  "outbounds": [
    {"tag": "direct", "protocol": "freedom"},
    {"tag": "reject", "protocol": "blackhole"}
  ],
  "routing": {
    "domainStrategy": "AsIs",
    "rules": [
      {
        "type": "field",
        "inboundTag": ["local-socks"],
        "domain": ["full:example.org"],
        "outboundTag": "reject"
      }
    ]
  },
  "dns": {
    "servers": ["localhost"]
  }
}
10808
示例 SOCKS 监听端口
2
出站:直连与拒绝
1
显式路由规则

客户端保存的应用设置、订阅内容和核心启动时读取的 JSON 是不同层次的数据。若 v2rayN 在切换活动配置后重新生成核心文件,手工改动可能会被覆盖。对照实际加载的配置,不要只凭文件名判断哪份 JSON 在生效。

inbounds 与 outbounds:核对监听地址和出站协议

遇到应用连不上时,先核对入口。示例只在 IPv4 回环地址 127.0.0.1 监听;应用应选择 SOCKS5,而不是把同一端口填成 HTTP 代理。noauth 表示这个入口不要求 SOCKS 认证,并不适合直接开放给局域网。udp: false 则意味着不能用这份样例验证 SOCKS UDP 转发。

应用侧:SOCKS 入站

listen
127.0.0.1
port
10808
protocol
socks
tag
local-socks

应用连接的是监听地址和端口,不是入站标签。

核心侧:直连出站

protocol
freedom
tag
direct
数组位置
outbounds 第一项

标签是引用名,真正决定处理方式的是协议及其设置。

如果实际导出里发现 vmess 或 vless 出站,要把应用连接的本地端口与出站配置里的远端服务器端口分开看。settings 随协议而变;streamSettings 则用于描述传输与安全设置。连接远端时,这些设置要和对端相符,不能把一条出站的协议字段换掉,却沿用另一条出站的设置结构。V2Fly 与 Xray 支持的字段和取值也可能不同,应按实际运行的内核及版本核对。

routing:按顺序匹配,未命中走默认出站

对样例中的普通出站规则,核心按数组顺序检查,第一条匹配的规则决定去向。同一规则里,inboundTag 和 domain 是同时成立的条件;outboundTag 是匹配后的动作。full:example.org 只匹配该域名本身,不包括子域名。

核心收到的目标样例结果判断依据
example.orgreject从指定入站进入,且完整域名匹配。
www.example.orgdirect子域名不满足完整匹配,回到第一条出站。
应用预先解析后的目标 IPdirect样例未启用嗅探,单凭目标 IP 不会命中这条域名规则。

规则没生效,先确认核心收到的是域名还是 IP

测试域名规则时,让应用以域名形式提交 SOCKS 请求。若应用先完成解析,只把 IP 交给核心,先调整测试方式,不要直接放宽分流规则。

读有多条规则的配置时,除了检查标签拼写,还要检查前面的宽泛规则是不是已经截住请求。例如,仅限定某个 inboundTag 的规则放在前面,会先接管该入口的连接,后面的域名规则就没有机会匹配。没有任何规则命中时,本例使用 outbounds 第一项;如果把拒绝出站挪到第一项,未命中的连接也会走拒绝。

dns:区分本地解析、路由解析与出站解析

dns.servers 配置的是核心内置 DNS 模块使用的解析来源。这里的 localhost 是使用本机系统解析机制的写法,不是要求在回环地址另开一个 DNS 服务,也不会自动替应用接管 DNS。是否触发这个模块,要结合核心的路由和出站设置判断。

排查时保留同一应用、同一入口和同一测试域名。先确认失败是在解析阶段,还是已选中出站后才发生。若日志显示请求已进入 reject,应回看路由规则,而不是继续换解析器。反过来,能访问某个 IP 也不能证明域名解析正常,更不能证明以该域名访问时的 TLS 验证会通过。

log 与配置排查:从启动错误查到规则命中

示例把 log.loglevel 设为 warning,适合先看告警和错误,但不应期待它显示每条连接的路由细节。需要更多线索时,可在测试副本中临时调到 info,复现一次后恢复。核心日志可能包含目标域名、地址和连接时间;对外分享前要删除敏感内容,也不要附上订阅地址或账户字段。

  1. 核心启动失败:先检查标准 JSON 语法。对象键和字符串使用双引号,最后一项不留尾随逗号。再确认核心是否支持该协议、传输和字段;能被 JSON 解析器读入,不等于核心可以加载。
  2. 已启动但连接被拒:核对实际监听地址、端口和代理类型。若日志提示地址已被占用,先确认是不是 v2rayN 的现有核心进程或其他应用占用了示例端口。改端口时,核心和测试应用要一起改。
  3. 应用走错出口:确认应用确实使用这个 SOCKS 入口,再逐条读 rules,对照入站标签、目标形式与出站标签。检查未匹配请求时,直接看出站数组的第一项。
  4. 设置保存后又变回去:先确认改的是客户端持久设置,还是随启动生成的临时文件。常用分流规则优先在客户端的路由设置里维护;测试 JSON 另存副本,每次只改一处,再对照日志验证变化。
下载v2rayN平台与安装包选择