Docker Mailserver 官网
Docker Mailserver 仓库
一个固有公网 IP 的 VPS 与域名
当然有条件的尽可能选择国外的服务器厂商和域名，因为国内的大部分都是封锁出站 25 端口同时域名也需要备案。
在服务器商那里开放25、143、465、587、993端口
tips：封锁 25 出站端口为后续的发送邮件功能产生了不少的麻烦。
这里介绍公网 IP 为1.2.3.4域名为example.com后续修改配置文件，可替换成自己的 IP 和域名
需要安装 Docker 与 Docker compose，这里就不多介绍了。可在其他博客中查看。教程正在 loading
1 创建安装目录位置自定义，软件本人一般都安装在 /opt/ 中
cd /opt mkdir mailserver 2 下载必要文件使用 wget 下载compose.yml与mailserver.env配置文件
也可以从 github 的仓库中下载好上传到服务器中
编辑compose.yml文件，修改为自己的域名与证书
这里分为两种情况
裸域安装：，简单来说就是邮件地址为test@example.com
子域安装：使用子域名，例如mail.example.com，邮件地址就为test@mail.example.com
如果选择裸域安装则修改homename并解除注释
如果选择子域名安装修改domainname并解除注释
选择不同的安装方式后续的 DNS 设置也是不同的
Docker Mailserver规定首次运行容器时必须创建第一个邮箱账号，否则容器会自动退出
# 在启动容器时， 使用 docker ps 查看容器的 ID docker ps # 出现如下内容 CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES 318bbf389f9c ghcr.io/docker-mailserver/docker-mailserver:latest "/usr/bin/dumb-init …" 31 seconds ago Up 30 seconds (healthy) 0.0.0.0:25->25/tcp, :::25->25/tcp, 0.0.0.0:143->143/tcp, :::143->143/tcp, 0.0.0.0:465->465/tcp, :::465->465/tcp, 0.0.0.0:587->587/tcp, :::587->587/tcp, 110/tcp, 995/tcp, 0.0.0.0:993->993/tcp, :::993->993/tcp, 4190/tcp mailserver # 添加第一个邮箱账号 # docker exec -it <CONTAINER NAME> setup email add user@example.com <your password> # 使用裸域安装(与compose.yml配置文件选择安装方式一致) docker exec -it 318bbf389f9c setup email add user@example.com <your password> # 使用子域安装(与compose.yml配置文件选择安装方式一致) docker exec -it 318bbf389f9c setup email add user@mail.example.com <your password> # 查看邮箱账号列表 docker exec -it 318bbf389f9c setup email list # 其他命令可通过 help查看 docker exec -it 318bbf389f9c setup email help ...... 5 配置 DNS（以腾讯 DNS 为例）DKIM 检查器
DKIM生成器
使用下面命令获取签名公钥， 记得路径中的域名替换成你自己的
[nukix@nukixPC mailserver]# cat /opt/mailserver/docker-data/dms/config/opendkim/keys/mail.example.com/mail.txt mail._domainkey IN TXT ( "v=DKIM1; h=sha256; k=rsa; " "p=MIIBIjANBgkqhkiG9w0BAQEFACAQ8AMIIBCgKCAQEAaH5KuPYPSF3Ppkt466BDMAFGOA4mgqn4oPjZ5BbFlYA9l5jU3bgzRj3l6/Q1n5a9lQs5fNZ7A/HtY0aMvs3nGE4oi+LTejt1jblMhV/OfJyRCunQBIGp0s8G9kIUBzyKJpDayk2+KJSJt/lxL9Iiy0DE5hIv62ZPP6AaTdHBAsJosLFeAzuLFHQ6USyQRojefqFQtgYqWQ2JiZQ3" "iqq3bD/BVlwKRp5gH6TEYEmx8EBJUuDxrJhkWRUk2VDl1fqhVBy8A9O7Ah+85nMrlOHIFsTaYo9o6+cDJ6t1i6G1gu+bZD0d3/3bqGLPBQV9LyEL1Rona5V7TJBGg099NQkTz1IwIDAQAB" ) ; ----- DKIM key mail for mail.example.com v=DKIM1; h=sha256; k=rsa; p=MIIBIjANBgkqhkiG9w0BAQEFACAQ8AMIIBCgKCAQEAaH5KuPYPSF3Ppkt466BDMAFGOA4mgqn4oPjZ5BbFlYA9l5jU3bgzRj3l6/Q1n5a9lQs5fNZ7A/HtY0aMvs3nGE4oi+LTejt1jblMhV/OfJyRCunQBIGp0s8G9kIUBzyKJpDayk2+KJSJt/lxL9Iiy0DE5hIv62ZPP6AaTdHBAsJosLFeAzuLFHQ6USyQRojefqFQtgYqWQ2JiZQ3iqq3bD/BVlwKRp5gH6TEYEmx8EBJUuDxrJhkWRUk2VDl1fqhVBy8A9O7Ah+85nMrlOHIFsTaYo9o6+cDJ6t1i6G1gu+bZD0d3/3bqGLPBQV9LyEL1Rona5V7TJBGg099NQkTz1IwIDAQAB 2 添加 DMARC 记录（可选）DMARC（Domain-based Message Authentication, Reporting, and Conformance）是一种邮件验证技术，它可以帮助域名所有者控制其域名下的邮件发送，防止电子邮件被伪造和滥用。DMARC 是 SPF 和 DKIM 的补充，可以对 SPF 和 DKIM 的验证结果进行汇总和分析，并指定如何处理未经验证或验证失败的邮件。
生成器
这里给个通用的最低策略，不同的策略可使用生成器自行生成
裸域安装
请公布以下内容 DNS TXT 记录子域上的_dmarc.example.com 记录类型：TXT 主机：_dmarc 记录值：v=DMARC1; p=none; sp=none;子域安装
请公布以下内容 DNS TXT 记录子域上的_dmarc.mail.example.com 记录类型：TXT 主机：_dmarc.mail 记录值：v=DMARC1; p=none; sp=none; 3 配置域名 DNS 解析裸域安装实例：
主机记录值记录类型记录值备注子域安装
主机记录值记录类型记录值备注其中 MX 记录需要指向 A 地址。
v=spf1 表示这是 SPF 记录的版本号，目前只有一个版本
mx 表示授权由域名对应的 MX 记录中列出的 IP 地址发送邮件
SoftFail 和 HardFail 是两种策略，用于指定未经授权的发件人邮件如何处理
~all 宽容策略。如果发件人的 IP 地址不在 SPF 记录中指定的允许列表中，那么收件方的邮件服务器不会拒绝该邮件，而是将该邮件标记为“软失败”，并将其放入接收方的垃圾邮件文件夹或者标记为垃圾邮件。
-all 严格策略。如果发件人的IP地址不在 SPF 记录中指定的允许列表中，那么收件方的邮件服务器会拒绝该邮件，并将其退回给发件人或者直接删除
更多的 SPF 语法规则可以看这里 。
4 设置 RTP（rDNS）（可选）设置 PTR 记录(或者叫 rDNS)，可以通过 IP 地址反向解析出邮箱域名。 不设置也没关系，但是会被某些服务器标记为垃圾邮件。rDNS 主要在控制台进行配置，可能有些厂商设置 RTP 是收费的，这里就不搞了，有兴趣的可以自己尝试尝试，艾特一下让我也学习学习🤞
等我了解完全后更新 loading…
网上大部分都是使用Let's Encrypt生成免费的证书。但是，我想说，我都在腾讯买域名了而且他提供了免费的证书，我直接用不好嘛🤣
当然也可以选择使用Let's Encrypt看个人选择嘛，具体申请教程，网上很多。官网也给出的配置教程，
这里教程是用的腾讯申请的免费证书，申请好后选择 Nginx 类型，这里只需要以key和 crt结尾的文件
修改conpose.yml文件
services: mailserver: .......... 上面都不动 .......... volumes: - ./docker-data/dms/mail-data/:/var/mail/ - ./docker-data/dms/mail-state/:/var/mail-state/ - ./docker-data/dms/mail-logs/:/var/log/mail/ - ./docker-data/dms/config/:/tmp/docker-mailserver/ # 添加证书的挂载卷 - ./docker-data/dms/custom-certs/:/tmp/dms/custom-certs/:ro - /etc/localtime:/etc/localtime:ro environment: - SSL_TYPE=manual # 值应与容器内的文件路径匹配： - SSL_CERT_PATH=/tmp/dms/custom-certs/mail.byteload.cn_bundle.crt - SSL_KEY_PATH=/tmp/dms/custom-certs/mail.byteload.cn.key restart: always stop_grace_period: 1m # Uncomment if using `ENABLE_FAIL2BAN=1`: # cap_add: # - NET_ADMIN healthcheck: test: "ss --listening --tcp | grep -P 'LISTEN.+:smtp' || exit 1" timeout: 3s retries: 0启动容器
docker compose up测试证书是否有效
docker exec mailserver openssl s_client \ -connect 0.0.0.0:25 \ -starttls smtp \ -CApath /etc/ssl/certs/ 响应应显示证书链，并在下面显示一行：Verify return code: 0 (ok) 此示例在 DMS 容器本身内运行，以验证证书是否在本地运行。 如果从另一个系统进行外部测试，请调整 IP。此外，鼓励对端口 143 （Dovecot IMAP） 进行测试（将 -starttls 的协议从 smtp 更改为 imap）。-connect -CApath将帮助验证证书链，前提是该位置包含签署 DMS 的 TLS 证书的根 CA。如果你使用的是海外的服务器，到这里基本上配置就已经结束了，可以使用 Docker Mailserver 进行收发邮件
由于Docker Mailserver没有提供图形化界面进行发送与接收邮件，所以需要借助第三方邮箱。这里推荐使用eM Client 用这个邮件客户端的主要原因在于如果连接有问题，它会给出一些提示。
由于国内的服务器厂商绝大多数都是封锁 25 出站端口，申请解封也是无效的，只能使用中继来发送有效，当然使用国内的 smtp 中继实际接收方显示的发件地址为 smtp 平台的地址。例如：使用 163 邮箱进行中继，收件方显示的邮件发送地址为xxxxx@163.com。谷歌也是这样，当然这里也会给出使用 gmail 进行中继的教程。
这里的中继使用了postfix会的小伙伴可以不用看下面的教程了。
使用 163 中继的前提：开通了 POP3 服务，获得了授权码
修改compose.yml文件，在/opt/mailserver/docker-data/dms/config下 新建
postfix-main.cf
sasl_passwd
sender_canonical
修改postfix-main.cf文件
smtp_use_tls=yes smtp_sasl_auth_enable=yes smtp_tls_wrappermode=yes smtp_tls_security_level=encrypt smtp_sasl_security_options=noanonymous smtp_sasl_type=cyrus smtp_sasl_password_maps=hash:/tmp/docker-mailserver/sasl_passwd # 设置发件人地址 不设置会出现 "553 mail from must equal authorized user"提示的错误 sender_canonical_maps=regexp:/tmp/docker-mailserver/sender_canonical修改sasl_passwd文件
# 添加这行内容，保存退出 [smtp.163.com]:465 <your account>:<your authorization code> # 生成 .db文件 cd /opt/mailserver/docker-data/dms/config postmap ./sasl_passwd修改sender_canonical文件
# 添加这行内容，保存退出 /.+/ <your account> # 生成 .db文件 cd /opt/mailserver/docker-data/dms/config postmap ./sender_canonical # 启动容器 cd /opt/mailserver docker compose up # 测试发送和接收邮件 # 没出问题即可关闭使用后台运行到此 使用 163 邮箱中继就结束了
使用 gmail 中继少许麻烦，因为国内因为某些原因是无法直接连接到 gmail 的，因此需要特定的方法。都是用 gmail 了，相信你肯定会的😎
gmail 现在只能使用授权码了，具体开启方法百度很多
在compose.yml中添加网络代理和 gmail 账号
services: mailserver: image: ghcr.io/docker-mailserver/docker-mailserver:latest ........ 上面不动 ........ environment: - HTTP_PROXY=<http://your proxy ip:port > - HTTPS_PROXY=<http://your proxy ip:port > - SSL_TYPE=manual # 值应与容器内的文件路径匹配： - SSL_CERT_PATH=/tmp/dms/custom-certs/mail.byteload.cn_bundle.crt - SSL_KEY_PATH=/tmp/dms/custom-certs/mail.byteload.cn.key - DEFAULT_RELAY_HOST=[smtp.gmail.com]:587 - RELAY_HOST=smtp.gmail.com - RELAY_PORT=587 - RELAY_USER=<your account > - RELAY_PASSWORD=<your authorization code> restart: always stop_grace_period: 1m # Uncomment if using `ENABLE_FAIL2BAN=1`: # cap_add: # - NET_ADMIN healthcheck: test: "ss --listening --tcp | grep -P 'LISTEN.+:smtp' || exit 1" timeout: 3s retries: 0修改postfix-main.cf
sasl_passwd文件对着 163 中继的方法修改即可
smtp_sasl_password_maps=hash:/tmp/docker-mailserver/sasl_passwd # Enable TLS smtpd_use_tls=yes smtp_use_tls=yes # Specify the TLS protocols smtpd_tls_mandatory_protocols=!SSLv2, !SSLv3 smtp_tls_mandatory_protocols=!SSLv2, !SSLv3 # Specify the TLS ciphers smtpd_tls_mandatory_ciphers=high smtp_tls_mandatory_ciphers=high # Enable TLS for SMTP client (when sending mail to external servers) smtp_tls_security_level=encrypt smtp_tls_loglevel=1 # Enable TLS for SMTP server (when receiving mail from external servers) smtpd_tls_security_level=may smtpd_tls_loglevel=1 # Use a specific TLS protocol version (e.g., TLSv1.2 or TLSv1.3) smtpd_tls_protocols=!SSLv2, !SSLv3, !TLSv1, !TLSv1.1 smtp_tls_protocols=!SSLv2, !SSLv3, !TLSv1, !TLSv1.1 # 启动容器 cd /opt/mailserver docker compose up # 测试没问题即可后台运行 使用阿里云邮件推送服务阿里云邮件推送服务，个人用户总免费 2000 封，单日上限 200 封。自己的用的话差不多够了。但是在别人在接收你邮件的时候，发送地址不是你原本的地址（origin）而是你在阿里云上设置的地址。
像腾讯云邮件推送，暂就不写教程 。
地址：
依据官方教程配置即可
compose.yml
services: mailserver: ....... 上面不动 ....... volumes: - ./docker-data/dms/mail-data/:/var/mail/ - ./docker-data/dms/mail-state/:/var/mail-state/ - ./docker-data/dms/mail-logs/:/var/log/mail/ - ./docker-data/dms/config/:/tmp/docker-mailserver/ - ./docker-data/dms/custom-certs/:/tmp/dms/custom-certs/:ro - /etc/localtime:/etc/localtime:ro environment: - SSL_TYPE=manual # 值应与容器内的文件路径匹配： - SSL_CERT_PATH=/tmp/dms/custom-certs/mail.byteload.cn_bundle.crt - SSL_KEY_PATH=/tmp/dms/custom-certs/mail.byteload.cn.key restart: always stop_grace_period: 1m # Uncomment if using `ENABLE_FAIL2BAN=1`: # cap_add: # - NET_ADMIN healthcheck: test: "ss --listening --tcp | grep -P 'LISTEN.+:smtp' || exit 1" timeout: 3s retries: 0修改postfix-main.cf
inet_interfaces = all inet_protocols = ipv4 # 配置中继 relayhost = [smtpdm.aliyun.com]:465 smtp_sasl_password_maps=hash:/tmp/docker-mailserver/sasl_passwd smtp_use_tls = yes smtp_sasl_auth_enable = yes smtp_tls_wrappermode = yes smtp_tls_security_level = encrypt smtp_sasl_security_options = noanonymous smtp_sasl_type = cyrus新建sasl_passwd并修改
[smtpdm.aliyun.com]:465 <your aliyun email domain>:<your account smtp key> # 生成 .db文件 cd /opt/mailserver/docker-data/dms/config postmap ./sasl_passwd # 启动容器 cd /opt/mailserver docker compose up使用阿里云邮件推送服务在进行收发的时候会比较复杂，这里推荐使用雷鸟客户端进行配置
添加邮箱账户
正常输入登录你的 docker mailserver 的账号密码
查看是否发送成功，这里的发件人显示的是你在阿里云上设置的发信地址，而不是你 docker mailserver 设置的邮件地址，这里是比较坑的
测试回复
回复的时候，可能会提示，回复地址与原地址不一样，这就是上面坑导致的
继续回复即可
以上使用 gmail 和 163 邮箱以及阿里云推送等转发会让原始的发件地址变化
这里推荐一个不会更改原始发件地址的 SMTP 服务Mailgun
Mailgun 的账号注册这里就不写了，网上也很多。
建议使用 gmail 账号进行注册，后面激活账号的时候会让填写手机号码，国内的可能会收不到短信验证码。可发邮件联系客服进行人工激活。实测，人工回复速度挺快的，激活速度也挺看的，全程不到 20 分钟。
注册成功后 Mailgun 会给一个沙盒测试域，这里不使用沙盒，点击左侧的导航栏 Send -> Sengding -> Domains添加你的域名，然后根据提示在 DNS 解析商那里配置。
DNS 验证成功后设置 SMTP 的秘钥即可
配置 Mailgun 的 compose.yml 和配置阿里云的是一样，不会的看阿里云的配置
修改postfix-main.cf
inet_interfaces = all inet_protocols = ipv4 # 配置中继 relayhost = [smtp.mailgun.org]:587 smtp_sasl_auth_enable = yes smtp_sasl_password_maps = static:mailgun account:account smtp key smtp_sasl_security_options = noanonymous # TLS support smtp_tls_security_level = may smtpd_tls_security_level = may smtp_tls_note_starttls_offer = yes # 启动容器 cd /opt/mailserver # 关闭容器 docker compose down # 启动容器 docker compose up配置完成后可用Java代码或则其他语言代码进行邮件发送的测试，根据不同的保存原因和服务日志进行调整
使用雷鸟或者 eM Client 进行正常的账号密码登录即可，登录完成后不需要更改其他设置即可使用。
到此邮件的配置就结束了，感兴趣的不妨给个点赞收藏，你的点赞收藏是我继续更新的动力❤
