iredmail/mariadb

iRedMail Docker镜像（MariaDB版本）

警告：此为测试版，并非始终稳定，请勿在生产环境中使用（尚未正式发布）。

• 源代码托管于https://github.com/iredmail/dockerized%EF%BC%8C%E6%AC%A2%E8%BF%8E%E6%8F%90%E4%BA%A4bug%E6%8A%A5%E5%91%8A%E3%80%81%E5%8F%8D%E9%A6%88%E5%92%8C%E8%A1%A5%E4%B8%81%E3%80%82
• 基础镜像为https://hub.docker.com/_/ubuntu%E3%80%82
• Docker化的iRedMail遵循iRedMail Easy平台最佳实践。
• 提供2个标签：
  • iredmail/mariadb:stable：稳定版本。
  • iredmail/mariadb:nightly：每次GitHub提交时触发构建。

快速开始

创建环境配置文件

创建用于存储自定义设置的docker环境文件：

bash
mkdir /iredmail         # 创建新目录或使用任何你喜欢的目录，/iredmail/仅为示例
cd /iredmail
touch iredmail-docker.conf

echo HOSTNAME=mail.mydomain.com >> iredmail-docker.conf
echo FIRST_MAIL_DOMAIN=mydomain.com >> iredmail-docker.conf
echo FIRST_MAIL_DOMAIN_ADMIN_PASSWORD=my-secret-password >> iredmail-docker.conf
echo MLMMJADMIN_API_TOKEN=$(openssl rand -base64 32) >> iredmail-docker.conf
echo ROUNDCUBE_DES_KEY=$(openssl rand -base64 24) >> iredmail-docker.conf

创建数据存储目录

创建用于存储应用数据的必要目录：

bash
cd /iredmail
mkdir -p data/{backup-mysql,clamav,custom,imapsieve_copy,mailboxes,mlmmj,mlmmj-archive,mysql,sa_rules,ssl,postfix_queue}

启动容器

bash
docker run \
    --rm \
    --name iredmail \
    --env-file iredmail-docker.conf \
    --hostname mail.mydomain.com \
    -p 80:80 \
    -p 443:443 \
    -p 110:110 \
    -p 995:995 \
    -p 143:143 \
    -p 993:993 \
    -p 25:25 \
    -p 465:465 \
    -p 587:587 \
    -v /iredmail/data/backup-mysql:/var/vmail/backup/mysql \
    -v /iredmail/data/mailboxes:/var/vmail/vmail1 \
    -v /iredmail/data/mlmmj:/var/vmail/mlmmj \
    -v /iredmail/data/mlmmj-archive:/var/vmail/mlmmj-archive \
    -v /iredmail/data/imapsieve_copy:/var/vmail/imapsieve_copy \
    -v /iredmail/data/custom:/opt/iredmail/custom \
    -v /iredmail/data/ssl:/opt/iredmail/ssl \
    -v /iredmail/data/mysql:/var/lib/mysql \
    -v /iredmail/data/clamav:/var/lib/clamav \
    -v /iredmail/data/sa_rules:/var/lib/spamassassin \
    -v /iredmail/data/postfix_queue:/var/spool/postfix \
    iredmail/mariadb:stable

注意事项：

• 首次运行时，会生成自签名SSL证书，可能需要较长时间，请耐心等待。
• 每次运行容器时，会执行以下任务：
  • 更新SpamAssassin规则。
  • 更新ClamAV病毒库。
• FIRST_MAIL_DOMAIN_ADMIN_PASSWORD仅在首次运行时设置/重置，非每次运行。
• 默认情况下，每次启动或重启容器时，所有SQL密码会随机设置/重置。如不希望此行为，可在iredmail-docker.conf中设置固定密码，例如MYSQL_ROOT_PASSWORD=<your-password>。
• 不要忘记为服务器主机名和邮件域名设置DNS记录。
• 若在Windows或macOS上运行Docker，容器可能无法启动，必须使用Docker卷，如下所述。

Windows/macOS用户或使用Docker卷存储数据

若在Windows/macOS上运行Docker，或偏好使用Docker卷存储持久数据，请创建所需卷：

bash
docker volume create iredmail_backup           # 备份文件
docker volume create iredmail_mailboxes        # 所有用户邮箱
docker volume create iredmail_mlmmj            # 邮件列表数据
docker volume create iredmail_mlmmj_archive    # 邮件列表归档
docker volume create iredmail_imapsieve_copy   # Dovecot插件'imapsieve'使用
docker volume create iredmail_custom           # 自定义配置文件
docker volume create iredmail_ssl              # SSL证书/密钥文件
docker volume create iredmail_mysql            # MySQL数据库
docker volume create iredmail_clamav           # ClamAV数据库
docker volume create iredmail_sa_rules         # SpamAssassin规则
docker volume create iredmail_postfix_queue    # Postfix队列

