Skip to content

fallback ​

入站认出连接不属于自己的客户端时,不断开,而是把已读字节和其余连接交给一个真实站点。

yaml
inbounds:
  proxy:
    type: http
    listen: 127.0.0.1:8080
    fallback:
      server: 127.0.0.1:8080
      proxy_protocol: 2
      alpn:
        h2: 127.0.0.1:8443

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

字段 ​

server ​

  • 类型:端点字符串。
  • 必填:映射形式必须写;也可以直接写 fallback: host:port。
  • 行为:未命中连接要去的真实站点。

proxy_protocol ​

  • 类型:整数。
  • 必填:可选。
  • 取值:1、2。
  • 行为:先向真实站点发送对应版本的 PROXY 头,写明客户端;不写则不发。

alpn ​

  • 类型:协议名到端点的映射。
  • 默认:空。
  • 行为:TLS 协商出的协议若有专用端点,就把连接送到那里。

detour ​

  • 类型:出站名。
  • 必填:可选。
  • 限制:fallback 站必须直接拨号,所以运行时拒绝 detour。

domain_resolver ​

  • 类型:DNS 服务器名。
  • 必填:可选。
  • 默认:route.default_domain_resolver。

domain_strategy ​

  • 类型:字符串枚举。
  • 取值:as_is、prefer_ipv4、prefer_ipv6、ipv4_only、ipv6_only。

interface ​

  • 类型:接口名。
  • 默认:系统选择。

mark ​

  • 类型:32 位无符号整数。
  • 默认:不设置。

bind_address ​

  • 类型:IP 地址或数组。
  • 默认:系统选择。

connect_timeout ​

  • 类型:时长。
  • 默认:15s。

tcp_keep_alive ​

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

tcp_keep_alive_interval ​

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

tcp_multi_path ​

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

tcp_congestion ​

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

说明 ​

只接受 fallback 的入站协议和位置见各入站页;未配置 fallback 时,未认证或未命中的连接按该协议自己的失败方式结束。PROXY 头、TLS ALPN 和协议自身 fallback 分别工作在不同层。

相关 ​

页面历史

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