centos rabbitmq备份恢复方法

CentOS 上 RabbitMQ 的备份与恢复

一 关键目录与前置检查

• 确认关键路径：配置文件默认在 /etc/rabbitmq（如 rabbitmq.conf、rabbitmq-env.conf、enabled_plugins）；数据目录默认在 /var/lib/rabbitmq/mnesia/（包含队列/交换机/绑定等元数据及持久化消息）；日志默认在 /var/log/rabbitmq。若自定义过路径，可在 rabbitmq-env.conf 中查看或设置 MNESIA_BASE、LOG_BASE、CONFIG_FILE。建议先记录当前节点名与路径，避免恢复时节点名不一致导致启动失败。
• 基本健康检查：确认服务状态 systemctl status rabbitmq-server；查看日志 tail -f /var/log/rabbitmq/rabbit@$(hostname).log；核对端口 5672/15672 与防火墙策略；必要时修复目录权限 chown -R rabbitmq:rabbitmq /var/lib/rabbitmq /etc/rabbitmq。

二 备份策略与步骤

• 元数据备份（推荐优先）：导出定义（用户、vhost、队列、交换机、绑定、策略等）以便跨节点/跨版本快速恢复。
  • 命令行：
    • 备份：rabbitmqctl save_definitions /path/to/definitions.json
    • 恢复前准备：rabbitmqctl stop_app
    • 恢复：rabbitmqctl import_definitions /path/to/definitions.json
    • 恢复后：rabbitmqctl start_app
  • 管理界面/HTTP API：在 http://:15672 的 Admin → Definitions 导出/导入，或用 curl/wget 对 /api/definitions 进行 GET/POST。
• 消息数据备份（Mnesia 数据目录）：为获得一致性，建议短暂停机后打包 /var/lib/rabbitmq/mnesia/。
  • 示例：
    • 停机：systemctl stop rabbitmq-server
    • 打包：tar -czvf rabbitmq-mnesia-$(date +%F).tar.gz -C /var/lib/rabbitmq/mnesia
    • 可选同时备份配置：tar -czvf rabbitmq-config-$(date +%F).tar.gz /etc/rabbitmq
    • 启动：systemctl start rabbitmq-server
• 自动化与异地：将备份脚本加入 crontab 定期执行，并 scp/rsync 到远程存储；保留近 N 天备份，示例脚本与定时任务可参考下述“实用脚本”。

三 恢复方法与场景对照

四 实用脚本与定时任务

• 全量备份脚本（停机一致性，含元数据与配置）

#!/usr/bin/env bash
set -e
BACKUP_DIR="/backup/rabbitmq"
DATE=$(date +%F)
NODE_NAME=$(rabbitmqctl eval 'node()' | sed 's/"//g')

mkdir -p "$BACKUP_DIR"

systemctl stop rabbitmq-server

tar czvf "$BACKUP_DIR/rabbitmq-mnesia-${NODE_NAME}-${DATE}.tar.gz" \
  -C /var/lib/rabbitmq/mnesia "$NODE_NAME"

tar czvf "$BACKUP_DIR/rabbitmq-config-${DATE}.tar.gz" -C /etc rabbitmq

systemctl start rabbitmq-server

# 可选：同步到远端
# rsync -avz "$BACKUP_DIR/" user@remote:/backup/rabbitmq/

# 可选：清理30天前备份
# find "$BACKUP_DIR" -name "*.tar.gz" -mtime +30 -delete

• 定时任务（每天 02:00 执行）

0 2 * * * /usr/bin/flock -n /tmp/rabbitmq-backup.lock /path/to/backup.sh

• 元数据定时备份（不停机，API 方式）

# 备份
wget --user=admin --password=YourPass \
  -O /backup/defs-$(date +%F).json \
  http://127.0.0.1:15672/api/definitions

# 清理30天前
find /backup -name "defs-*.json" -mtime +30 -delete

• 恢复示例（元数据）

rabbitmqctl stop_app
rabbitmqctl import_definitions /backup/defs-2026-01-01.json
rabbitmqctl start_app

• 恢复示例（消息数据）

systemctl stop rabbitmq-server
tar xzvf /backup/rabbitmq-mnesia-rabbit@host-2026-01-01.tar.gz -C /var/lib/rabbitmq/mnesia
chown -R rabbitmq:rabbitmq /var/lib/rabbitmq
systemctl start rabbitmq-server

说明：API 备份需为管理用户启用权限；脚本中的 NODE_NAME 与目录名需与实际一致；生产环境建议先演练并保留多份异地副本。

五 注意事项与常见问题

• 版本与兼容性：恢复时的 RabbitMQ/Erlang 版本应尽量与备份时一致；跨大版本导入 definitions 可能不兼容，需先在测试环境验证。
• 节点名一致性：Mnesia 数据库内嵌节点名，迁移或改名需使用 rabbitmqctl rename_cluster_node 或在目标环境保持一致的 NODENAME/主机名 与 MNESIA_BASE。
• 一致性权衡：停机的全量备份最稳妥；不停机的 definitions 备份不包含消息内容，仅用于快速恢复拓扑与权限。
• 权限与路径：恢复后务必校验 /var/lib/rabbitmq 与 /etc/rabbitmq 属主为 rabbitmq:rabbitmq；若自定义了 MNESIA_BASE/LOG_BASE，需确保路径一致。
• 日志与排错：启动失败时优先查看 /var/log/rabbitmq/rabbit@.log 与 journalctl -u rabbitmq-server；必要时检查端口、防火墙、磁盘空间与 Erlang Cookie（集群）。