postfix

juanluisbaptiste/postfix Docker Image

juanluisbaptiste
自动构建

简单的Postfix SASL SMTP中继

60 次收藏下载次数: 0状态:自动构建维护者:juanluisbaptiste仓库类型:镜像最近更新:

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_以获取更详细的输出。

镜像拉取方式

您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。

轩辕镜像加速拉取命令点我查看更多 postfix 镜像标签

docker pull docker.xuanyuan.run/juanluisbaptiste/postfix:<标签>

DockerHub 原生拉取命令

docker pull juanluisbaptiste/postfix:<标签>
专业版 · 高速稳定拉取镜像
50GB 仅 ¥8/年
高速镜像下载在线技术支持专业版保障服务可用付费会员免广告