这是一款轻量的Postfix邮件服务器镜像,支持TLS加密、DKIM签名、直接投递和外部SMTP中继模式,可通过环境变量灵活配置,适配多种邮件服务部署场景。
镜像概述
本镜像是基于Debian Trixie多阶段构建的轻量Postfix邮件中继服务镜像,内置OpenDKIM签名能力、TLS加密支持以及灵活的投递模式,同时兼容linux/amd64和linux/arm64多架构,可快速搭建稳定可用的邮件服务。
核心功能
- 直接投递模式:默认将邮件直接发送到收件方的MX邮件服务器
- 中继转发模式:支持将邮件通过AWS SES、Gmail等外部SMTP服务商转发
- DKIM签名:内置OpenDKIM服务,启动时自动生成密钥对,支持多域名签名
- TLS支持:自动生成自签名证书,也可配置自动申请Let's Encrypt可信证书
- 全量环境变量配置:所有服务参数均可通过环境变量自定义调整
- 多架构兼容:同时支持linux/amd64和linux/arm64运行环境
使用场景
- 企业内部系统出站邮件发送网关
- 小团队自建私有邮件中继服务
- 对接第三方邮件服务商的中转部署
- 开发测试环境邮件模拟发送服务
配置说明
快速启动示例
bashdocker 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公钥信息:
bashdocker logs postfix 2>&1 | grep -A2 "DKIM PUBLIC KEY"
运行模式说明
直接投递模式(默认)
当未设置RELAY_HOST参数时自动启用,邮件通过25端口直接投递到收件方MX服务器,需满足:
- 服务器出站25端口未被封禁(云服务商默认通常会封禁该端口)
- 已正确配置相关DNS解析记录
中继转发模式
设置RELAY_HOST参数即可启用该模式,将所有邮件转发到指定外部SMTP服务商:
yamlenvironment: - RELAY_HOST=[smtp.example.com]:587 - SMTP_USERNAME=your-username - SMTP_PASSWORD=your-password
认证提交模式
587端口强制要求通过SMTP_AUTH_USERS配置的SASL账号认证,25端口仅允许MY_NETWORKS指定的可信网络无认证中继邮件:
yamlenvironment: - SMTP_AUTH_USERS=alice:s3cret,bob:hunter2 ports: - "587:587"
核心配置参数
| 变量名 | 默认值 | 说明 |
|---|---|---|
DOMAIN | example.com | DKIM签名使用的主域名 |
MAILNAME | mail.example.com | Postfix主机名,同时作为Let's Encrypt证书的主域名 |
MY_NETWORKS | 127.0.0.0/8,10.0.0.0/8,172.16.0.0/12,192.168.0.0/16 | 25端口无认证中继的可信网段 |
SMTP_AUTH_USERS | — | 587端口认证账号,格式为用户1:密码1,用户2:密码2 |
DKIM配置参数
| 变量名 | 默认值 | 说明 |
|---|---|---|
DKIM_SELECTOR | mail | DKIM选择器,对应DNS记录前缀 |
DKIM_KEY_DIR | /etc/ssl/dkim | DKIM密钥存储目录 |
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_前缀的环境变量自定义:
yamlenvironment: - POSTFIX_message_size_limit=52428800 - POSTFIX_smtp_helo_name=mail.example.com
DNS配置参考
为保证邮件投递成功率,需在域名服务商处配置以下DNS记录:
- PTR反向解析:服务器IP的反向解析需与
MAILNAME配置一致,在云服务商后台配置 - SPF记录:声明允许发送本域名邮件的服务器IP
example.com. IN TXT "v=spf1 mx ip4:203.0.113.1 -all" - DKIM记录:将容器输出的DKIM公钥配置为TXT记录
mail._domainkey.example.com. IN TXT "v=DKIM1; k=rsa; p=<PUBLIC_KEY>" - DMARC记录:配置收件方对认证失败邮件的处理规则
_dmarc.example.com. IN TXT "v=DMARC1; p=quarantine; rua=mailto:dmarc@example.com"
Let's Encrypt证书部署示例
生产环境使用可信TLS证书可大幅提升邮件投递率:
yamlservices: 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/dkim | DKIM公私密钥对 |
letsencrypt | /etc/letsencrypt | Let's Encrypt证书存储(可选) |
端口说明
| 端口 | 协议 | 说明 |
|---|---|---|
| 25 | SMTP | 标准邮件投递和接收端口 |
| 587 | Submission | 带STARTTLS的认证邮件提交端口 |
注意事项
多数云服务商默认封禁出站25端口,若需使用直接投递模式需要向云服务商提交工单申请解除限制,端口封禁场景建议使用中继模式对接第三方SMTP服务。本镜像强制启用TLS 1.2及以上版本,禁用低版本不安全协议,仅保留高强度加密套件,保障邮件传输安全。所有日志统一输出到标准输出流,可通过docker logs -f postfix命令实时查看运行状态。
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。
DockerHub 原生拉取命令
用户好评
来自真实用户的反馈,见证轩辕镜像的优质服务