简单的Postfix SASL SMTP中继
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:允许添加额外的、逗号分隔的子网以使用中继。使用方式如:-eSMTP_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_以获取更详细的输出。
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 postfix 镜像标签
DockerHub 原生拉取命令
用户好评
来自真实用户的反馈,见证轩辕镜像的优质服务