dhet/postfix-pg

支持PostgreSQL的Postfix Docker镜像

镜像概述和主要用途

这是一个支持PostgreSQL的Postfix Docker镜像，允许通过环境变量配置Postfix（替代传统配置文件），实现基于Postgres的别名查询，并能将Postfix日志转发至Postgres数据库。

核心功能和特性

• 通过环境变量配置Postfix，无需将配置文件烘焙到子镜像中
• 支持基于Postgres的本地别名和虚拟别名查询
• 支持中继服务器的SASL认证
• 可将Postfix日志通过rsyslog推送到Postgres数据库

使用场景和适用范围

• 需要灵活配置Postfix的邮件服务器环境
• 需通过Postgres数据库管理邮件别名的场景
• 要求集中存储和管理Postfix日志的应用
• 需要快速部署且易于配置的Postfix服务

使用方法和配置说明

示例用法

bash
docker run --rm -ti -p 25:25 -p 587:587 \
  -e CONF_MYDOMAIN=example.com \
  -e CONF_RELAYHOST=[smtp.mailgun.org]:587 \
  -e SASL_AUTH=username:password \
  -e POSTGRES_HOSTS=pg_host \
  -e POSTGRES_USER=postfix_user \
  -e POSTGRES_PASSWORD=postfix_user_password \
  -e POSTGRES_ALIAS_DB=aliases \
  -e POSTGRES_ALIAS_QUERY="SELECT forw_addr FROM mxaliases WHERE alias='%s'" \
  -e POSTGRES_LOG_HOST=pg_host \
  -e POSTGRES_LOG_DB=postfix_logs \
  -e POSTGRES_LOG_USER=log_user \
  -e POSTGRES_LOG_PASSWORD=log_user_password \
  -e POSTGRES_LOG_TABLE=postfix_logs \
  dhet/postfix-pg:latest

配置说明

通用配置

所有以CONF_为前缀的环境变量会被转换为对应的Postfix设置。变量名的其余部分会被转换为小写，并写入Postfix的主配置文件（/etc/postfix/main.cf）。

示例：

中继SASL认证

要为中继服务器启用SASL认证，需指定SASL_AUTH环境变量，其值格式为username:password。此设置会自动配置smtp_sasl_auth_enable、smtp_sasl_password_maps和smtp_sasl_security_options选项，但需自行设置relayhost变量。

Postgres别名映射

该镜像支持通过Postgres进行本地和虚拟别名映射查询。详细说明可参考Postfix PostgreSQL指南。

必填环境变量：

• POSTGRES_HOSTS：一个或多个数据库主机，以空格分隔
• POSTGRES_USER：数据库用户
• POSTGRES_PASSWORD：数据库用户密码
• POSTGRES_ALIAS_DB：存储（虚拟）别名表的数据库

本地别名

• POSTGRES_ALIAS_QUERY：查询别名的SQL语句，例如：SELECT forw_addr FROM mxaliases WHERE alias='%s'

虚拟别名

• POSTGRES_VALIAS_QUERY：查询虚拟别名的SQL语句，例如：SELECT forw_addr FROM virtualaliases WHERE alias='%s'

日志配置

可通过rsyslog将Postfix日志推送到Postgres数据库。此功能独立于Postfix别名查询，因此即使别名数据库和日志数据库相同，也需单独指定数据库凭据。

启用日志所需环境变量（均为必填）：

• POSTGRES_LOG_HOST：数据库主机名
• POSTGRES_LOG_TABLE：存储日志的数据库表
• POSTGRES_LOG_DB：包含日志表的数据库
• POSTGRES_LOG_USER：日志数据库用户
• POSTGRES_LOG_PASSWORD：日志数据库用户密码

⚠️ 需在启动容器前创建POSTGRES_LOG_TABLE指定的表。该表至少需包含以下两个列：raw_log（类型为text或varchar）和created_at（类型为timestamp）。可根据需要添加其他可选字段。

致谢

此镜像基于https://github.com/jessfraz/dockerfiles%E4%B8%AD%E7%9A%84postfix%E9%95%9C%E5%83%8F%E7%A8%8D%E4%BD%9C%E4%BF%AE%E6%94%B9%E3%80%82