docker-postfix 镜像文档

1. 镜像概述与主要用途

docker-postfix 是一个 Docker 容器化的 Postfix 邮件传输代理（MTA）镜像，支持 SMTP 认证（基于 sasldb），并可选集成 TLS 加密和 OpenDKIM 邮件签名功能。该镜像旨在简化 Postfix 的部署流程，通过容器化方式提供轻量、可移植的邮件服务解决方案。

2. 核心功能与特性

• SMTP 认证：基于 sasldb 实现 SMTP 客户端认证，防止未授权邮件中继
• TLS 支持：可选启用 TLS 加密，保障邮件传输过程中的数据安全
• OpenDKIM 支持：可选集成 DKIM 签名机制，提升邮件送达率和可信度
• 容器化部署：简化依赖管理，支持快速启动和跨环境部署

3. 使用场景与适用范围

• 个人或小型企业邮件服务器搭建
• 开发/测试环境中的邮件发送服务
• 需要 SMTP 认证机制的邮件中继服务
• 对邮件传输安全性有要求（需 TLS/DKIM）的场景

4. 使用方法与配置说明

4.1 环境变量说明

4.2 卷挂载说明

4.3 端口映射说明

4.4 Docker Run 命令示例

bash
docker run -d \
  -p 25:25 \          # 映射 SMTP 标准端口
  -p 587:587 \        # 映射 SMTP 提交端口
  -e maildomain=example.com \  # 设置邮件服务器域名
  -e mydestination='$myhostname, localhost, example.com' \  # 设置本地投递域名
  -e smtp_user=user1:pwd1,user2:pwd2 \  # 设置 SMTP 认证用户（多用户用逗号分隔）
  -v /root/domainkeys:/etc/opendkim/domainkeys \  # 挂载 DKIM 密钥目录（可选）
  -v /root/certs:/etc/postfix/certs \  # 挂载 TLS 证书目录（可选）
  --name postfix \
  vault/postfix

4.5 Docker Compose 配置示例

yaml
version: '3'
services:
  postfix:
    image: vault/postfix
    container_name: postfix
    restart: always
    ports:
      - "25:25"    # SMTP 标准端口
      - "587:587"  # SMTP 提交端口
    environment:
      - maildomain=example.com  # 邮件服务器域名
      - mydestination=$myhostname, localhost, example.com  # 本地投递域名列表
      - smtp_user=user1:pwd1,user2:pwd2  # SMTP 认证用户（用户:密码，多用户逗号分隔）
    volumes:
      - /root/domainkeys:/etc/opendkim/domainkeys  # DKIM 密钥目录（可选）
      - /root/certs:/etc/postfix/certs  # TLS 证书目录（可选）

5. 注意事项

• SMTP 客户端登录凭证：客户端需使用 username@maildomain（如 ***）作为用户名，对应 smtp_user 中设置的密码进行认证
• 主机端口自定义：若需修改主机映射端口（非默认 25/587），可参考 Postfix 多实例文档 进行配置调整
• DKIM 配置：启用 OpenDKIM 时，需提前生成域名密钥对并挂载至 /etc/opendkim/domainkeys，同时将公钥添加至域名的 DNS TXT 记录中（具体操作参考 DKIM 配置文档）