docker-fluentd-swift 镜像文档

一、镜像概述和主要用途

docker-fluentd-swift 是一个预配置的 Docker 镜像，基于 Fluentd 日志收集器构建，并集成了常用插件，旨在简化日志收集、处理与转发流程。该镜像通过封装核心功能和默认配置，降低了 Fluentd 的部署门槛，适用于需要快速搭建日志聚合系统的场景。

二、核心功能和特性

核心功能

• 集成常用插件：预安装 Fluentd 核心插件（如日志输入、过滤、输出相关插件），支持多样化日志处理需求。
• 多协议支持：内置 TCP/UDP 协议支持，可接收来自不同源的日志数据。
• 配置持久化：支持通过外部卷挂载自定义配置文件，灵活调整日志处理规则。

关键特性

• 开箱即用：无需手动安装依赖，拉取镜像后即可快速启动。
• 端口映射：默认开放 Fluentd 标准端口及扩展端口，适配常见日志源接入。
• 轻量部署：基于 Docker 容器化部署，资源占用低，易于集成到现有容器环境。

三、使用场景和适用范围

适用场景

• 中小规模日志收集：适用于开发、测试或小型生产环境的日志集中管理。
• 容器化环境日志聚合：可作为 Kubernetes、Docker Compose 等容器编排平台的日志收集组件。
• 多源日志统一处理：支持接收来自应用、系统、网络设备等多类型日志源的数据。

适用范围

• 开发/测试环境的日志调试与分析。
• 小型生产环境的日志集中存储与转发。
• 需要快速部署 Fluentd 且对插件需求较基础的场景。

四、使用方法和配置说明

1. 基础部署（docker run）

通过以下命令快速启动容器：

bash
docker run -d \
  -v /mnt/fluent:/etc/fluent \  # 挂载本地配置目录到容器内 Fluentd 配置目录
  -p 24224:24224 \              # 映射 Fluentd 标准 TCP 端口
  -p 24224:24224/udp \          # 映射 Fluentd 标准 UDP 端口
  -p 514:514 \                  # 映射 syslog 标准 TCP 端口（可选，用于接收 syslog 日志）
  -p 514:514/udp \              # 映射 syslog 标准 UDP 端口（可选，用于接收 syslog 日志）
  --name fluentd-swift \        # 容器名称
  vault/fluentd-swift           # 镜像名称

2. 配置文件说明

配置文件路径

容器内 Fluentd 配置文件默认路径为 /etc/fluent/fluent.conf，通过 -v /mnt/fluent:/etc/fluent 挂载本地目录后，可在宿主机 /mnt/fluent 目录下自定义 fluent.conf 文件，实现日志输入源、过滤规则、输出目标的配置。

配置示例（基础）

以下为 fluent.conf 基础示例，用于从文件收集日志并输出到标准输出：

conf
<source>
  @type tail
  path /var/log/nginx/access.log  # 日志文件路径（需通过卷挂载到容器内）
  pos_file /var/log/nginx/access.log.pos
  tag nginx.access
  <parse>
    @type nginx
  </parse>
</source>

<match nginx.access>
  @type stdout  # 输出到标准输出（可替换为 elasticsearch、kafka 等）
</match>

3. Docker Compose 部署示例

创建 docker-compose.yml 文件，简化多容器协同部署：

yaml
version: '3'
services:
  fluentd-swift:
    image: vault/fluentd-swift
    container_name: fluentd-swift
    restart: always
    ports:
      - "24224:24224"       # Fluentd TCP 端口
      - "24224:24224/udp"   # Fluentd UDP 端口
      - "514:514"           # Syslog TCP 端口
      - "514:514/udp"       # Syslog UDP 端口
    volumes:
      - /mnt/fluent:/etc/fluent  # 挂载本地配置目录
      - /var/log:/var/log        # 可选：挂载宿主机日志目录（根据配置需求调整）

启动命令：

bash
docker-compose up -d

五、配置参数说明

1. 端口映射

2. 挂载卷

3. 容器运行参数

六、注意事项

1. 配置文件权限：挂载的本地配置目录（如 /mnt/fluent）需确保容器内用户有读取权限，避免配置文件无法加载。
2. 插件扩展：如需添加未预集成的 Fluentd 插件，可通过自定义 Dockerfile 基于 vault/fluentd-swift 构建，或在配置文件中通过 @type 指定插件并确保镜像已包含。
3. 资源限制：根据日志量调整容器 CPU/内存资源，避免因资源不足导致日志丢失。