marcelsander/docker-postfix

docker-postfix

项目更新

请注意，尽管提交记录较早，但本项目仍在维护中，已达到功能完善状态。最新代码可在Dockerhub（https://hub.docker.com/r/boky/postfix%EF%BC%89%E8%8E%B7%E5%8F%96%E3%80%82%E5%A6%82%E6%9C%89%E5%BB%BA%E8%AE%AE%EF%BC%8C%E6%AC%A2%E8%BF%8E%E5%85%8B%E9%9A%86%E5%B9%B6%E6%8F%90%E4%BA%A4%E5%90%88%E5%B9%B6%E8%AF%B7%E6%B1%82%E3%80%82

镜像概述和主要用途

本镜像允许在Docker云/swarm环境中运行Postfix，以集中处理容器的外发邮件。内置的Postfix支持两种模式：直接发送邮件或中继至公司主邮件服务器。

这是一个服务器端Postfix镜像，专为应用程序外发邮件设计，不支持用户名/密码登录等客户端安全功能。若需为终端用户设置和管理Postfix，本镜像不适用；若需管理应用程序的外发邮件队列，可继续阅读。

核心功能和特性

• 基于Alpine Linux，轻量高效
• 支持直接发送邮件或中继至外部邮件服务器
• 通过环境变量灵活配置
• 限制私有网络访问，默认仅允许私有IPv4地址
• 支持自定义发件人域名白名单
• 可通过脚本扩展自定义配置

使用场景和适用范围

适用于Docker环境中需要集中管理应用程序外发邮件的场景，例如：

• 微服务架构中的邮件发送统一入口
• 容器化应用的邮件队列管理
• 需通过公司邮件服务器中继外发邮件的企业环境

使用方法

快速启动

运行容器的基本命令：

bash
docker run --rm --name postfix -p 1587:587 boky/postfix

此时可使用localhost:1587作为SMTP服务器地址发送邮件。注意：镜像默认使用提交端口（587），未暴露25端口（通常被ISP封锁或已被其他服务占用）。

配置SMTP服务器的常规注意事项同样适用，例如需确保DNS记录正确配置以避免邮件被标记为垃圾邮件。

配置选项

支持以下环境变量配置：

HOSTNAME

配置SMTP服务器标识的主机名。若未设置，将使用默认Docker主机名（通常为容器ID，如f73792d540a5），可能导致日志追踪困难。建议显式设置：

bash
docker run --rm --name postfix -e HOSTNAME=postfix-docker -p 1587:587 boky/postfix

RELAYHOST、RELAYHOST_USERNAME 和 RELAYHOST_PASSWORD

Postfix默认直接向目标服务器投递邮件。若处于防火墙后或企业环境中，可设置中继服务器转发邮件。

• 基本中继配置：

  bash
  docker run --rm --name postfix -e RELAYHOST=192.168.115.215 -p 1587:587 boky/postfix
  

• 指定中继端口：

  bash
  docker run --rm --name postfix -e RELAYHOST=192.168.115.215:587 -p 1587:587 boky/postfix
  

• IPv6中继地址：

  bash
  docker run --rm --name postfix -e 'RELAYHOST=[2001:db8::1]:587' -p 1587:587 boky/postfix
  

• 带认证的中继：

  bash
  docker run --rm --name postfix -e RELAYHOST=mail.google.com -e RELAYHOST_USERNAME=hello@gmail.com -e RELAYHOST_PASSWORD=world -p 1587:587 boky/postfix
  

MYNETWORKS

默认仅允许私有IPv4网络访问，以防止意外暴露至公网导致垃圾邮件发送。如需支持IPv6或限制更严格的访问，可覆盖此设置：

bash
docker run --rm --name postfix -e "MYNETWORKS=10.1.2.0/24" -p 1587:587 boky/postfix

ALLOWED_SENDER_DOMAINS

若应用仅从特定域名发送邮件，建议限制允许的发件人域名以增强安全性：

bash
docker run --rm --name postfix -e "ALLOWED_SENDER_DOMAINS=example.com example.org" -p 1587:587 boky/postfix

扩展镜像

如需添加自定义Postfix配置或扩展功能，可将脚本添加至/docker-init.db/目录，所有.sh扩展名的文件将在启动脚本末尾自动执行。

示例自定义Dockerfile：

dockerfile
FROM boky/postfix
MAINTAINER Some Randombloke "randombloke@example.com"
ADD Dockerfiles/additional-config.sh /docker-init.db/

构建后，自定义脚本将在Postfix启动前自动执行。

安全性

Postfix主进程以root用户运行（符合其设计），子进程以postfix用户（UID:GID 100:101）运行。