Postfix邮件传输代理Docker镜像,用于部署轻量级邮件发送与接收服务。
33 次收藏下载次数: 0状态:自动构建维护者:tozd仓库类型:镜像最近更新:
tozd/postfix Docker镜像文档
镜像概述和主要用途
tozd/postfix 是一个提供 http://www.postfix.org/ 邮件传输代理的Docker镜像。该镜像基于 tozd/dinit 构建,支持多种操作系统版本(Ubuntu和Alpine Linux)及硬件架构,主要用于发送出站电子邮件。通过持久化存储和环境变量配置,可灵活适应不同场景,并支持扩展为完整的邮件服务或作为其他容器的邮件中继节点。
核心功能和特性
- 多版本支持:提供基于不同Ubuntu(trusty至noble)和Alpine Linux(3.8至3.22)版本的镜像,对应Postfix 2.11.0至3.10.2版本
- 多架构兼容:支持
amd64和arm64架构 - 持久化存储:关键数据目录(如邮件队列)支持卷挂载,避免容器重建时数据丢失
- 灵活配置:通过环境变量自定义Postfix核心参数(如
myhostname、mynetworks) - 日志管理:支持日志输出到stdout(适用于容器日志收集)或文件系统
- 可扩展性:提供启动时自定义配置脚本,支持扩展为完整邮件服务(如集成虚拟用户)
使用场景和适用范围
主要适用场景
- 作为独立出站邮件服务器,发送系统或应用产生的电子邮件
- 作为其他容器的邮件中继节点,集中处理邮件发送
- 扩展为完整邮件服务(需结合虚拟用户管理等功能,如
tozd/mail示例) - 为Docker环境中的应用提供本地
sendmail命令支持(推荐配合tozd/mailer使用)
不适用场景
- 仅需本地发送邮件的简单场景(推荐使用轻量级的
tozd/mailer或tozd/nginx-mailer)
详细使用方法和配置说明
镜像获取
可通过以下仓库获取:
- Docker Hub: https://hub.docker.com/r/tozd/postfix
- GitLab Container Registry: https://gitlab.com/tozd/docker/postfix/container_registry
标签信息
Ubuntu 系列(基于不同Ubuntu版本)
ubuntu-trusty: Postfix 2.11.0ubuntu-xenial: Postfix 3.1.0ubuntu-bionic: Postfix 3.3.0ubuntu-focal: Postfix 3.4.13ubuntu-jammy: Postfix 3.6.4ubuntu-noble: Postfix 3.8.6
Alpine Linux 系列(基于不同Alpine版本)
alpine-38: Postfix 3.3.0alpine-310: Postfix 3.4.7alpine-312: Postfix 3.5.16alpine-314: Postfix 3.6.4alpine-316: Postfix 3.7.6alpine-318: Postfix 3.8.9alpine-320: Postfix 3.9.3alpine-322: Postfix 3.10.2
架构支持
amd64arm64
卷(Volumes)
| 卷路径 | 用途说明 |
|---|---|
/var/log/postfix | 日志存储目录(当LOG_TO_STDOUT未设为1时)。Postfix 3.4之前版本不支持日志轮转 |
/var/spool/postfix | 邮件队列及状态存储目录,必须持久化挂载以避免数据丢失 |
环境变量(Variables)
| 变量名 | 说明 | 默认值 |
|---|---|---|
MAILNAME | 设置/etc/mailname及Postfix的myhostname配置项 | - |
MY_NETWORKS | 设置Postfix的mynetworks配置项(信任网络) | 172.17.0.0/16 127.0.0.0/8 |
MY_DESTINATION | 设置Postfix的mydestination配置项(本地投递目标) | localhost.localdomain, localhost |
ROOT_ALIAS | 容器内root用户邮件的转发目标***(非扩展场景通常无需设置) | - |
LOG_TO_STDOUT | 设为1时日志输出到stdout(通过docker logs查看),仅Postfix 3.4+支持 | - |
端口(Ports)
| 端口 | 用途 |
|---|---|
25/tcp | SMTP服务端口 |
465/tcp | SMTPS(SSL)端口 |
587/tcp | 邮件提交端口(MSA) |
部署方案示例
1. 使用docker run快速启动
bashdocker run -d \ --name postfix \ -p 25:25 \ -e MAILNAME="mail.example.com" \ -e MY_NETWORKS="172.17.0.0/16 192.168.1.0/24" \ -v postfix-spool:/var/spool/postfix \ docker.xuanyuan.run/tozd/postfix:ubuntu-jammy
2. 使用docker-compose配置
yamlversion: '3.8' services: postfix: image: docker.xuanyuan.run/tozd/postfix:ubuntu-jammy container_name: postfix restart: always ports: - "25:25" - "587:587" environment: - MAILNAME=mail.example.com - MY_NETWORKS=172.17.0.0/16 192.168.1.0/24 - LOG_TO_STDOUT=1 volumes: - postfix-spool:/var/spool/postfix # 若不使用LOG_TO_STDOUT,挂载日志卷 # - postfix-logs:/var/log/postfix networks: - mail-network volumes: postfix-spool: driver: local # postfix-logs: # driver: local networks: mail-network: driver: bridge
高级配置与扩展
自定义启动脚本
扩展镜像时,可添加以下脚本实现自定义配置:
/etc/service/postfix/run.config:启动初期执行,用于准备自定义配置/etc/service/postfix/run.initialization:初始化后、Postfix启动前执行
Alpine Linux镜像注意事项
- 不支持
hash/btree查找表(Alpine 3.13+移除Berkeley DB支持) - 需使用
lmdb类型数据库,例如:virtual_alias_maps = lmdb:/etc/postfix/virtual
最佳实践
- 域名与IP匹配:确保邮件服务器的外部IP与
MAILNAME解析的IP一致,以提升邮件送达率(可配合tozd/external-ip镜像获取外部IP) - 持久化卷:必须挂载
/var/spool/postfix卷,避免容器重建导致邮件队列丢失 - 日志管理:Postfix 3.4+推荐使用
LOG_TO_STDOUT=1,便于容器日志收集;旧版本需手动配置日志轮转 - 安全配置:根据实际网络环境调整
MY_NETWORKS,限制信任来源
相关链接
- https://gitlab.com/tozd/docker/postfix
- https://github.com/tozd/docker-postfix
- http://www.postfix.org/
- 扩展示例:https://gitlab.com/tozd/docker/mail(完整邮件服务)、https://github.com/cloyne/docker-postfix(集成邮件列表)
tozd 命名空间的其他可用镜像:
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。
DockerHub 原生拉取命令
docker pull tozd/postfix:<标签>
用户好评
来自真实用户的反馈,见证轩辕镜像的优质服务