vednil/postfix

Postfix Docker镜像文档

快速参考

• 维护者：https://gitlab.com/vednil/kehat

镜像概述

Postfix是一款开源的邮件传输代理（MTA），主要用于发送和接收邮件。该Docker镜像封装了Postfix服务，支持与Dovecot（邮件投递与用户认证）、Amavis（病毒和垃圾邮件检测）、OpenDKIM（邮件签名与验证）、OpenDMARC（DMARC记录检查）等服务集成，并通过数据库存储域名和***信息。

核心功能与特性

• 支持邮件发送与接收
• 集成Dovecot实现邮件投递和用户认证
• 与Amavis联动进行病毒和垃圾邮件检测
• 通过OpenDKIM实现邮件签名与验证
• 支持OpenDMARC检查DMARC记录
• 可使用自签名证书或Let's Encrypt证书进行TLS加密
• 通过数据库存储域名和***信息

使用场景

适用于需要搭建邮件服务器的环境，如企业内部邮件系统、个人邮件服务等，尤其适合与Dovecot、Amavis等邮件相关服务组成完整的邮件处理系统。

使用方法

使用自签名证书运行Postfix

bash
$ docker run -d \
        -p 25:25 \
        -p 587:587 \
        -e DOMAIN=mail.example.com \
        -e DOVECOT_HOST=dovecot \
        -e AMAVIS_HOST=amavis \
        -e OPENDKIM_HOST=opendkim \
        -e OPENDMARC_HOST=opendmarc \
        -e DB_HOST=db \
        -e DB_USER=postfix \
        -e DB_PASSWORD=password \
        -e DB_NAME=postfix \
        -v postfix:/etc/postfix/private  \
        vednil/postfix

注意：/etc/postfix/private目录用于存储自签名证书和Diffie-Hellman密钥，证书将在容器启动时自动创建。

使用现有Let's Encrypt证书运行Postfix

bash
$ docker run -d \
        -p 25:25 \
        -p 587:587 \
        -e DOMAIN=mail.example.com \
        -e DOVECOT_HOST=dovecot \
        -e AMAVIS_HOST=amavis \
        -e OPENDKIM_HOST=opendkim \
        -e OPENDMARC_HOST=opendmarc \
        -e DB_HOST=db \
        -e DB_USER=postfix \
        -e DB_PASSWORD=password \
        -e DB_NAME=postfix \
        -e SMTPD_TLS_CHAIN_FILES="/etc/letsencrypt/live/mail.example.com/privkey.pem /etc/letsencrypt/live/mail.example.com/fullchain.pem" \
        -v /etc/letsencrypt/live/mail.example.com:/etc/letsencrypt/live/mail.example.com:ro  \
        -v /etc/letsencrypt/archive/mail.example.com:/etc/letsencrypt/archive/mail.example.com:ro \
        vednil/postfix sh -c 'while :; do sleep 6h & wait ${!}; postfix check && postfix reload; done & postfix start-fg'

注意：Postfix不会获取或续订Let's Encrypt证书（可使用nginx和certbot获取并续订证书）。此镜像通过自定义命令每6小时执行postfix reload，以在证书续订后应用更新。

环境变量

DOMAIN

用于设置Postfix的myhostname参数。

DOVECOT_HOST

Dovecot的IP地址或DNS名称，用于邮件投递和用户认证。

AMAVIS_HOST

Amavis的IP地址或DNS名称，用于邮件病毒和垃圾邮件检测。

OPENDKIM_HOST

OpenDKIM的IP地址或DNS名称，用于 outgoing邮件签名和incoming邮件验证。

OPENDMARC_HOST

OpenDMARC的IP地址或DNS名称，用于检查DMARC记录。

DB_HOST

MariaDB的IP地址或DNS名称，数据库用于存储域名和***信息。

DB_USER

数据库用户名。

DB_PASSWORD

数据库用户密码。

DB_NAME

数据库名称。

SMTPD_TLS_CHAIN_FILES（可选）

用于设置Postfix的smtpd_tls_chain_files参数，指定现有证书文件路径。可列出一个或多个PEM文件，例如私钥和证书链。