appstore-1panel/apps/maddy-mail/README.md
2023-11-07 14:45:53 +08:00

3.8 KiB
Raw Blame History

使用说明

1. 准备域名证书

使用acme.shcertbot、手动上传等方式准备好域名证书,注意需要按需修改。

证书对应域名为邮箱MX主机名如mail.example.com

2. 创建Docker存储卷

docker volume create maddydata 

3. 安装应用

应用商店安装应用,

第一次安装会显示异常,容器无法正常运行,不必在意,因为缺少证书文件。

忽略错误,进行下一步操作。

4. 域名证书存放到存储卷

存储卷默认路径如下 /var/lib/docker/volumes/maddydata/_data/

# 进入存储卷路径
cd $(docker volume inspect maddydata --format '{{.Mountpoint}}')

# 创建证书文件夹
mkdir -p tls

上传证书和私钥到tls文件夹,并重命名为

  • fullchain.pem
  • privkey.pem

按要求上传完成证书文件后,容器会自动正常运行。

5. 设置DKIM DNS解析

5.1 获取DKIM值

当容器正常运行后

/var/lib/docker/volumes/maddydata/_data/dkim_keys路径下

会有个类似example.com_default.dns的文件

其中则是需要获取的相关信息。

  • 注意按需修改域名

终端查看

cat /var/lib/docker/volumes/maddydata/_data/dkim_keys/example.com_default.dns 

会得到类似以下内容

default._domainkey.example.org.    TXT   "v=DKIM1; k=ed25519; p=nAcUUozPlhc4VPhp7hZl+owES7j7OlEv0laaDEDBAqg="

5.2 设置DNS TXT记录

根据获取的信息设置DNS解析

例子如下: 为 default._domainkey.example.com 添加TXT记录,值设置为v=DKIM1; k=ed25519; p=nAcUUozPlhc4VPhp7hZl+owES7j7OlEv0laaDEDBAqg=

6. 设置DNS解析

  • 注意按需修改
记录类型 域名
A mail.example.com 服务器ipv4地址
A example.com 服务器ipv4地址
AAAA mail.example.com 服务器ipv6地址如果有
AAAA example.com 服务器ipv6地址如果有
MX example.com mail.example.com
TXT mail.example.com v=spf1 mx ~all
TXT example.com v=spf1 mx ~all
TXT _dmarc.example.com v=DMARC1; p=quarantine; ruf=mailto:postmaster@example.com
TXT _mta-sts.example.com v=STSv1; id=1
TXT _smtp._tls.example.com v=TLSRPTv1;rua=mailto:postmaster@example.com

7. 创建发送账户

面板容器界面,连接容器终端,执行以下命令

  • 注意按需修改
maddy creds create postmaster@example.com

maddy imap-acct create postmaster@example.com 

结束

原始相关

Maddy Mail Server

Composable all-in-one mail server.

Maddy Mail Server implements all functionality required to run a e-mail server. It can send messages via SMTP (works as MTA), accept messages via SMTP (works as MX) and store messages while providing access to them via IMAP. In addition to that it implements auxiliary protocols that are mandatory to keep email reasonably secure (DKIM, SPF, DMARC, DANE, MTA-STS).

It replaces Postfix, Dovecot, OpenDKIM, OpenSPF, OpenDMARC and more with one daemon with uniform configuration and minimal maintenance cost.

Note: IMAP storage is "beta". If you are looking for stable and feature-packed implementation you may want to use Dovecot instead. maddy still can handle message delivery business.

CI status Issues tracker