使用卷启动容器：

bash
docker run \
    --rm \
    --name iredmail \
    --env-file iredmail-docker.conf \
    --hostname mail.mydomain.com \
    -p 80:80 \
    -p 443:443 \
    -p 110:110 \
    -p 995:995 \
    -p 143:143 \
    -p 993:993 \
    -p 25:25 \
    -p 465:465 \
    -p 587:587 \
    -v iredmail_backup-mysql:/var/vmail/backup/mysql \
    -v iredmail_mailboxes:/var/vmail/vmail1 \
    -v iredmail_mlmmj:/var/vmail/mlmmj \
    -v iredmail_mlmmj_archive:/var/vmail/mlmmj-archive \
    -v iredmail_imapsieve_copy:/var/vmail/imapsieve_copy \
    -v iredmail_custom:/opt/iredmail/custom \
    -v iredmail_ssl:/opt/iredmail/ssl \
    -v iredmail_mysql:/var/lib/mysql \
    -v iredmail_clamav:/var/lib/clamav \
    -v iredmail_sa_rules:/var/lib/spamassassin \
    -v iredmail_postfix_queue:/var/spool/postfix \
    iredmail/mariadb:stable

概述

Docker主机上仅需一个配置文件iredmail-docker.conf。

若偏好通过-e参数在启动容器时覆盖参数，此文件为可选。例如：

bash
docker run -e HOSTNAME=mail.mydomain.com -e FIRST_MAIL_DOMAIN=mydomain.com ...

建议将参数存储在环境文件（示例中的iredmail-docker.conf）中，以减少每次启动容器时的输入。

必需参数

以下必需参数必须在iredmail-docker.conf中设置：

# 服务器主机名，必须是FQDN（完全限定域名），例如mail.mydomain.com
HOSTNAME=

# 首个邮件域名，例如mydomain.com
FIRST_MAIL_DOMAIN=

# 邮件用户postmaster@<FIRST_MAIL_DOMAIN>的（明文）密码
FIRST_MAIL_DOMAIN_ADMIN_PASSWORD=

# 用于访问mlmmjadmin API的密钥令牌
MLMMJADMIN_API_TOKEN=

# 用于加密/解密Roundcube会话数据的密钥字符串
# 如需运行Roundcube webmail则必需
# 可使用命令`openssl rand -base64 24`生成随机字符串作为des密钥
# 每次更改此密钥，所有Roundcube会话数据将失效，用户需重新登录
ROUNDCUBE_DES_KEY=

注意：

• iredmail-docker.conf将被Docker作为环境文件读取，单引号或双引号会被视为值的一部分。不要在值中使用空格、制表符，也不要使用单引号或双引号。
• 此文件也会作为bash shell脚本导入。

容器内的/docker/entrypoints/settings.conf文件中定义了许多可选设置，如需修改，可在iredmail-docker.conf中使用相同参数名并设置自定义值以覆盖默认值。

可选参数

# 自定义HTTPS端口（如不使用默认443端口）
PORT_HTTPS=4443

硬件要求

• 低流量生产邮件服务器至少需要4GB RAM。

已安装软件

• Postfix：SMTP服务器。
• Dovecot：POP3/IMAP/LMTP/Sieve服务器，同时为Postfix提供SASL认证服务。
• mlmmj：邮件列表管理器。
• mlmmjadmin：用于管理（mlmmj）邮件列表的RESTful API服务器。
• Amavisd-new + ClamAV + SpamAssassin：反垃圾邮件和反病毒，DKIM签名与验证等。
• iRedAPD：Postfix策略服务器（iRedMail团队开发）。
• Fail2ban：扫描日志文件并封禁不良客户端。
• Roundcube：Web邮件客户端。
• iRedAdmin：基于Web的管理面板（开源版）。

可参考此教程了解软件与网络端口的对应关系。

暴露的网络端口

• 80：HTTP
• 443：HTTPS
• 25：SMTP
• 465：SMTPS（基于SSL的SMTP）
• 587：SUBMISSION（基于TLS的SMTP）
• 143：基于TLS的IMAP
• 993：基于SSL的IMAP
• 110：基于TLS的POP3
• 995：基于SSL的POP3
• 4190：Managesieve服务

相关链接

• 若尝试使用Ansible部署此Docker镜像，用户@ricristian提供了参考代码：https://github.com/ricristian/ansible-dockerized-iredmail