参考来源与致谢
- 引用来源:Backup and restore
- 原作者:原页面署名作者或发布机构(剪藏记录未保存可核验的个人署名)
- 感谢词:感谢原作者及发布机构对技术知识的公开分享。本文已结合企业运维场景完成脱敏、核验与原创重写,并非原文转载;如权利人需要更正署名或来源信息,请联系本站。
适用场景 #
iRedMail 将邮件账号、域名、别名等数据存放在 SQL 或 LDAP 后端。当需要迁移服务器、重建实例、应对数据损坏或误删时,需对后端数据做备份与恢复。本文适用于使用 iRedMail 自建邮件系统的企业运维人员,覆盖 SQL 与 OpenLDAP 两类后端。
准备与风险 #
- 恢复操作会覆盖现有数据,务必先在测试环境验证,再对生产环境执行。
- 执行任何恢复前,先对当前数据库或目录做一次完整备份,并确认备份文件可读。
- 确认后端类型(MySQL/MariaDB、PostgreSQL 或 OpenLDAP),不同后端恢复方式不同。
- 确认 iRedMail 版本与备份脚本来源一致,具体路径与参数以对应版本文档为准。
- 恢复 LDAP 时,若原环境启用了额外 schema,需一并迁移并启用,否则导入可能因缺少属性失败。
处理步骤 #
备份 #
iRedMail 安装时通常已配置每日 cron 任务执行备份脚本。脚本位于安装包或源码仓库的 tools 目录,例如 backup_openldap.sh、backup_mysql.sh、backup_pgsql.sh。可用以下命令确认任务是否存在:
crontab -l -u root
备份文件默认存放在脚本参数 BACKUP_ROOTDIR 指定目录,通常为 /var/vmail/backup。SQL 备份为纯 SQL 文件,LDAP 备份为纯 LDIF 文件,默认经 bzip2 压缩,可用 bunzip2 解压。脚本也可手动执行。
除数据库外,还需手动备份以下内容:
- DKIM 密钥,默认位于 /var/lib/dkim/。若未备份,可重新生成,但必须同步更新 DNS 中 dkim._domainkey.[邮件域名] 记录。
- OpenLDAP 后端启用的额外 schema 文件,需复制到新服务器并启用。
恢复 SQL 数据库 #
直接导入备份脚本生成的纯 SQL 文件即可。若在新 iRedMail 服务器上恢复,不要导入旧服务器的 mysql 数据库,其中包含各组件使用的 SQL 账号与密码;新服务器已生成同名但不同密码的账号,导入会导致服务无法连接数据库。
恢复 OpenLDAP #
备份脚本使用 slapcat 导出整棵 LDAP 树,恢复需使用 slapadd。LDAP 备份默认位于 /var/vmail/backup/ldap/[年份]/[月份]/,先解压:
cd /var/vmail/backup/ldap/[年份]/[月份]/
bunzip2 [备份文件名].ldif.bz2
在新服务器的 iRedMail 安装目录中查找 cn=vmail 与 cn=vmailadmin 的密码,例如 iRedMail.tips 文件。这些为明文密码。使用 slappasswd 生成对应哈希:
slappasswd -h '{ssha}' -s '[cn=vmail 密码]'
slappasswd -h '{ssha}' -s '[cn=vmailadmin 密码]'
用文本编辑器打开 LDIF 备份,找到 cn=vmail 与 cn=vmailadmin 的 userPassword 行,替换为生成的哈希值。注意:以空格开头的行表示续行,属于上一行内容;userPassword 后有两个冒号。修改后使用 slapadd 导入。
验证方法 #
- 检查服务状态,确认 Postfix、Dovecot、Webmail 等组件正常启动。
- 使用邮件客户端登录测试账号,验证收发邮件是否正常。
- 查询数据库或 LDAP,确认账号、域名、别名等记录数量与预期一致。
- 查看组件日志,确认无认证失败或数据库连接错误。
回退建议 #
- 恢复前保留当前数据快照,若恢复失败可回滚到原状态。
- LDAP 恢复失败时,可清空目录后重新导入原始备份。
- SQL 恢复失败时,可删除受影响数据库并从恢复前备份重新导入。
- 回退操作同样会覆盖数据,执行前再次确认备份可用。
常见问题 #
- 恢复后服务无法连接数据库:可能误导入了旧服务器的 mysql 数据库,需改用新服务器账号配置。
- LDAP 导入报缺少属性:原环境启用了额外 schema,需先迁移并启用。
- DKIM 验证失败:密钥未迁移或 DNS 记录未更新。
- 备份文件无法解压:确认文件完整,使用 bunzip2 解压。
不同版本 iRedMail 的脚本路径、参数与默认目录可能不同,请以对应版本文档为准。生产环境操作前务必在测试环境验证。
