如何通过Docker-compose配置Fluent Bit解决容器日志驱动连接报错

问题根本原因 #

你遇到的连接拒绝报错主要来自两个核心误区：

1. depends_on 默认仅保证Fluent Bit容器启动完成，不会等待Fluent Bit进程实际完成24224端口监听，其他服务启动时Fluent Bit还没就绪就会报错
2. Docker的fluentd日志驱动是宿主机Docker daemon进程执行的，不属于容器网络栈范畴，你在容器内部配置的nginx代理、容器网络规则对日志驱动的连接请求完全不生效，daemon默认访问的127.0.0.1:24224就是宿主机的环回地址，不是容器内部的地址。

修复步骤 #

1. 修正Fluent Bit配置 #

首先确认你挂载的./fluent-bit/etc/fluent-bit.conf中已经开启Forward输入插件，且监听地址为0.0.0.0：

[INPUT]
    Name        forward
    Listen      0.0.0.0
    Port        24224

如果监听地址写127.0.0.1，宿主机Docker daemon无法访问容器内的端口，会直接拒连。

2. 给Fluent Bit服务加健康检查 #

修改docker-compose中fluentbit服务的配置，增加健康检查逻辑，确保端口就绪后再启动其他服务：

fluentbit:
  container_name: iris-fluent
  image: fluent/fluent-bit:latest
  restart: always
  networks:
    - iris-network
  volumes:
    - ./fluent-bit/etc:/fluent-bit/etc
  ports:
    - "24224:24224"
    - "24224:24224/udp"
  # 新增健康检查
  healthcheck:
    test: ["CMD", "nc", "-z", "127.0.0.1", "24224"]
    interval: 2s
    timeout: 3s
    retries: 10

3. 调整所有服务的日志驱动配置 #

给每个使用fluentd日志驱动的服务增加参数，避免启动时因连接失败直接报错，同时显式指定日志地址：

# 以clamav为例，其他服务（nginx、keycloak等）都按这个格式修改
clamav:
  # 原有配置保持不变
  depends_on:
    fluentbit:
      condition: service_healthy # 改为等待Fluent Bit健康检查通过
  logging:
    driver: fluentd
    options:
      fluentd-address: 127.0.0.1:24224
      fluentd-async-connect: "true" # 开启异步连接，启动时不会因连不上直接报错
      fluentd-retry-wait: 1s
      fluentd-max-retries: 10

4. 移除多余的Nginx代理配置 #

你之前配置的Nginx反向代理24224端口的逻辑完全多余，直接删除即可，不会影响日志上报。

关于localhost的疑问解答 #

Docker日志驱动的请求是由宿主机上运行的Docker daemon进程发起的，它访问的localhost就是宿主机的环回地址，不属于容器内部网络地址，你之前的Nginx代理仅对同Docker网络下的容器访问生效，对daemon的请求没有作用。

内容的提问来源于stack exchange，提问作者Alain P