namshi/smtp

Docker-SMTP

镜像概述和主要用途

Docker-SMTP是一个轻量级SMTP Docker容器，用于发送邮件并支持中继功能，可对接Gmail、Amazon SES等外部邮件服务。它提供灵活的配置选项，适用于多种邮件发送场景，包括独立SMTP服务器、二级转发服务器及通用SMTP中继。

核心功能和特性

• 支持多种中继模式：Gmail、Amazon SES及通用SMTP服务器
• 可配置TLS加密，通过证书和密钥实现安全邮件传输
• 灵活的网络控制：支持设置中继网络、绑定IP/端口及IPv6开关
• 自定义邮件属性：可设置外发邮件主机名和目标域名列表
• 环境变量驱动配置，无需手动修改配置文件

环境变量

容器通过以下环境变量进行配置：

• RELAY_NETWORKS
  指定允许中继的网络范围，必须以:开头，格式示例：:192.168.0.0/24或:192.168.0.0/24:10.0.0.0/16

• KEY_PATH 与 CERTIFICATE_PATH
  启用TLS支持的密钥和证书路径，需指向挂载卷中的文件，容器会自动复制这些文件到内部路径

• MAILNAME
  设置外发邮件的主机名，用于邮件头中的发送域名标识

• PORT
  容器内SMTP服务监听端口，默认值为25

• BIND_IP 与 BIND_IP6
  分别指定IPv4和IPv6绑定地址，默认值为0.0.0.0（IPv4）和::0（IPv6）

• DISABLE_IPV6
  设置任意值可禁用IPv6支持

• OTHER_HOSTNAMES
  指定本机作为最终目的地的域名列表，用空格分隔

使用场景和适用范围

作为独立SMTP服务器

无需额外配置，直接运行即可提供基础SMTP服务，适用于本地网络邮件发送。

作为二级SMTP服务器

通过设置RELAY_DOMAINS指定需要转发的域名，格式为<domain1> : <domain2> : <domain3> ...，用于将特定域名邮件转发到低优先级MX服务器。

作为Gmail中继

需配置Gmail账户认证信息：

• GMAIL_USER：Gmail***地址
• GMAIL_PASSWORD：Gmail账户密码（建议使用应用专用密码）

作为Amazon SES中继

需配置SES账户信息：

• SES_USER：SES访问密钥ID
• SES_PASSWORD：SES秘密访问密钥
• SES_REGION（可选）：覆盖默认AWS区域
• SES_PORT（可选）：若使用Google Compute Engine，需设置为2587

作为通用SMTP中继

对接任意带认证的SMTP服务器，需配置：

• SMARTHOST_ADDRESS：智能主机地址
• SMARTHOST_PORT：智能主机端口
• SMARTHOST_USER：认证用户名
• SMARTHOST_PASSWORD：认证密码
• SMARTHOST_ALIASES：认证别名列表（分号分隔，如*.mysmtp.com）

使用方法和配置示例

基础SMTP服务器运行

bash
docker run -d -p 25:25 --name smtp namshi/smtp

Gmail中继配置

bash
docker run -d -p 25:25 --name gmail-relay \
  -e GMAIL_USER=your.email@gmail.com \
  -e GMAIL_PASSWORD=your-app-password \
  namshi/smtp

通用SMTP中继示例

bash
docker run -d -p 25:25 --name generic-relay \
  -e SMARTHOST_ADDRESS=mail.mysmtp.com \
  -e SMARTHOST_PORT=587 \
  -e SMARTHOST_USER=myuser \
  -e SMARTHOST_PASSWORD=secret \
  -e SMARTHOST_ALIASES=*.mysmtp.com \
  namshi/smtp

Docker Compose配置

yaml
version: '3'
services:
  smtp:
    image: namshi/smtp
    ports:
      - "25:25"
    environment:
      - MAILNAME=mail.example.com
      - RELAY_NETWORKS=:192.168.0.0/24:10.0.0.0/16
      - DISABLE_IPV6=true
      - KEY_PATH=/certs/key.pem
      - CERTIFICATE_PATH=/certs/cert.pem
    volumes:
      - ./certs:/certs
    restart: always