postfix

tozd/postfix Docker Image

tozd
自动构建

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.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/tcpSMTP服务端口
465/tcpSMTPS(SSL)端口
587/tcp邮件提交端口(MSA)

部署方案示例

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 \
  docker.xuanyuan.run/tozd/postfix:ubuntu-jammy

2. 使用docker-compose配置

yaml
version: '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
    

最佳实践

  1. 域名与IP匹配:确保邮件服务器的外部IP与MAILNAME解析的IP一致,以提升邮件送达率(可配合tozd/external-ip镜像获取外部IP)
  2. 持久化卷:必须挂载/var/spool/postfix卷,避免容器重建导致邮件队列丢失
  3. 日志管理:Postfix 3.4+推荐使用LOG_TO_STDOUT=1,便于容器日志收集;旧版本需手动配置日志轮转
  4. 安全配置:根据实际网络环境调整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(集成邮件列表)

镜像拉取方式

您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。

轩辕镜像加速拉取命令点我查看更多 postfix 镜像标签

docker pull docker.xuanyuan.run/tozd/postfix:<标签>

DockerHub 原生拉取命令

docker pull tozd/postfix:<标签>
专业版 · 高速稳定拉取镜像
50GB 仅 ¥8/年
高速镜像下载在线技术支持专业版保障服务可用付费会员免广告