Bitnami Fluentd 镜像文档

镜像概述和主要用途

什么是 Fluentd？

Fluentd 从各种数据源收集事件，并将其写入文件、关系型数据库、NoSQL、IaaS、SaaS、Hadoop 等目标。

Fluentd 概述
商标声明：本软件列表由 Bitnami 打包。所提及的 respective 商标归各自公司所有，使用这些商标并不意味着任何关联或背书。

Bitnami Fluentd 镜像是基于 Bitnami 安全镜像标准构建的容器化解决方案，旨在提供轻量、安全、易于部署的 Fluentd 日志收集服务。该镜像适用于开发和生产环境中的日志聚合、转发和处理场景。

核心功能和特性

Fluentd 核心功能

• 多源日志收集：支持从文件、网络、容器、应用程序等多种数据源采集日志。
• 灵活的日志处理：提供丰富的过滤器、解析器和格式化器，支持日志结构化和转换。
• 多目标输出：可将日志转发至文件、数据库、云服务（如 AWS S3、Elasticsearch）等目标。
• 高可用性：支持分布式部署和故障转移，确保日志数据不丢失。

Bitnami 镜像特性

• 安全强化：基于最小化操作系统（Photon Linux）构建，减少攻击面，符合行业安全标准。
• 供应链透明：提供软件物料清单（SBOM）、漏洞可利用性交换（VEX/KEV）报告，支持 CVE 风险评估。
• 持续更新：上游补丁发布后数小时内完成镜像更新，确保安全性和稳定性。
• 一致性部署：与 Bitnami 虚拟机、云镜像使用相同的组件和配置策略，支持多环境无缝切换。
• 非 root 用户运行：默认以非特权用户运行，增强容器安全性（生产环境推荐配置）。

使用场景和适用范围

• 容器化环境日志收集：在 Kubernetes、Docker Swarm 等容器平台中聚合容器日志。
• 应用程序日志集中管理：收集分布式应用的多实例日志，统一存储和分析。
• 日志转发与过滤：对原始日志进行过滤、结构化处理后转发至 Elasticsearch、Splunk 等分析平台。
• 开发环境快速部署：通过容器化方式快速搭建日志收集管道，简化开发测试流程。
• 生产环境日志可靠性保障：结合 Bitnami 安全镜像的加固特性，满足生产级日志处理的安全需求。

使用方法和配置说明

获取镜像

推荐方式：拉取预构建镜像

从 Docker Hub 拉取最新版 Bitnami Fluentd 镜像：

docker pull bitnami/fluentd:latest

如需使用特定版本，可指定标签（查看 可用版本列表）：

docker pull bitnami/fluentd:[TAG]

手动构建镜像

如需自定义构建，可克隆 Bitnami 容器仓库并执行构建命令：

git clone [***]
cd containers/bitnami/fluentd/[VERSION]/[DISTRO]  # 替换为实际版本和发行版
docker build -t bitnami/fluentd:latest .

快速启动

使用默认配置启动 Fluentd 容器：

docker run --name fluentd bitnami/fluentd:latest

默认情况下，容器会监听 24224 端口（TCP/UDP），并将日志存储至容器内 /opt/bitnami/fluentd/log 目录。

网络配置

容器间网络通信

通过 Docker 网络实现 Fluentd 与其他容器的通信，步骤如下：

1. 创建自定义网络：

   docker network create fluentd-network --driver bridge
   

2. 将 Fluentd 容器加入网络：

   docker run --name fluentd-node1 --network fluentd-network bitnami/fluentd:latest
   

3. 其他容器通过容器名称（作为 hostname）访问 Fluentd：

   docker run --name app --network fluentd-network [APP_IMAGE]  # 应用容器通过 fluentd-node1:24224 发送日志
   

详细配置

默认配置说明

• 配置文件路径：/opt/bitnami/fluentd/conf/fluentd.conf
• 监听端口：24224（Fluentd forward 协议，TCP/UDP）
• 日志存储规则：
  • 标签为 docker.** 的日志：存储至 /opt/bitnami/fluentd/log/docker.*.log
  • 其他标签日志：存储至 /opt/bitnami/fluentd/log/data.*.log

自定义配置文件

通过挂载本地配置文件覆盖默认配置：

docker run --name fluentd \
  -v /path/to/local/fluentd.conf:/opt/bitnami/fluentd/conf/fluentd.conf \
  bitnami/fluentd:latest

扩展配置（conf.d 目录）

通过 @include 指令扩展默认配置，将自定义配置文件挂载至 conf.d 目录：

docker run --name fluentd \
  -v /path/to/custom-conf.d:/opt/bitnami/fluentd/conf/conf.d \
  bitnami/fluentd:latest

参考 Fluentd 配置文件文档 了解 @include 用法。

初始化脚本

通过挂载脚本目录至 $FLUENTD_INITSCRIPTS_DIR（默认 /docker-entrypoint-initdb.d），在容器启动时执行自定义初始化操作：

docker run --name fluentd \
  -v /path/to/init-scripts:/docker-entrypoint-initdb.d \
  bitnami/fluentd:latest

环境变量

日志查看

容器日志默认输出至 stdout，可通过以下命令查看：

docker logs fluentd

如需自定义日志处理方式，可通过 --log-driver 指定日志驱动（如 json-file、syslog 等）：

docker run --name fluentd --log-driver json-file --log-opt max-size=10m bitnami/fluentd:latest

自定义镜像

如需扩展镜像功能（如安装自定义插件），可基于 Bitnami Fluentd 镜像构建新镜像。示例 Dockerfile：

FROM bitnami/fluentd

# 安装 Fluentd 插件（如 docker_metadata_filter）
RUN fluent-gem install 'fluent-plugin-docker_metadata_filter'

构建并使用自定义镜像：

docker build -t my-fluentd .
docker run --name my-fluentd my-fluentd

维护

升级镜像

1. 拉取最新镜像：

   docker pull bitnami/fluentd:latest
   

2. 停止并备份当前容器：

   docker stop fluentd
   rsync -a /path/to/fluentd-data /path/to/fluentd-data.bkp.$(date +%Y%m%d-%H.%M.%S)  # 备份数据卷（如有）
   

3. 删除旧容器：

   docker rm -v fluentd
   

4. 启动新容器：

   docker run --name fluentd bitnami/fluentd:latest  # 如需恢复数据，添加 -v /path/to/fluentd-data:/opt/bitnami/fluentd/log
   

注意事项

镜像变更通知（2025年8月28日起）

Bitnami 将调整公共镜像目录，具体变更如下：

• 非强化版 Debian 基础镜像将逐步弃用，仅保留安全强化版镜像（latest 标签）供开发使用。
• 现有镜像（含历史版本标签，如 2.50.0）将迁移至 docker.io/bitnamilegacy 仓库，不再更新。
• 生产环境推荐使用 Bitnami Secure Images，提供强化容器、SBOM、企业支持等特性。

其他注意事项

• docker-compose.yaml 文件已移除，生产环境建议使用 Bitnami Fluentd Helm Chart。
• 非 root 用户运行时，需确保挂载的数据卷目录权限对运行用户（默认 fluentd，UID/GID 1001）可写。

贡献与问题反馈

• 贡献代码：通过 bitnami/containers 仓库提交 PR。
• 问题反馈：在 GitHub Issues 提交问题，需包含详细环境信息和复现步骤。

许可证

Copyright © 2025 Broadcom。"Broadcom" 指 Broadcom Inc. 及其子公司。

本软件基于 Apache License 2.0 许可证分发。详情参见 Apache License 2.0。