takeyamajp/postfix

postfix

如果这个仓库对您有用，请给它加星标。

支持的标签及对应Dockerfile链接

• https://github.com/takeyamajp/docker-postfix/blob/master/rocky8/Dockerfile (基于Rocky Linux) https://github.com/takeyamajp/docker-postfix/blob/master/alma8/Dockerfile (基于AlmaLinux)
• https://github.com/takeyamajp/docker-postfix/blob/master/centos8/Dockerfile (CentOS 8支持已结束)
• https://github.com/takeyamajp/docker-postfix/blob/master/centos7/Dockerfile

支持的架构: (https://github.com/docker-library/official-images#architectures-other-than-amd64)

amd64, arm64v8(适用于树莓派)

镜像概述

FROM rockylinux:8  
MAINTAINER "Hiroki Takeyama"

ENV TIMEZONE Asia/Tokyo

ENV HOSTNAME smtp.example.com  
ENV DOMAIN_NAME example.com

ENV MESSAGE_SIZE_LIMIT ***

ENV AUTH_USER user  
ENV AUTH_PASSWORD password

ENV DISABLE_SMTP_AUTH_ON_PORT_25 true

ENV ENABLE_DKIM true  
ENV DKIM_KEY_LENGTH 1024  
ENV DKIM_SELECTOR default

# SSL证书  
VOLUME /ssl_certs
# DKIM密钥  
VOLUME /dkim_keys

# SMTP  
EXPOSE 25  
# 提交端口  
EXPOSE 587  
# SMTPS  
EXPOSE 465

核心功能和特性

• 支持SSL/TLS安全连接，确保邮件传输安全
• 内置DKIM签名功能，提升邮件送达率，减少被标记为垃圾邮件的风险
• 可通过环境变量灵活配置时区、主机名、域名、消息大小限制等参数
• 自动生成自签名SSL证书，也支持使用自定义有效证书
• 完整的日志记录，包括成功和失败的邮件投递信息
• 跨架构支持，兼容amd64和arm64v8（如树莓派）

使用场景和适用范围

• 网站或应用程序的邮件通知服务（如注册验证、密码重置）
• 服务器监控告警邮件发送
• 需要可靠发送邮件但无需接收功能的场景
• 开发和测试环境中的邮件发送测试

使用方法和配置说明

通过https://github.com/docker/compose%E9%83%A8%E7%BD%B2

yaml
version: '3'  
services:  
  postfix:  
    image: takeyamajp/postfix  
    ports:  
      - "8025:25"  # SMTP端口
      - "8587:587" # 提交端口
      - "8465:465" # SMTPS端口
    volumes:  
      - /my/own/certs:/ssl_certs  # 挂载SSL证书目录
      - /my/own/keys:/dkim_keys   # 挂载DKIM密钥目录
    environment:  
      TIMEZONE: "Asia/Tokyo"               # 时区
      HOSTNAME: "smtp.example.com"         # 主机名
      DOMAIN_NAME: "example.com"           # 域名
      MESSAGE_SIZE_LIMIT: "10240000"       # 消息大小限制（字节）
      AUTH_USER: "user"                    # 认证用户名
      AUTH_PASSWORD: "password"            # 认证密码
      DISABLE_SMTP_AUTH_ON_PORT_25: "true" # 是否禁用25端口认证
      ENABLE_DKIM: "true"                  # 是否启用DKIM
      DKIM_KEY_LENGTH: "1024"              # DKIM密钥长度
      DKIM_SELECTOR: "default"             # DKIM选择器

时区配置

可使用Rocky Linux支持的任何时区，如"America/Chicago"。
时区列表参考：[***]

消息大小限制

指可发送邮件的最大字节数（包含附件）。默认值为***字节（约10MB），如需发送更大邮件，可增大MESSAGE_SIZE_LIMIT的值。

认证用户名

认证用户名格式类似电子邮件地址（例如***），但不会显示在发送的邮件中，因此可根据需要设置任意发件人地址。

端口说明

• 25端口：默认禁用认证，如需使用，将DISABLE_SMTP_AUTH_ON_PORT_25设为"false"
• 587端口：推荐使用的提交端口
• 465端口：SMTPS（SMTP over SSL）端口，如邮件客户端需要，可使用此端口并忽略证书警告

SSL证书配置

• 自签名证书会自动生成在/ssl_certs卷中，可将其添加到操作系统（如Windows、Linux、iOS、Android）的根证书以避免邮件客户端警告
• 如拥有有效服务器证书，可直接使用；若有中间证书，需附加到服务器证书后：

  bash
  cat server_cert.pem intermediate_CA.pem > cert.pem
  

DKIM密钥配置

• 公钥会显示在"docker logs"中
• 必须挂载/dkim_keys卷到主机，否则容器重启时密钥会改变
• 若DNS服务器支持超过255长度的TXT记录，可将DKIM_KEY_LENGTH设为2048
• 若存在其他邮件服务器，需修改DKIM_SELECTOR（默认"default"）以避免冲突

日志查看

容器会记录所有成功和失败的邮件投递日志，可通过以下命令实时查看：

bash
docker logs -f postfix