热门搜索:
tozd/postfix
自动构建
tozd
Postfix邮件传输代理Docker镜像，用于部署轻量级邮件发送与接收服务。
33 次收藏下载次数: 0状态：自动构建维护者：tozd仓库类型：镜像最近更新：12 天前
tozd/postfix Docker镜像文档
镜像概述和主要用途
tozd/postfix 是一个提供 Postfix 邮件传输代理的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:
registry.gitlab.com/tozd/docker/postfix
标签信息
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 \ tozd/postfix:ubuntu-jammy
2. 使用docker-compose配置
yamlversion: '3.8' services: postfix: image: 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://github.com/tozd/docker-postfix
- Postfix官方文档
- 扩展示例：tozd/mail（完整邮件服务）、https://github.com/cloyne/docker-postfix%EF%BC%88%E9%9B%86%E6%88%90%E9%82%AE%E4%BB%B6%E5%88%97%E8%A1%A8%EF%BC%89
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
DockerHub 原生拉取命令
docker pull tozd/postfix:<标签>
更多 postfix 镜像推荐
library/postfixadmin
Docker 官方镜像
Postfix Admin是用于Postfix邮件服务器的基于Web的管理界面。
214 次收藏500万+ 次下载
7 天前更新
juanluisbaptiste/postfix
juanluisbaptiste
简单的Postfix SASL SMTP中继
58 次收藏1000万+ 次下载
1 个月前更新
boky/postfix
boky
基于Alpine Linux的简单Postfix中继主机，适用于Docker容器。
51 次收藏1000万+ 次下载
28 天前更新
chatwork/postfix
chatwork
Postfix是一款开源邮件传输代理(MTA)，用于处理电子邮件的发送、接收与路由，具备安全、可靠、高性能特性，适用于构建邮件服务器。
1 次收藏10万+ 次下载
4 天前更新
mailcow/postfix
mailcow
mailcow Docker镜像是开源邮件服务器套件，集成SMTP、IMAP、POP3等核心服务，支持Docker快速部署，用于便捷搭建和管理自建邮件服务器。
21 次收藏1000万+ 次下载
1 年前更新
eeacms/postfix
eeacms
Postfix SMTP专用Docker镜像，支持SMTP中继功能。
15 次收藏100万+ 次下载
2 个月前更新
轩辕镜像配置手册
探索更多轩辕镜像的使用方法，找到最适合您系统的配置方式
Docker 配置
登录仓库拉取
通过 Docker 登录认证访问私有仓库
专属域名拉取
无需登录使用专属域名
K8s Containerd
Kubernetes 集群配置 Containerd
K3s
K3s 轻量级 Kubernetes 镜像加速
Dev Containers
VS Code Dev Containers 配置
Podman
Podman 容器引擎配置
Singularity/Apptainer
HPC 科学计算容器配置
其他仓库配置
ghcr、Quay、nvcr 等镜像仓库
Harbor 镜像源配置
Harbor Proxy Repository 对接专属域名
Portainer 镜像源配置
Portainer Registries 加速拉取
Nexus 镜像源配置
Nexus3 Docker Proxy 内网缓存
系统配置
需要其他帮助？请查看我们的 常见问题Docker 镜像访问常见问题解答 或 提交工单
镜像拉取常见问题
使用与功能问题
配置了专属域名后，docker search 为什么会报错？
docker search 限制
Docker Hub 上有的镜像，为什么在轩辕镜像网站搜不到？
站内搜不到镜像
机器不能直连外网时，怎么用 docker save / load 迁镜像？
离线 save/load
docker pull 拉插件报错（plugin v1+json）怎么办？
插件要用 plugin install
WSL 里 Docker 拉镜像特别慢，怎么排查和优化？
WSL 拉取慢
轩辕镜像安全吗？如何用 digest 校验镜像没被篡改？
安全与 digest
第一次用轩辕镜像拉 Docker 镜像，要怎么登录和配置？
新手拉取配置
轩辕镜像合规吗？轩辕镜像的合规是怎么做的？
镜像合规机制
错误码与失败问题
docker pull 提示 manifest unknown 怎么办？
manifest unknown
docker pull 提示 no matching manifest 怎么办？
no matching manifest（架构）
镜像已拉取完成，却提示 invalid tar header 或 failed to register layer 怎么办？
invalid tar header（解压）
Docker pull 时 HTTPS / TLS 证书验证失败怎么办？
TLS 证书失败
Docker pull 时 DNS 解析超时或连不上仓库怎么办？
DNS 超时
docker 无法连接轩辕镜像域名怎么办？
域名连通性排查
Docker 拉取出现 410 Gone 怎么办？
410 Gone 排查
出现 402 或「流量用尽」提示怎么办？
402 与流量用尽
Docker 拉取提示 UNAUTHORIZED（401）怎么办？
401 认证失败
遇到 429 Too Many Requests（请求太频繁）怎么办？
429 限流
docker login 提示 Cannot autolaunch D-Bus，还算登录成功吗？
D-Bus 凭证提示
为什么会出现「单层超过 20GB」或 413，无法加速拉取？
413 与超大单层
账号 / 计费 / 权限
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"