croneu/postfix-relayer

Docker Postfix中继

基于Alpine Linux的Postfix SMTP中继容器，专为容器环境设计。支持通过环境变量进行运行时配置、可选的上游中继主机SASL认证，日志输出到标准输出以便于Docker日志和CloudWatch（ECS）收集。

核心功能

• 基于Alpine Linux，镜像体积小巧
• Postfix以前台模式运行（postfix start-fg），日志输出到标准输出
• 通过环境变量实现运行时配置：
  • 所有以POSTFIX_或postfix_开头的变量将通过postconf应用
  • 支持大小写变体（如POSTFIX_relayhost和POSTFIX_RELAYHOST均可生效）
• 当设置SMTP_USERNAME和SMTP_PASSWORD时，启用可选的SASL认证

使用场景

适用于Docker、ECS等容器环境中需要邮件中继的场景，如应用服务发送通知邮件、系统告警等。

配置说明

环境变量配置

• 任何以POSTFIX_或postfix_开头的环境变量会转换为小写，并通过postconf -e "key=value"应用到Postfix配置。
• 示例：
  • POSTFIX_mydestination=localhost → postconf -e "mydestination=localhost"
  • POSTFIX_RELAYHOST=[smtp.example.com]:587 → postconf -e "relayhost=[smtp.example.com]:587"

SASL认证

启用SASL认证需设置以下环境变量：

• SMTP_USERNAME：上游中继服务的用户名
• SMTP_PASSWORD：上游中继服务的密码

常见中继场景

• AWS SES：

  bash
  POSTFIX_relayhost=[email-smtp.<region>.amazonaws.com]:587
  SMTP_USERNAME=<ses_smtp_user>
  SMTP_PASSWORD=<ses_smtp_password>
  # 适配SES速率限制：约14条/秒
  POSTFIX_smtp_destination_concurrency_limit=14
  POSTFIX_smtp_destination_rate_delay=1s
  POSTFIX_smtp_extra_recipient_limit=10
  

• 通用服务提供商（587端口+STARTTLS）：

  bash
  POSTFIX_relayhost=[smtp.example.com]:587
  SMTP_USERNAME=user@example.com
  SMTP_PASSWORD=******
  

部署示例

手动运行

bash
docker pull croneu/postfix-relayer:latest

基础示例（通过AWS SES中继）：

bash
docker run -d --name postfix-relay \
  -p 25:25 \
  -e POSTFIX_myhostname=relay.example.com \
  -e POSTFIX_myorigin=example.com \
  -e POSTFIX_relayhost='[email-smtp.us-east-1.amazonaws.com]:587' \
  -e SMTP_USERNAME='your-ses-username' \
  -e SMTP_PASSWORD='your-ses-password' \
  croneu/postfix-relayer:latest

查看日志：

bash
docker logs -f postfix-relay

docker-compose示例

参考仓库中的docker-compose.yml获取即用示例。

AWS ECS任务定义示例

yaml
Resources:
  PostfixTaskDefinition:
    Type: AWS::ECS::TaskDefinition
    Properties:
      Family: postfix-relay
      NetworkMode: awsvpc
      RequiresCompatibilities:
        - FARGATE
      Cpu: 256
      Memory: 512
      ExecutionRoleArn: !GetAtt ECSExecutionRole.Arn
      ContainerDefinitions:
        - Name: postfix-relay
          Image: croneu/postfix-relayer:latest
          Essential: true
          PortMappings:
            - ContainerPort: 25
              Protocol: tcp
          Environment:
            - Name: POSTFIX_myhostname
              Value: relay.example.com
            - Name: POSTFIX_myorigin
              Value: example.com
            - Name: POSTFIX_relayhost
              Value: '[email-smtp.us-east-1.amazonaws.com]:587'
          Secrets:
            - Name: SMTP_USERNAME
              ValueFrom: !Sub 'arn:aws:secretsmanager:${AWS::Region}:${AWS::AccountId}:secret:postfix/smtp-username'
            - Name: SMTP_PASSWORD
              ValueFrom: !Sub 'arn:aws:secretsmanager:${AWS::Region}:${AWS::AccountId}:secret:postfix/smtp-password'
          LogConfiguration:
            LogDriver: awslogs
            Options:
              awslogs-group: /ecs/postfix-relay
              awslogs-region: !Ref AWS::Region
              awslogs-stream-prefix: postfix

构建

镜像通过GitHub Actions自动构建并推送到Docker Hub。

本地构建

使用Makefile：

bash
make build

或直接使用Docker：

bash
docker build -t croneu/postfix-relayer:latest .

注意：Dockerfile使用固定版本的Alpine Linux 3.22以确保构建可复现。

测试

项目包含Makefile提供的全面测试：

bash
# 运行所有测试
make test

# 运行单个测试
make test-basic        # 测试基础配置
make test-uppercase    # 测试大写环境变量
make test-sasl         # 测试SASL认证

# 其他实用命令
make help              # 显示所有可用目标
make clean             # 清理测试容器

注意：使用SASL时需确保设置POSTFIX_relayhost（或POSTFIX_RELAYHOST），例如[smtp.example.com]:587。

许可证

MIT（或您偏好的开源许可证）