使用 docker-compose（推荐）#

1
services:
2
  maddy:
3
    image: foxcpp/maddy:latest
4
    container_name: maddy
5
    restart: unless-stopped
6
    ports:
7
      - "25:25"       # SMTP (接收外部邮件)
8
      - "587:587"     # SMTP Submission (客户端发信)
9
      - "143:143"     # IMAP
10
      - "993:993"     # IMAPS (TLS)
11
    environment:
12
      - MADDY_HOSTNAME=mx.example.com   # 邮件服务器主机名
13
      - MADDY_DOMAIN=example.com        # 处理的邮件域名
14
    volumes:
15
      - ./maddy-data:/data

1
docker compose up -d

TIP

/data 目录会自动生成默认配置文件 maddy.conf，以及 DKIM 私钥等数据。需要自定义配置时，直接编辑 ./maddy-data/maddy.conf 后重启容器。

配置 TLS 证书#

maddy 首次启动会因找不到证书而失败。将证书文件复制到数据目录：

1
cp /path/to/fullchain.pem ./maddy-data/tls/fullchain.pem
2
cp /path/to/privkey.pem   ./maddy-data/tls/privkey.pem

然后重启容器：

1
docker compose restart maddy

基础记录#

IMPORTANT

PTR 反向解析（rDNS）是许多邮件服务器判断是否接收邮件的重要依据，务必配置，否则发出的邮件极易进垃圾箱。

SPF 记录#

1
v=spf1 mx ~all

DKIM 记录#

maddy 在首次启动后会自动生成 DKIM 密钥，查看公钥内容：

1
cat ./maddy-data/dkim_keys/example.com_default.dns

输出示例（格式为 DNS TXT 记录值）：

1
v=DKIM1; k=rsa; p=MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA...

将该内容添加到 DNS：

DMARC 记录#

1
v=DMARC1; p=quarantine; rua=mailto:postmaster@example.com

TIP

DNS 记录生效通常需要几分钟到数小时，配置完成后可使用 mail-tester.com 检测评分，7 分以上为合格。

创建邮箱账户#

创建登录凭证（执行后会提示设置密码）：

1
maddy creds create admin@example.com

创建 IMAP 存储账户：

1
maddy imap-acct create admin@example.com

IMPORTANT

两步都要执行：creds create 负责认证登录，imap-acct create 负责创建邮件存储。缺少任意一步，账户都无法正常使用。

修改密码#

1
maddy creds password admin@example.com

查看账户列表#

1
maddy creds list
2
maddy imap-acct list

管理邮箱文件夹#

查看账户下的邮箱分类：

1
maddy imap-mboxes list admin@example.com

测试收信#

使用 QQ 邮箱、Gmail 等向 admin@example.com 发送一封测试邮件，然后在容器内查看收件箱：

1
maddy imap-msgs list admin@example.com INBOX

测试发信评分#

使用邮件客户端（Thunderbird、Apple Mail 等）通过以下参数连接后发送测试邮件到 mail-tester.com：