Docker Compose栈内容器日志无法发送至Fluentd问题求助

核心问题1：容器间网络访问配置错误 #

你的one和two容器日志驱动里，fluentd-address用了localhost:24224——在Docker Compose默认桥接网络中，每个容器的localhost指向自身，而非宿主机或Fluentd容器。这就是为什么手动先启动Fluentd再启其他容器时偶尔能工作（Docker for Mac的网络特殊性可能让localhost临时映射到宿主机，但这不可靠），但批量启动时直接失败的核心原因。

核心问题2：depends_on不保证服务就绪 #

depends_on仅控制容器启动顺序，不会等待Fluentd服务完全就绪（比如forward插件完成端口监听初始化）。哪怕Fluentd容器启动了，服务可能还在加载配置，此时其他容器的日志驱动尝试连接会失败，默认的重试机制不足以覆盖这个初始化窗口。

具体修复步骤 #

1. 修正容器间Fluentd访问地址

修改one和two服务的logging配置，把fluentd-address改为服务名fluentd:24224（Docker Compose默认网络中，服务名可直接解析到对应容器IP）：

logging:
  driver: "fluentd"
  options:
    fluentd-async-connect: 'true'
    fluentd-address: fluentd:24224  # 替换原localhost地址
    tag: service.one

2. 增强日志驱动的重试机制

添加重试相关选项，确保连接失败后持续重试，覆盖Fluentd的初始化时间：

logging:
  driver: "fluentd"
  options:
    fluentd-async-connect: 'true'
    fluentd-address: fluentd:24224
    tag: service.one
    fluentd-retry-wait: '5s'       # 每次重试间隔
    fluentd-max-retries: '0'       # 0表示无限重试（避免日志丢失）
    fluentd-buffer-limit: '10m'    # 本地缓存日志的上限

3. 可选：添加Fluentd就绪检查（确保依赖可靠性）

在Fluentd服务中配置健康检查，只有当Fluentd完全就绪后，才启动其他容器：

fluentd:
  image: fluent/fluentd:v1.7-debian-1
  volumes:
    - ./fluentd/conf:/fluentd/etc
    - ./logs:/apps/logs
  ports:
    - "24224:24224"
    - "24224:24224/udp"
  healthcheck:
    test: ["CMD", "nc", "-z", "localhost", "24224"]  # 检查24224端口是否监听
    interval: 5s
    timeout: 3s
    retries: 5

同时修改one和two的depends_on，依赖Fluentd的健康状态：

depends_on:
  fluentd:
    condition: service_healthy

验证修复 #

执行docker-compose down清理旧容器，再运行docker-compose up -d，此时所有容器启动后，Fluentd应该能稳定接收one和two的日志，无需手动重启或--force-recreate操作。

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