当前位置：首页 > news >正文

listmonk容器日志轮转配置：避免磁盘空间耗尽

news 2026/6/16 4:05:55

listmonk容器日志轮转配置：避免磁盘空间耗尽

在使用listmonk作为自托管邮件列表管理器时，未配置日志轮转可能导致容器日志文件无限增长，最终耗尽服务器磁盘空间。本文将详细介绍如何为Docker部署的listmonk配置日志轮转策略，确保系统稳定运行。

日志增长风险分析

默认情况下，Docker容器的日志会以JSON格式存储在/var/lib/docker/containers/目录下，且不会自动轮转。对于发送大量邮件的listmonk实例，日志文件可能以每天数百MB的速度增长。通过查看项目提供的系统服务配置文件，可以发现官方已提示日志持久化的潜在问题：

listmonk-simple.service中明确指出：

# To enable a log file that persists after restarts, replace the ExecStart= line with: # ExecStart=/bin/bash -ce "exec /usr/bin/listmonk --config /etc/listmonk/config.toml --static-dir /etc/listmonk/static >>/etc/listmonk/listmonk.log 2>&1"

这种直接重定向到文件的方式如果没有配合轮转机制，将很快导致磁盘空间问题。

Docker日志驱动配置

配置json-file驱动轮转

最直接的解决方案是修改Docker Compose配置，为listmonk服务添加日志轮转参数。编辑项目根目录下的docker-compose.yml文件，在services.listmonk部分添加logging配置：

services: listmonk: image: listmonk/listmonk:latest logging: driver: "json-file" options: max-size: "10m" # 单个日志文件最大10MB max-file: "3" # 最多保留3个日志文件 compress: "true" # 压缩历史日志 # 其他配置...

验证配置生效

修改完成后，使用以下命令应用配置并检查日志驱动状态：

docker compose up -d docker inspect -f '{{.HostConfig.LogConfig}}' listmonk_listmonk_1

预期输出应包含配置的日志驱动和参数，表明Docker已启用日志轮转功能。

系统级日志轮转方案

对于直接通过系统服务而非Docker运行的listmonk实例，可以使用Linux系统自带的logrotate工具实现日志轮转。

创建logrotate配置文件

在/etc/logrotate.d/目录下创建listmonk配置文件，内容如下：

/etc/listmonk/listmonk.log { daily missingok rotate 7 maxsize 50M compress delaycompress notifempty create 0640 listmonk listmonk }

此配置将：

每天轮转日志
保留7天日志
单个文件达到50MB时强制轮转
压缩历史日志文件

配置立即生效

执行以下命令测试并应用logrotate配置：

logrotate -d /etc/logrotate.d/listmonk # 调试模式测试 logrotate /etc/logrotate.d/listmonk # 立即应用配置

日志监控与告警

为确保日志轮转机制正常工作，建议定期检查日志文件状态。可以结合Prometheus和Grafana监控磁盘空间使用情况，或使用简单的Shell脚本监控日志目录大小：

#!/bin/bash LOG_DIR="/var/lib/docker/containers/$(docker inspect -f '{{.Id}}' listmonk_listmonk_1)" LOG_SIZE=$(du -sh $LOG_DIR | awk '{print $1}') if [[ $LOG_SIZE > "50M" ]]; then echo "Listmonk日志目录超过50MB: $LOG_SIZE" | mail -s "Listmonk日志告警" admin@example.com fi

将此脚本添加到crontab中定期执行，可及时发现日志轮转异常。