woahbase/alpine-rsyslog

alpine-rsyslog

镜像概述

alpine-rsyslog是一款基于Alpine Linux的多架构Docker镜像，集成S6进程管理框架、RSysLog日志服务及logrotate日志轮转工具。该镜像旨在提供轻量级、高效的日志收集、管理与轮转解决方案，适用于各类需要集中处理日志的环境。

核心功能与特性

• 轻量级基础：基于Alpine Linux，系统体积小，资源占用低，安全性高。
• 多架构支持：提供x86_64、aarch64、armhf、armv7l、i386、ppc64le、riscv64、s390x等多种架构支持，适配不同硬件环境。
• S6进程管理：集成S6进程监督工具，确保RSysLog等服务稳定运行，支持进程自动恢复。
• RSysLog日志服务：功能强大的日志收集与转发工具，支持多种日志来源（文件、网络、系统日志等），可配置日志过滤、格式转换及远程转发。
• logrotate日志轮转：内置日志轮转机制，自动压缩、归档过期日志，防止日志文件过大占用磁盘空间。

使用场景

• Docker容器集群的日志集中收集与管理。
• 服务器系统日志、应用日志的统一收集与转发。
• 需要自动日志轮转以控制磁盘占用的场景。
• 多架构硬件环境（如ARM开发板、x86服务器、IBM Z系列等）的日志服务部署。

使用方法

快速启动

通过以下命令快速启动容器，默认配置将收集容器内系统日志并进行轮转：

bash
docker run -d \
  --name alpine-rsyslog \
  -v /path/to/host/logs:/var/log \  # 挂载主机日志目录（可选）
  -v /path/to/custom/rsyslog.conf:/etc/rsyslog.conf \  # 自定义RSysLog配置（可选）
  -v /path/to/custom/logrotate.d:/etc/logrotate.d \  # 自定义logrotate配置（可选）
  --restart unless-stopped \
  woahbase/alpine-rsyslog:latest

Docker Compose配置示例

创建docker-compose.yml文件，配置更复杂的日志收集场景：

yaml
version: '3'
services:
  rsyslog:
    image: woahbase/alpine-rsyslog:latest
    container_name: alpine-rsyslog
    volumes:
      - ./host-logs:/var/log  # 主机日志挂载
      - ./rsyslog.conf:/etc/rsyslog.conf  # 自定义RSysLog配置
      - ./logrotate.d:/etc/logrotate.d  # 自定义日志轮转规则
    ports:
      - "514:514/udp"  # 开放UDP日志接收端口（如需远程日志收集）
      - "514:514/tcp"  # 开放TCP日志接收端口（如需远程日志收集）
    restart: unless-stopped

启动服务：

bash
docker-compose up -d

配置说明

• RSysLog配置：默认配置文件位于/etc/rsyslog.conf，用户可通过挂载自定义配置文件修改日志来源、格式、转发规则等。详细配置语法参考RSysLog官方文档。

• logrotate配置：默认日志轮转规则位于/etc/logrotate.d/目录，用户可在此目录下添加自定义规则文件（如/etc/logrotate.d/myapp），定义特定日志文件的轮转周期、保留数量、压缩方式等。

查看日志

容器运行后，可通过以下命令查看RSysLog服务日志：

bash
docker logs alpine-rsyslog

相关链接

• 官方文档
• https://hub.docker.com/r/woahbase/alpine-rsyslog
• https://github.com/woahbase/alpine-rsyslog