Rsyslog 容器镜像文档

镜像概述

Rsyslog容器镜像是基于Rsyslog（系统日志处理程序）构建的轻量级容器化解决方案，用于在容器环境中实现高效的日志收集、处理、过滤和转发功能。该镜像封装了Rsyslog的核心组件，可快速集成到各类系统架构中，简化日志管理流程。

核心功能和特性

• 多源日志收集：支持从文件、网络（TCP/UDP）、系统服务等多种来源采集日志
• 灵活日志处理：提供强大的过滤规则、日志格式化和字段提取能力
• 多目标转发：可将日志转发至文件、远程日志服务器、数据库或云日志服务（如ELK Stack、Splunk）
• 协议支持：兼容Syslog、TCP、UDP、TLS等多种传输协议
• 轻量级设计：基于精简基础镜像，资源占用低，启动速度快
• 可配置性：通过环境变量或配置文件自定义日志处理规则

使用场景

• 服务器日志集中管理：在多服务器环境中统一收集和存储系统日志
• 容器化环境日志处理：作为容器集群的日志聚合组件，收集容器输出日志
• 日志转发至分析平台：将原始日志预处理后转发至日志分析或监控系统
• 边缘设备日志采集：在资源受限的边缘设备中实现轻量级日志管理

使用方法

基本运行命令

docker
docker run -d --name rsyslog \
  -v /path/to/host/logs:/var/log \  # 挂载主机日志目录（可选）
  -p 514:514/udp \                  # 暴露UDP端口接收日志
  -p 514:514/tcp \                  # 暴露TCP端口接收日志
  wodby/rsyslog

Docker Compose 配置示例

yaml
version: '3'
services:
  rsyslog:
    image: wodby/rsyslog
    ports:
      - "514:514/udp"
      - "514:514/tcp"
    volumes:
      - ./custom-rsyslog.conf:/etc/rsyslog.conf  # 自定义配置文件（可选）
    restart: always

环境变量配置

可通过环境变量自定义日志转发规则（具体支持的变量请参考***GitHub仓库），常见配置示例：

• RSYSLOG_TARGET_HOST：远程日志服务器地址
• RSYSLOG_TARGET_PORT：远程日志服务器端口
• RSYSLOG_PROTOCOL：转发协议（tcp/udp/tls）
• RSYSLOG_FILTER：日志过滤规则（如基于设施、优先级）

自定义配置文件

如需高级配置，可通过挂载自定义rsyslog.conf文件覆盖默认配置：

docker
docker run -d --name rsyslog \
  -v ./my-rsyslog.conf:/etc/rsyslog.conf \
  wodby/rsyslog

注意事项

• 详细配置选项、环境变量及最佳实践请参考***GitHub仓库
• 生产环境建议挂载持久化存储卷以保存重要日志数据
• 根据日志流量调整容器资源限制（CPU/内存）以确保稳定性