rylorin/postfix-relay

postfix-relay

镜像概述和主要用途

Postfix SMTP中继Docker镜像，适用于无需使用外部SMTP服务器发送邮件，或为虚拟域转发邮件的场景。默认配置确保安全性，避免成为开放中继，可通过环境变量灵活自定义Postfix配置。

核心功能和特性

• 支持通过POSTFIX_<name>环境变量自定义所有Postfix配置参数
• 内置DKIM支持，自动生成密钥对并提供DNS记录配置指引
• 支持虚拟域邮件转发，可将特定域的邮件转发至指定***
• 兼容Docker和docker-compose部署，配置简单灵活

使用场景和适用范围

• 个人或小型团队自建SMTP服务器发送邮件
• 虚拟域邮件集中转发管理（如将多个域名邮件转发至统一***）
• 需要自定义SMTP配置的应用场景
• 对邮件发送安全性有要求（需配合SPF/DKIM配置）的场景

使用方法和配置说明

镜像获取

bash
docker pull rylorin/postfix-relay

或克隆源码自行构建。

配置说明

所有Postfix配置项可通过POSTFIX_<name>格式的环境变量设置，例如POSTFIX_myhostname用于设置220/HELO使用的FQDN。默认配置可查看Dockerfile。

部署示例

使用docker run

bash
docker run \
    -e POSTFIX_myhostname=smtp.domain.tld \
    --name smtp \
    rylorin/postfix-relay

使用docker-compose

yaml
app:
  # 使用主机名"smtp"作为SMTP服务器

smtp:
  image: rylorin/postfix-relay
  restart: always
  environment:
    - POSTFIX_myhostname=smtp.domain.tld

SPF配置

使用自建SMTP服务器发送邮件时，建议为发送域名配置SPF（发件人策略框架），以提高邮件送达率和可信度。

DKIM配置

要启用DKIM（域名密钥识别邮件），需通过环境变量OPENDKIM_DOMAINS指定空格分隔的域名列表。容器启动时，若/etc/opendkim/keys/<domain>目录中不存在密钥对，将自动生成。

密钥持久化

为持久化密钥，需将主机目录挂载至容器的/etc/opendkim/keys路径。使用docker-compose时，数据卷会自动在容器重建时保留。

DNS记录查看

DKIM所需的DNS记录可在容器日志中查看，或通过以下命令获取：

bash
docker exec <container> cat /etc/opendkim/keys/*/mail.txt

虚拟域转发配置

可将特定域的邮件转发至其他***（如Gmail），转发流程如下：

superman@site.com的邮件 ==> [site.com Postfix服务器] ==> 转发至superman@gmail.com

DNS设置

需为域名添加MX记录，确保邮件投递至Postfix服务器：

site.com. 85100 IN MX 10 mail.site.com.

其中mail.site.com.为Postfix服务器地址。

Docker主机设置

在主机创建目录存放虚拟地址映射文件，该目录将挂载至容器。虚拟文件格式示例：

@site.com            superman@gmail.com superman@yahoo.com
contact@site2.com    superman2@gmail.com
@site3.com           superman3@gmail.com

更多配置细节可参考Postfix官方文档。

Docker镜像配置

使用docker-compose整合配置：

yaml
version: '2'
services:
  app:
    # 使用主机名"smtp"作为SMTP服务器
  smtp:
    image: rylorin/postfix-relay
    environment:
      POSTFIX_virtual_alias_domains: site.com site2.com site3.com
      POSTFIX_myhostname: mail.site.com
    volumes:
    - /path/to/your/host/conf.d:/etc/postfix/conf.d:rw
    ports:
    - 25:25/tcp

许可证

postfix-relay采用MIT许可证，详见LICENSE。