本站支持搜索的镜像仓库：Docker Hub、gcr.io、ghcr.io、quay.io、k8s.gcr.io、registry.gcr.io、elastic.co、mcr.microsoft.com

tozd/postfix

自动构建

Postfix邮件传输代理Docker镜像，用于部署轻量级邮件发送与接收服务。

33 收藏0 次下载activetozd镜像

🚀轩辕镜像专业版更稳定💎一键安装 Docker 配置镜像源

中文简介版本下载

🚀轩辕镜像专业版更稳定💎一键安装 Docker 配置镜像源

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: tozd/postfix
GitLab Container Registry: registry.gitlab.com/tozd/docker/postfix

标签信息

Ubuntu 系列（基于不同Ubuntu版本）

ubuntu-trusty: Postfix 2.11.0
ubuntu-xenial: Postfix 3.1.0
ubuntu-bionic: Postfix 3.3.0
ubuntu-focal: Postfix 3.4.13
ubuntu-jammy: Postfix 3.6.4
ubuntu-noble: Postfix 3.8.6

Alpine Linux 系列（基于不同Alpine版本）

alpine-38: Postfix 3.3.0
alpine-310: Postfix 3.4.7
alpine-312: Postfix 3.5.16
alpine-314: Postfix 3.6.4
alpine-316: Postfix 3.7.6
alpine-318: Postfix 3.8.9
alpine-320: Postfix 3.9.3
alpine-322: Postfix 3.10.2

架构支持

amd64
arm64

卷（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`快速启动

docker 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`配置

version: '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，限制信任来源