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）

环境变量（Variables）

端口（Ports）

部署方案示例

1. 使用docker run快速启动

bash
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配置

yaml
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
  

最佳实践

1. 域名与IP匹配：确保邮件服务器的外部IP与MAILNAME解析的IP一致，以提升邮件送达率（可配合tozd/external-ip镜像获取外部IP）
2. 持久化卷：必须挂载/var/spool/postfix卷，避免容器重建导致邮件队列丢失
3. 日志管理：Postfix 3.4+推荐使用LOG_TO_STDOUT=1，便于容器日志收集；旧版本需手动配置日志轮转
4. 安全配置：根据实际网络环境调整MY_NETWORKS，限制信任来源

相关链接

• 镜像源码仓库
• GitHub镜像（只读）
• Postfix***文档
• 扩展示例：tozd/mail（完整邮件服务）、cloyne/postfix（集成邮件列表）