postfix

01it/postfix Docker 镜像

这是一款轻量的Postfix邮件服务器镜像,支持TLS加密、DKIM签名、直接投递和外部SMTP中继模式,可通过环境变量灵活配置,适配多种邮件服务部署场景。

下载次数: 0状态:社区镜像维护者:01it仓库类型:镜像最近更新:
下载命令
点击查看

镜像概述

本镜像是基于Debian Trixie多阶段构建的轻量Postfix邮件中继服务镜像,内置OpenDKIM签名能力、TLS加密支持以及灵活的投递模式,同时兼容linux/amd64和linux/arm64多架构,可快速搭建稳定可用的邮件服务。

核心功能

  • 直接投递模式:默认将邮件直接发送到收件方的MX邮件服务器
  • 中继转发模式:支持将邮件通过AWS SES、Gmail等外部SMTP服务商转发
  • DKIM签名:内置OpenDKIM服务,启动时自动生成密钥对,支持多域名签名
  • TLS支持:自动生成自签名证书,也可配置自动申请Let's Encrypt可信证书
  • 全量环境变量配置:所有服务参数均可通过环境变量自定义调整
  • 多架构兼容:同时支持linux/amd64和linux/arm64运行环境

使用场景

  1. 企业内部系统出站邮件发送网关
  2. 小团队自建私有邮件中继服务
  3. 对接第三方邮件服务商的中转部署
  4. 开发测试环境邮件模拟发送服务

配置说明

快速启动示例

bash
docker run -d --name postfix \
  -e DOMAIN=example.com \
  -e MAILNAME=mail.example.com \
  -p 25:25 -p 587:587 \
  -v dkim_keys:/etc/ssl/dkim \
  docker.xuanyuan.run/01it/postfix:latest

首次启动时容器会自动生成DKIM密钥对、自签名TLS证书,同时启动OpenDKIM和Postfix服务,可通过以下命令查看DKIM公钥信息:

bash
docker logs postfix 2>&1 | grep -A2 "DKIM PUBLIC KEY"

运行模式说明

直接投递模式(默认)

当未设置RELAY_HOST参数时自动启用,邮件通过25端口直接投递到收件方MX服务器,需满足:

  • 服务器出站25端口未被封禁(云服务商默认通常会封禁该端口)
  • 已正确配置相关DNS解析记录

中继转发模式

设置RELAY_HOST参数即可启用该模式,将所有邮件转发到指定外部SMTP服务商:

yaml
environment:
  - RELAY_HOST=[smtp.example.com]:587
  - SMTP_USERNAME=your-username
  - SMTP_PASSWORD=your-password

认证提交模式

587端口强制要求通过SMTP_AUTH_USERS配置的SASL账号认证,25端口仅允许MY_NETWORKS指定的可信网络无认证中继邮件:

yaml
environment:
  - SMTP_AUTH_USERS=alice:s3cret,bob:hunter2
ports:
  - "587:587"

核心配置参数

变量名默认值说明
DOMAINexample.comDKIM签名使用的主域名
MAILNAMEmail.example.comPostfix主机名,同时作为Let's Encrypt证书的主域名
MY_NETWORKS127.0.0.0/8,10.0.0.0/8,172.16.0.0/12,192.168.0.0/1625端口无认证中继的可信网段
SMTP_AUTH_USERS—587端口认证账号,格式为用户1:密码1,用户2:密码2

DKIM配置参数

变量名默认值说明
DKIM_SELECTORmailDKIM选择器,对应DNS记录前缀
DKIM_KEY_DIR/etc/ssl/dkimDKIM密钥存储目录
DKIM_EXTRA_DOMAINS—支持DKIM签名的额外域名,多个用逗号分隔

中继配置参数

变量名默认值说明
RELAY_HOST—主外部SMTP中继地址,格式如[smtp.gmail.com]:587
SMTP_USERNAME—主中继服务认证用户名
SMTP_PASSWORD—主中继服务认证密码
FALLBACK_RELAY_HOST—主投递失败时使用的备用中继地址

TLS配置参数

变量名默认值说明
LETSENCRYPT_EMAIL—启用Let's Encrypt证书时使用的注册***
LETSENCRYPT_EXTRA_DOMAINS—证书SAN字段包含的额外域名,多个用逗号分隔

自定义Postfix配置

所有Postfix配置项均可通过添加POSTFIX_前缀的环境变量自定义:

yaml
environment:
  - POSTFIX_message_size_limit=52428800
  - POSTFIX_smtp_helo_name=mail.example.com

DNS配置参考

为保证邮件投递成功率,需在域名服务商处配置以下DNS记录:

  1. PTR反向解析:服务器IP的反向解析需与MAILNAME配置一致,在云服务商后台配置
  2. SPF记录:声明允许发送本域名邮件的服务器IP
    example.com.  IN  TXT  "v=spf1 mx ip4:203.0.113.1 -all"
    
  3. DKIM记录:将容器输出的DKIM公钥配置为TXT记录
    mail._domainkey.example.com.  IN  TXT  "v=DKIM1; k=rsa; p=<PUBLIC_KEY>"
    
  4. DMARC记录:配置收件方对认证失败邮件的处理规则
    _dmarc.example.com.  IN  TXT  "v=DMARC1; p=quarantine; rua=mailto:dmarc@example.com"
    

Let's Encrypt证书部署示例

生产环境使用可信TLS证书可大幅提升邮件投递率:

yaml
services:
  postfix:
    image: docker.xuanyuan.run/01it/postfix:latest
    environment:
      - LETSENCRYPT_EMAIL=admin@example.com
      - MAILNAME=mail.example.com
      - LETSENCRYPT_EXTRA_DOMAINS=smtp.example.com
    ports:
      - "80:80"
      - "25:25"
      - "587:587"
    volumes:
      - letsencrypt:/etc/letsencrypt
      - dkim_keys:/etc/ssl/dkim
volumes:
  letsencrypt:
  dkim_keys:

注意:80端口需开放公网访问且不能被CDN代理,用于Let's Encrypt的HTTP-01域名验证。

持久化卷说明

卷名容器内路径说明
postfix_data/var/spool/postfix邮件队列和缓冲数据
postfix_certs/etc/ssl/postfix自签名TLS证书
dkim_keys/etc/ssl/dkimDKIM公私密钥对
letsencrypt/etc/letsencryptLet's Encrypt证书存储(可选)

端口说明

端口协议说明
25SMTP标准邮件投递和接收端口
587Submission带STARTTLS的认证邮件提交端口

注意事项

多数云服务商默认封禁出站25端口,若需使用直接投递模式需要向云服务商提交工单申请解除限制,端口封禁场景建议使用中继模式对接第三方SMTP服务。本镜像强制启用TLS 1.2及以上版本,禁用低版本不安全协议,仅保留高强度加密套件,保障邮件传输安全。所有日志统一输出到标准输出流,可通过docker logs -f postfix命令实时查看运行状态。

镜像拉取方式

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

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

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

DockerHub 原生拉取命令

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