foxcpp/maddy

maddy邮件服务器

官方maddy邮件服务器Docker镜像。

快速使用

docker volume create maddydata
docker run \
  --name maddy \
  -e MADDY_HOSTNAME=mx.maddy.test \
  -e MADDY_DOMAIN=maddy.test \
  -v maddydata:/data \
  -p 25:25 \
  -p 143:143 \
  -p 587:587 \
  -p 993:993 \
  foxcpp/maddy:latest

首次启动会失败。需将TLS证书复制到/data/tls_cert.pem，密钥复制到/data/tls_key.pem。
重新启动服务器，然后停止。按照官方教程完成配置（如DKIM密钥等），再次运行服务器即可使用。

创建用户

docker run --rm -it -v maddydata:/data --entrypoint /bin/maddyctl foxcpp/maddy:latest creds create foxcpp@maddy.test
docker run --rm -it -v maddydata:/data --entrypoint /bin/maddyctl foxcpp/maddy:latest imap-acct create foxcpp@maddy.test

镜像标签

• latest - 最新稳定版本，可能包含破坏性变更。
• X.Y - 特定功能分支，建议使用此类标签以获取bug修复，同时避免功能相关的回归问题。
• X.Y.Z - 特定稳定版本。

管理工具 maddyctl

容器中包含管理工具/bin/maddyctl，使用方法如下：

docker run --rm -it -v maddydata:/data --entrypoint /bin/maddyctl foxcpp/maddy:latest

注意：如果在服务器运行时使用maddyctl修改消息，必须确保服务器的/tmp目录对maddyctl可访问，例如服务器和maddyctl容器从同一路径挂载/tmp。

环境变量

• MADDY_HOSTNAME - MX主机名，例如mx.foxcpp.dev。
• MADDY_DOMAIN - 服务器处理邮件的域名。目前不支持通过环境变量设置多个域名，需编辑/data/maddy.conf实现。

端口

所有标准端口，如maddy文档所述：

• 25 - SMTP入站端口。
• 465、587 - SMTP提交端口。
• 993、143 - IMAP4端口。

卷

/data - maddy状态目录，存储数据库、队列等数据。建议挂载命名卷到该路径。主配置文件maddy.conf也存储于此目录（/data/maddy.conf）。