hongkongkiwi/postfix-smtp-relay

docker-postfix

基于Alpine Linux的简单Postfix邮件中继镜像，适用于Docker容器环境。

项目更新

注意：尽管提交记录较旧，但项目并未停止维护，它已被视为功能完整。你可在Dockerhub获取最新版本代码（https://hub.docker.com/r/boky/postfix%EF%BC%89%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，集中处理应用的 outgoing邮件发送。内置Postfix支持直接发送消息或中继到企业主服务器。

这是服务器端Postfix镜像，适用于应用发送邮件场景，不支持客户端用户名/密码登录等安全功能，不适合终端用户使用。

核心功能

• 集中管理Docker应用的邮件发送
• 支持直接发送或中继到指定服务器
• 可配置SMTP服务器标识主机名
• 支持中继服务器的认证与TLS加密
• 限制允许发送的网络范围和发件人域名
• 允许通过自定义脚本扩展配置

使用场景

• Docker容器应用发送通知、告警等邮件的场景
• 企业内部Docker集群集中管理邮件中继的场景
• 需要限制邮件发送来源以防止滥用的场景

快速开始

运行容器：

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

使用localhost:1587作为SMTP地址发送邮件（默认用587端口，未暴露25端口）。需确保DNS配置正确以避免邮件被标记为垃圾邮件。

配置选项

支持以下环境变量配置：

$HOSTNAME = Postfix标识主机名
$RELAYHOST = 中继服务器（格式：host[:port]，IPv6用[ip]:port）
$RELAYHOST_USERNAME = 中继服务器用户名（可选）
$RELAYHOST_PASSWORD = 中继服务器密码（可选）
$RELAYHOST_USE_TLS = 是否启用中继TLS（yes/no）
$MYNETWORKS = 允许发送的网络范围（默认私有IPv4段）
$ALLOWED_SENDER_DOMAINS = 允许的发件人域名（空格分隔）
$POSTFIX_EXTRAS_SETTINGS = 额外Postfix配置项

HOSTNAME示例

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

中继服务器示例

• 带端口：-e RELAYHOST=192.168.115.215:587
• IPv6：-e 'RELAYHOST=[2001:db8::1]:587'
• 带认证：-e RELAYHOST=mail.google.com -e RELAYHOST_USERNAME=hello@gmail.com -e RELAYHOST_PASSWORD=world

扩展配置

将.sh脚本放入/docker-init.db/目录，启动时自动执行。示例Dockerfile：

dockerfile
FROM boky/postfix
ADD additional-config.sh /docker-init.db/

安全性

Postfix主进程以root运行，子进程以postfix账户（UID:GID=100:101）运行。