---
title: iRedMail 邮件系统备份与恢复运维实践
description: 面向企业 IT 运维，说明 iRedMail 中 SQL 与 LDAP 数据的备份机制、恢复流程、验证方法与回退建议，强调备份脚本、cron 任务、DKIM 密钥及 LDAP schema 的处理要点，并提醒恢复前做好测试与备份。
url: "https://www.lanever.com/docs/iredmail-%e9%82%ae%e4%bb%b6%e7%b3%bb%e7%bb%9f%e5%a4%87%e4%bb%bd%e4%b8%8e%e6%81%a2%e5%a4%8d%e8%bf%90%e7%bb%b4%e5%ae%9e%e8%b7%b5/"
updated: "2026-10-12"
category: iRedMail
---

# iRedMail 邮件系统备份与恢复运维实践

> **参考来源与致谢**
>
>
>
> - **引用来源：**[Backup and restore](http://www.iredmail.org/docs/backup.restore.html#how-to-restore-openldap-backup)
> - **原作者：**原页面署名作者或发布机构（剪藏记录未保存可核验的个人署名）
> - **感谢词：**感谢原作者及发布机构对技术知识的公开分享。本文已结合企业运维场景完成脱敏、核验与原创重写，并非原文转载；如权利人需要更正署名或来源信息，请联系本站。

## 适用场景

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 的脚本路径、参数与默认目录可能不同，请以对应版本文档为准。生产环境操作前务必在测试环境验证。
