turgon37/smtp-relay

Docker SMTP中继

该镜像包含Postfix SMTP服务器实例，配置为SMTP中继，仅允许特定域名的邮件转发，支持网络IP范围和SASL认证两种授权方式，可灵活设置中继模式。

核心功能

• 基于域名限制转发邮件
• 支持网络IP范围白名单授权
• 提供SASL用户认证机制
• 多种预定义中继模式（STRICT/ALLOW_SASLAUTH_NODOMAIN等）
• 环境变量灵活配置Postfix参数
• 持久化存储SASL用户数据和邮件队列

使用场景

• 企业内部应用发送通知邮件
• 限制外部应用向特定域名发送邮件
• 需要认证机制的邮件转发服务
• 跨网络环境的邮件中继需求

配置说明

端口

卷

环境变量

部署示例

Docker Run命令

bash
docker run -p 25:25 -e "RELAY_MYDOMAIN=domain.com" -e "RELAY_HOST=relay:25" turgon37/smtp-relay

Docker Compose配置（未认证中继）

yaml
services:
  smtp-relay:
    image: turgon37/smtp-relay:latest
    environment:
      RELAY_POSTMASTER: 'postmaster@example.net'
      RELAY_MYHOSTNAME: 'smtp-relay.example.net'
      RELAY_MYDOMAIN: 'example.net'
      RELAY_MYNETWORKS: '127.0.0.0/8 10.0.0.0/24'
      RELAY_HOST: '[10.1.0.1]:25'
    ports:
      - "10.0.0.1:3000:25"

Docker Compose配置（已认证中继）

yaml
services:
  smtp-relay-auth:
    image: turgon37/smtp-relay:latest
    environment:
      RELAY_POSTMASTER: 'postmaster@example.net'
      RELAY_MYHOSTNAME: 'smtp-relay.example.net'
      RELAY_MYDOMAIN: 'example.net'
      RELAY_MYNETWORKS: '127.0.0.0/8 10.0.0.0/24'
      RELAY_HOST: '[10.1.0.1]:25'
      RELAY_MODE: 'ALLOW_SASLAUTH_NODOMAIN'
      RELAY_LOGIN: 'sasl-user-login'
      RELAY_PASSWORD: 'xxxxxxxxxxxx'
      RELAY_USE_TLS: 'no'
    ports:
      - "10.0.0.1:3000:25"
    volumes:
      - data-smtp-relay-auth:/data
      - data-smtp-relay-queue:/var/spool/postfix
volumes:
  data-smtp-relay-auth:
  data-smtp-relay-queue:

SASL用户管理

• 查看所有SASL用户：docker exec smtp-relay /opt/listpasswd.sh
• 添加单个SASL用户：docker exec -it smtp-relay /opt/saslpasswd.sh -u domain.com -c username
• 批量添加用户：挂载包含"用户名 密码"格式的文件到/etc/postfix/client_sasl_passwd

测试工具

使用内置SMTP客户端测试配置：

bash
docker exec -it smtp-relay /opt/smtp_client.py -s test -f *** --user user1:password1 ***