marvambass/versatile-postfix

多功能Postfix邮件服务器 (marvambass/versatile-postfix)

由MarvAmBass维护

FAQ - 关于marvambass容器的所有须知

镜像概述

marvambass/versatile-postfix 是一个功能全面的Postfix邮件服务器Docker镜像。默认情况下，它会使用DKIM签名外发邮件。您可以为单个域名创建多个带密码的用户；若需支持多域名，需使用多个容器或自行 fork 该项目。

注意：这不是POP3或IMAP服务器，接收的邮件将以 Maildir 格式存储，可通过less查看或链接IMAP服务器至存储卷访问。

• Docker Registry地址：https://registry.hub.docker.com/u/marvambass/versatile-postfix/
• GitHub地址：https://github.com/MarvAmBass/docker-versatile-postfix/

环境变量及默认值

基础环境变量

• ALIASES
  可选，无默认值。示例用法：postmaster:root;john:root;j.doe:root（设置邮件别名）。

• DISABLE_DKIM
  默认未设置。若设置为任意值，将禁用DKIM签名功能。

• DKIM_CANONICALIZATION
  默认值：simple。可选值：relaxed 或 simple（DKIM规范化方式）。

• DKIM_SELECTOR
  默认值：mail。可自定义DKIM选择器名称。

高优先级环境变量

以下变量用于覆盖配置生成后的设置，仅在需要特定配置时使用。建议优先使用上述基础变量，部分字符可能导致配置错误！

• POSTFIX_RAW_CONFIG_<POSTFIX_SETTING_NAME>
  通过该变量修改 /etc/postfix/main.cf 中的配置，格式为 POSTFIX_RAW_CONFIG_ 后接配置项名称。
  例如：设置 mynetworks_style = subnet，需添加环境变量 POSTFIX_RAW_CONFIG_MYNETWORKS_STYLE=subnet。

使用方法

运行邮件服务器

该镜像设计为高度灵活，启动脚本会处理关键配置。需注意：这仅是SMTP服务器，为避免容器删除后邮件丢失，需挂载存储卷存储邮件。

基本启动命令

bash
$ docker run -p 25:25 -v /maildirs:/var/mail \
    -v /dkim:/etc/postfix/dkim/ \
    -e 'ALIASES=postmaster:root;hostmaster:root;webmaster:root' \
    marvambass/versatile-postfix \
    yourdomain.com \
    user:password \
    user1:password \
    user2:password \
    userN:password

参数说明：

• -p 25:25：映射SMTP端口（25）。
• -v /maildirs:/var/mail：挂载本地目录存储Maildir格式邮件。
• -v /dkim:/etc/postfix/dkim/：挂载DKIM密钥目录（需包含 dkim.key 文件）。
• -e 'ALIASES=...'：设置邮件别名。
• 命令末尾参数：yourdomain.com 为域名，后续 user:password 对为创建的用户账号（邮件地址格式：user@yourdomain.com）。

DKIM配置

概述

服务器默认启用DKIM签名。首次启动时，若 /etc/postfix/dkim/ 目录中无 dkim.key，将自动生成DKIM密钥。需确保挂载该目录并将公钥配置到DNS系统。

手动生成DKIM密钥

1. 安装opendkim工具：

   bash
   $ apt-get install opendkim-tools
   

2. 生成密钥（以域 example.com、选择器 mail 为例；添加 -t 参数可启用测试模式）：

   bash
   $ opendkim-genkey -s mail -d example.com
   

3. 部署密钥：

   • 将生成的 mail.private 重命名为 dkim.key，放入挂载的 /dkim 目录。
   • 将 mail.txt 中的公钥配置到DNS（添加TXT记录）。

DNS配置示例

mail.txt 内容示例：

mail._domainkey	IN	TXT	( "v=DKIM1; k=rsa; "
	  "p=MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQDcUp8Q1sbxgnR2iL7w+TOHN1IR6PzAP3vmUoPfeN07NGfWo8Wzxyn+hqqnC+mbPOW4ZDoAiu5dvpPsCt1RQalwBw/iPlB/8ScTlPGRpsTLo4ruCDL+yVkw32/UhvCL8vbZxM/Q7ELjO6AqRRW/KuCvbd5gNRYGeyjWd+UQAfmBJQIDAQAB" )  ; ----- DKIM key mail for example.com

需在域名DNS配置中添加TXT记录：

mail._domainkey	IN	TXT	"v=DKIM1; k=rsa; p=MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQDcUp8Q1sbxgnR2iL7w+TOHN1IR6PzAP3vmUoPfeN07NGfWo8Wzxyn+hqqnC+mbPOW4ZDoAiu5dvpPsCt1RQalwBw/iPlB/8ScTlPGRpsTLo4ruCDL+yVkw32/UhvCL8vbZxM/Q7ELjO6AqRRW/KuCvbd5gNRYGeyjWd+UQAfmBJQIDAQAB"

验证DNS配置

bash
$ host -t TXT mail._domainkey.example.com

测试方法

测试邮件接收

bash
$ mailx -r "sender@example.com" -s "测试邮件主题" user1@yourdomain.com < /etc/hosts

测试SMTP认证与发送（通过telnet）

1. 生成Base64编码的认证信息（格式：\0用户名\0密码）：

   bash
   $ echo -ne '\0user\0password' | openssl enc -base64
   AHVzZXIAcGFzc3dvcmQ=  # 示例输出
   

2. 通过telnet连接并发送邮件：

   bash
   $ telnet 127.0.0.1 25
   Trying 127.0.0.1...
   Connected to 127.0.0.1.
   Escape character is '^]'.
   220 yourdomain.com ESMTP
   ehlo test
   250-yourdomain.com
   250-PIPELINING
   250-SIZE 10240000
   250-VRFY
   250-ETRN
   250-STARTTLS
   250-AUTH LOGIN PLAIN
   250 8BITMIME
   auth plain AHVzZXIAcGFzc3dvcmQ=  # 替换为步骤1生成的编码
   235 Authentication successful
   mail from: user@yourdomain.com
   250 2.1.0 Ok
   rcpt to: mail@example.com
   250 2.1.5 Ok
   data
   354 End data with <CR><LF>.<CR><LF>
   测试邮件内容
   这是一封测试邮件
   .
   250 2.0.0 Ok: queued as 2E7FB27F
   quit
   221 Bye
   Connection closed by foreign host.
   

参考链接

• DKIM密钥检查
• DKIM详细信息及签名检查