librespace/logrotate

logrotate 镜像文档

镜像概述和主要用途

logrotate 是一款用于系统日志管理的工具，主要功能包括日志轮转、压缩和邮件发送。本镜像提供了便捷的 logrotate 部署方式，适用于需要自动化处理日志文件的环境，帮助防止日志文件过大、节省存储空间并实现日志归档。

核心功能和特性

• 日志轮转：自动对指定日志文件进行轮转，避免单个日志文件无限增长
• 日志压缩：对轮转后的历史日志文件进行压缩处理，有效节省磁盘空间
• 日志发送：支持将轮转后的日志文件通过邮件发送，便于远程归档或分析

源代码

本镜像的源代码维护在 https://gitlab.com/librespacefoundation/ops/docker-logrotate 仓库。

问题跟踪

如在使用过程中遇到任何问题，请在 https://gitlab.com/librespacefoundation/ops/docker-logrotate/issues 中报告。

构建状态

使用场景和适用范围

适用于需要管理日志文件的各类环境，包括但不限于：

• 服务器系统日志管理
• 容器化应用日志处理
• 开发和生产环境的日志归档
• 需要定期清理和维护日志的场景

使用方法和配置说明

基本运行方式

通过 docker run 命令启动容器，需挂载日志目录和配置文件：

bash
docker run -d \
  -v /path/to/your/logs:/logs \
  -v /path/to/logrotate.conf:/etc/logrotate.conf \
  --name logrotate \
  docker.xuanyuan.run/librespace/logrotate

配置文件说明

logrotate 的核心配置通过配置文件实现，默认配置路径为 /etc/logrotate.conf。典型的配置示例：

conf
# 全局设置
weekly
rotate 4
create
dateext

# 具体日志配置
/logs/*.log {
    daily
    rotate 7
    compress
    delaycompress
    missingok
    notifempty
    postrotate
        /bin/kill -HUP `cat /var/run/rsyslogd.pid 2>/dev/null` 2>/dev/null || true
    endscript
}

配置参数说明：

• daily/weekly/monthly：轮转频率
• rotate N：保留 N 个轮转文件
• compress：启用压缩
• delaycompress：延迟压缩（下次轮转时压缩前一个文件）
• missingok：日志文件不存在时不报错
• notifempty：空文件不轮转

定时执行

建议结合 cron 或容器编排工具（如 Docker Compose）设置定时执行，确保日志定期轮转。例如，在 Docker Compose 中配置：

yaml
version: '3'
services:
  logrotate:
    image: librespace/logrotate
    volumes:
      - /path/to/logs:/logs
      - /path/to/logrotate.conf:/etc/logrotate.conf
    restart: always
    command: /bin/sh -c "while true; do logrotate /etc/logrotate.conf; sleep 86400; done"