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

listmonk容器编排备份恢复：配置与数据恢复

news 2026/6/16 5:15:11

listmonk容器编排备份恢复：配置与数据恢复

你是否曾因服务器故障丢失过重要的邮件列表数据？是否担心过配置文件损坏导致服务无法启动？本文将通过容器化部署场景，详细讲解如何为listmonk构建完整的备份恢复体系，确保你的邮件营销数据万无一失。读完本文后，你将掌握配置文件备份、数据库数据持久化、自动化备份脚本编写以及灾难恢复的全流程操作。

容器化部署架构解析

listmonk采用Docker Compose实现多容器编排，核心由应用服务和PostgreSQL数据库组成。通过分析docker-compose.yml可知，项目使用命名卷listmonk-data存储数据库数据，通过绑定挂载管理用户上传文件：

services: app: volumes: - ./uploads:/listmonk/uploads:rw # 用户上传文件存储 db: volumes: - type: volume source: listmonk-data # 数据库数据卷 target: /var/lib/postgresql/data

这种架构确保了关键数据的持久化存储，但需要针对性设计备份策略。下图展示了容器化部署中的数据流向与存储关系：

备份策略设计与实施

配置文件备份

listmonk的核心配置通过环境变量或配置文件管理。官方推荐使用环境变量方式部署，但自定义配置时需备份config.toml.sample模板文件。创建配置备份脚本：

# 备份配置文件 mkdir -p /backup/config cp config.toml /backup/config/config-$(date +%Y%m%d).toml # 备份Docker Compose配置 cp docker-compose.yml /backup/config/docker-compose-$(date +%Y%m%d).yml

数据库数据备份

PostgreSQL容器数据存储在命名卷中，可通过Docker命令导出：

# 数据库备份 docker exec listmonk_db pg_dump -U listmonk listmonk > /backup/db/listmonk-$(date +%Y%m%d).sql # 压缩备份文件 gzip /backup/db/listmonk-$(date +%Y%m%d).sql

用户上传文件备份

uploads目录存储邮件模板图片等静态资源，通过rsync实现增量备份：

# 上传文件备份 rsync -av --delete ./uploads/ /backup/uploads/

自动化备份方案

使用crontab配置每日自动备份任务，创建/etc/cron.d/listmonk-backup：

# 每日凌晨3点执行备份 0 3 * * * root /backup/scripts/backup-all.sh >> /var/log/listmonk-backup.log 2>&1

备份脚本backup-all.sh完整内容：

#!/bin/bash BACKUP_DIR="/backup" TIMESTAMP=$(date +%Y%m%d) # 创建备份目录 mkdir -p $BACKUP_DIR/{config,db,uploads} # 配置文件备份 cp /path/to/config.toml $BACKUP_DIR/config/config-$TIMESTAMP.toml cp /path/to/docker-compose.yml $BACKUP_DIR/config/ # 数据库备份 docker exec listmonk_db pg_dump -U listmonk listmonk | gzip > $BACKUP_DIR/db/listmonk-$TIMESTAMP.sql.gz # 上传文件备份 rsync -av --delete /path/to/uploads/ $BACKUP_DIR/uploads/ # 删除7天前的旧备份 find $BACKUP_DIR -type f -mtime +7 -delete

数据恢复流程

配置文件恢复

当配置文件损坏或丢失时，从备份恢复：

# 恢复最新配置 cp /backup/config/config-$(ls -t /backup/config | grep config | head -1) /path/to/config.toml # 重启服务 docker compose restart app

数据库恢复

数据库故障时，通过备份文件恢复数据：

# 停止应用服务 docker compose stop app # 恢复数据库 gunzip -c /backup/db/listmonk-20250101.sql.gz | docker exec -i listmonk_db psql -U listmonk -d listmonk # 启动服务 docker compose start app

完整恢复演练

定期进行恢复演练确保备份有效性，完整恢复步骤：

部署新环境：git clone https://gitcode.com/gh_mirrors/li/listmonk
恢复配置文件到项目目录
启动数据库容器：docker compose up -d db
导入数据库备份：gunzip -c /backup/db/xxx.sql.gz | docker exec -i listmonk_db psql -U listmonk -d listmonk
恢复uploads目录：rsync -av /backup/uploads/ ./uploads/
启动所有服务：docker compose up -d

高级备份策略

远程备份同步

使用rclone工具将本地备份同步到云存储：

# 安装rclone curl https://rclone.org/install.sh | sudo bash # 配置远程存储 rclone config # 同步备份到云端 rclone sync /backup remote:listmonk-backup

备份监控与告警

创建监控脚本检查备份状态，配合邮件通知：

#!/bin/bash # 检查最近24小时是否有备份 if find /backup/db -type f -mtime -1 | grep -q .; then echo "Backup successful" else # 发送告警邮件 echo "Backup failed" | mail -s "Listmonk Backup Alert" admin@example.com fi