Skip to content

listen ​

会监听 socket 的入站共用的监听与承载字段。tap、tun、capture 没有普通监听 socket,不使用这里的字段。

yaml
inbounds:
  proxy:
    type: mixed
    listen: 127.0.0.1:7890
    interface: lo
    tcp_keep_alive: 5m
    tcp_keep_alive_interval: 75s
    tcp_multi_path: false
    proxy_protocol: false
    network: tcp
    udp_timeout: 5m
    full_cone: false

dns:
  servers:
    default: {type: udp, address: 127.0.0.1:53}
  final: default

字段 ​

listen ​

  • 类型:SocketAddr。
  • 必填:是。
  • 取值:IP 字面量和端口,例如 127.0.0.1:7890、[::]:443。
  • 行为:不在这里解析主机名。

interface ​

  • 类型:接口名。
  • 默认:不限定。
  • 行为:监听 socket 绑定到该接口。

tcp_keep_alive ​

  • 类型:时长。
  • 默认:不主动设置。

tcp_keep_alive_interval ​

  • 类型:时长。
  • 默认:系统默认。

tcp_multi_path ​

  • 类型:布尔值。
  • 默认:false。

tcp_congestion ​

  • 类型:字符串。
  • 默认:系统拥塞控制。
  • 限制:显式设置只在 Linux 上可用。

proxy_protocol ​

  • 类型:布尔值。
  • 默认:false。
  • 行为:每条 TCP 连接先读取 PROXY v1 或 v2 头,并用头里的客户端地址作为来源。
  • 限制:只接 UDP 的配置不能依赖它;头不完整或不合法时连接失败。

network ​

  • 类型:字符串枚举。
  • 默认:同时接受 TCP 和 UDP。
  • 取值:tcp、udp。
  • 限制:udp 只适用于 Shadowsocks 这类能直接接数据报的入站;其他代理只在流里承载 UDP。

udp_timeout ​

  • 类型:时长。
  • 默认:5m。
  • 限制:dns 和 direct 入站不接受。

full_cone ​

  • 类型:布尔值。
  • 默认:false。
  • 行为:同一客户端、同一路径的 UDP 对外共用一个映射。
  • 限制:dns 和 direct 入站不接受。

说明 ​

字段与入站自己的 type、协议字段平铺在一个映射里。解析器先取出监听和承载字段,再把剩余字段交给协议。

相关 ​

页面历史

开发者设计、代码地图和验证记录保留在仓库 manual/。