ricariel/postfix

Docker Postfix

![License]([***]

一个灵活且现代的Postfix邮件服务器Docker镜像，基于Debian Bookworm构建。

核心功能

• Debian Bookworm基础：构建于稳定且最新的基础镜像之上。
• 灵活配置：通过环境变量轻松配置Postfix，无需直接编辑配置文件。
• 默认安全：开箱即用地启用submission（587）和smtps（465）端口，支持TLS加密和SASL认证。
• 数据库集成：包含MySQL和LDAP支持，用于用户查找和认证。
• 可扩展性：添加自定义启动脚本到docker-entrypoint.d目录以扩展镜像功能。
• 自动维护：每次容器启动时自动运行postfix check和postfix upgrade-configuration。

快速启动

要启动一个基本的Postfix容器，请运行以下命令：

bash
docker run -d --name postfix \
  -e POSTFIX_myhostname=mail.example.com \
  -e POSTFIX_mydomain=example.com \
  -p 25:25 \
  -p 587:587 \
  -p 465:465 \
  ricariel/postfix

配置

环境变量

配置此Postfix镜像的主要方式是使用环境变量。入口脚本会自动将所有以POSTFIX_为前缀的环境变量应用到Postfix的main.cf配置文件中。

脚本会将变量名转换为小写并移除POSTFIX_前缀。例如，POSTFIX_MYHOSTNAME会转换为Postfix配置项myhostname。

如果将环境变量设置为空值，对应的配置项将从配置中移除。

常用配置变量：

端口

Dockerfile暴露以下端口：

• 25/tcp：用于服务器间邮件传输的SMTP端口。
• 587/tcp：用于邮件客户端提交外发邮件的Submission端口（带TLS和SASL）。
• 465/tcp：用于传统邮件客户端的SMTPS端口（带包装模式TLS和SASL）。

卷

/config

此镜像使用/config目录作为挂载自定义配置文件的位置。

/config/ldap

如果需要使用LDAP进行查找，可将LDAP配置文件（如.cf文件）挂载到/config/ldap目录。10-copy启动脚本会自动将它们复制到/etc/postfix/ldap/目录。

示例：

bash
docker run -d --name postfix \
  -v /path/to/my/ldap/configs:/config/ldap \
  ... \
  ricariel/postfix

自定义脚本

可通过向docker-entrypoint.d目录添加脚本扩展镜像功能。放置在此目录中的任何可执行脚本（.sh）会在启动时、Postfix服务启动前执行。

实现方式：基于此镜像创建新的Dockerfile：

dockerfile
FROM ricariel/postfix

COPY my-custom-script.sh /docker-entrypoint.d/

许可证

本项目采用MIT许可证。详情参见LICENSE文件。