juanluisbaptiste/postfix

docker-postfix

基于Alpine的简单Postfix SMTP TLS中继Docker镜像，未启用本地认证（适用于安全局域网环境）。

此镜像支持以下架构：

• 386
• amd64（_latest_和_alpine_标签）
• armv6
• armv7
• arm64

如需关注此项目的开发进展，请查看我的博客。

可用镜像标签

此镜像采用语义化版本控制。所有支持的架构均提供以下版本标签：

• 主版本（1）
• 次版本（1.0）
• 补丁版本（1.0.0）

此外，amd64架构还提供以下标签：

• latest
• alpine

注意事项

• _alpine_标签已切换为使用master分支，但无关紧要，因为它与_latest_相同。
• 旧的基于CentOS 7的镜像可在_centos_base_image分支_获取，但不再进行开发。

构建说明

克隆此仓库后执行：

cd docker-Postfix
sudo docker build -t juanluisbaptiste/postfix .

或者使用提供的https://github.com/juanluisbaptiste/docker-postfix/blob/master/docker-compose.override.yml文件：

sudo docker-compose build

有关使用多个compose文件的更多信息https://docs.docker.com/compose/production/。您也可以从https://registry.hub.docker.com/u/juanluisbaptiste/postfix/获取预构建的Docker镜像，可通过以下命令拉取：

sudo docker pull docker.xuanyuan.run/juanluisbaptiste/postfix:latest

运行方法

需向容器传递以下环境变量：

• SMTP_SERVER：要使用的SMTP服务器地址。
• SMTP_PORT（可选，默认值：587）：要使用的SMTP服务器端口。
• SMTP_USERNAME（可选）：用于认证的用户名。
• SMTP_PASSWORD（若SMTP_USERNAME已设置则为必填）：SMTP用户的密码。若设置了SMTP_PASSWORD_FILE，则不需要此变量。
• SERVER_HOSTNAME：Postfix容器的服务器主机名。邮件将显示为来自该主机名的域名。

以下环境变量为可选：

• SMTP_HEADER_TAG：为上游跟踪消息添加头信息。有助于垃圾邮件过滤器。将在邮件头中显示为“RelayTag: ${SMTP_HEADER_TAG}”。

• SMTP_NETWORKS：允许添加额外的、逗号分隔的子网以使用中继。使用方式如：-e SMTP_NETWORKS='xxx.xxx.xxx.xxx/xx,xxx.xxx.xxx.xxx/xx'。

  注意：此选项仅在容器使用Docker的https://docs.docker.com/engine/network/tutorials/host/（无网络隔离）运行时有效，以便容器能与Docker主机的网络交互。这意味着您将在网络中运行一个无认证的SMTP中继。请谨慎使用此选项，未来可能会移除。

• SMTP_PASSWORD_FILE：设置为包含密码的挂载文件路径，以避免在环境变量中暴露密码。使用方式如：-e SMTP_PASSWORD_FILE=/secrets/smtp_password -v $(pwd)/secrets/:/secrets/

• SMTP_USERNAME_FILE：设置为包含用户名的挂载文件路径，以避免在环境变量中暴露用户名。使用方式如：-e SMTP_USERNAME_FILE=/secrets/smtp_username -v $(pwd)/secrets/:/secrets/

• ALWAYS_ADD_MISSING_HEADERS：与Postfix的http://www.postfix.org/postconf.5.html#always_add_missing_headers选项相关（默认：`no`）。若设置为`yes`，Postfix将始终添加`From:`、`To:`、`Date:`或`Message-ID:`中缺失的头信息。

• OVERWRITE_FROM：重写所有中继邮件的发件人地址。示例设置：OVERWRITE_FROM=*** 或 OVERWRITE_FROM="Your Name" <***>

• DESTINATION：定义将接受传入消息的域名列表。

• LOG_SUBJECT：在日志中输出消息的主题行。

• SMTPUTF8_ENABLE：启用（默认）或禁用SMTPUTF8支持。有效值为no（禁用）和yes（启用）。不设置此变量将使用Postfix默认值yes。

• MESSAGE_SIZE_LIMIT：更改默认的***字节（10MB）限制。

要从任何位置使用此容器，需将25端口或SMTP_PORT指定的端口暴露给Docker主机服务器：

docker run -d --name postfix -p "25:25"  \
       -e SMTP_SERVER=smtp.bar.com \
       -e SMTP_USERNAME=*** \
       -e SMTP_PASSWORD=XXXXXXXX \
       -e SERVER_HOSTNAME=helpdesk.mycompany.com \
       juanluisbaptiste/postfix

若要从其他Docker容器使用此容器，最好仅发布端口：

docker run -d --name postfix -P \
       -e SMTP_SERVER=smtp.bar.com \
       -e SMTP_USERNAME=*** \
       -e SMTP_PASSWORD=XXXXXXXX \
       -e SERVER_HOSTNAME=helpdesk.mycompany.com \
       juanluisbaptiste/postfix

或者，您可以使用提供的https://github.com/juanluisbaptiste/docker-postfix/blob/master/docker-compose.yml文件启动服务：

sudo docker-compose up -d

要实时查看邮件日志：

docker logs -f postfix

使用Gmail作为中继的注意事项

Gmail默认不允许不使用OAUTH 2的邮件客户端（如Thunderbird或Outlook）进行认证。首先，您需要在https://www.google.com/settings/security/lesssecureapps中启用“不太安全的应用”访问。

同时请注意，邮件的From:头将包含用于通过Gmail SMTP服务器认证的账户***地址（SMTP_USERNAME），除非您https://support.google.com/mail/answer/22370，否则邮件中的发件人地址将被Gmail忽略。

调试

如需排查容器问题，可设置环境变量_DEBUG=yes_以获取更详细的输出。