V2Ray 配置文件结构逐段解析:inbounds、outbounds 与 routing 各管什么

先看全局：配置文件不是一条节点

inbounds：流量从本机哪里进入

{
  "tag": "socks-in",
  "listen": "127.0.0.1",
  "port": 10808,
  "protocol": "socks",
  "settings": {
    "auth": "noauth",
    "udp": true
  },
  "sniffing": {
    "enabled": true,
    "destOverride": ["http", "tls"]
  }
}

• tag 只需在当前配置内保持唯一，名称可以是 socks-in、lan-in 等可读短语。
• 系统代理只会把支持系统代理设置的流量送进 HTTP 或 SOCKS 入口，不等于捕获所有程序流量。
• 端口修改后，调用方也必须同步修改；只改核心配置而不改系统代理，会表现为立即拒绝连接。
• UDP 是否能正常工作，还取决于应用、入站协议、出站协议和服务端配置。

outbounds：节点、直连与阻断出口

routing：按顺序把请求交给指定出口

{
  "domainStrategy": "IPIfNonMatch",
  "rules": [
    {
      "type": "field",
      "protocol": ["bittorrent"],
      "outboundTag": "block"
    },
    {
      "type": "field",
      "ip": ["geoip:private"],
      "outboundTag": "direct"
    },
    {
      "type": "field",
      "domain": ["geosite:cn"],
      "outboundTag": "direct"
    },
    {
      "type": "field",
      "network": "tcp,udp",
      "outboundTag": "proxy"
    }
  ]
}

一份可读的最小客户端配置

{
  "log": {
    "loglevel": "warning"
  },
  "inbounds": [
    {
      "tag": "socks-in",
      "listen": "127.0.0.1",
      "port": 10808,
      "protocol": "socks",
      "settings": {
        "auth": "noauth",
        "udp": true
      },
      "sniffing": {
        "enabled": true,
        "destOverride": ["http", "tls"]
      }
    }
  ],
  "outbounds": [
    {
      "tag": "proxy",
      "protocol": "vmess",
      "settings": {
        "vnext": [
          {
            "address": "server.example.com",
            "port": 443,
            "users": [
              {
                "id": "00000000-0000-4000-8000-000000000000",
                "alterId": 0,
                "security": "auto"
              }
            ]
          }
        ]
      },
      "streamSettings": {
        "network": "ws",
        "security": "tls",
        "tlsSettings": {
          "serverName": "server.example.com"
        },
        "wsSettings": {
          "path": "/v2ray"
        }
      }
    },
    {
      "tag": "direct",
      "protocol": "freedom",
      "settings": {}
    },
    {
      "tag": "block",
      "protocol": "blackhole",
      "settings": {}
    }
  ],
  "routing": {
    "domainStrategy": "IPIfNonMatch",
    "rules": [
      {
        "type": "field",
        "protocol": ["bittorrent"],
        "outboundTag": "block"
      },
      {
        "type": "field",
        "ip": ["geoip:private"],
        "outboundTag": "direct"
      },
      {
        "type": "field",
        "domain": ["geosite:cn"],
        "outboundTag": "direct"
      },
      {
        "type": "field",
        "network": "tcp,udp",
        "outboundTag": "proxy"
      }
    ]
  }
}

1. 先检查 JSON 语法，尤其是双引号、逗号和方括号是否成对。
2. 再核对所有 tag 是否唯一，routing 引用的 outboundTag 是否真实存在。
3. 确认入站端口未被占用，并让系统代理或应用指向相同端口。
4. 核对代理出站的协议、服务器端口、传输方式与安全层是否成套对应。
5. 最后检查规则顺序，确认兜底规则位于更具体的规则之后。

图形客户端与核心 JSON 怎么对应

按日志顺序排查启动失败与分流错误

• 出现 JSON 解析错误：检查报错行附近的逗号、双引号、数组与对象闭合符号。
• 核心启动但端口未监听：检查 listen、port 以及端口占用，确认没有两个入站使用同一地址和端口。
• 应用立即提示拒绝连接：核对应用代理地址是否为 127.0.0.1，端口是否与实际入站一致。
• 节点可连接但分流错误：按 routing.rules 从上到下检查，确认目标先命中了哪条规则。
• 域名规则始终不命中：检查 sniffing 是否启用、DNS 是否返回预期结果，以及规则使用的是域名还是 IP 条件。
• 只有部分 UDP 应用失败：确认 SOCKS 入站允许 UDP，并检查出站协议、服务端与网络是否共同支持该流量。

{
  "log": {
    "loglevel": "info"
  }
}