djjudas21/smtp-relay

SMTP Relay Host Docker镜像文档

镜像概述

该Docker镜像提供一个轻量级SMTP中继服务，专门设计用于Kubernetes集群环境，旨在解决集群内部应用程序无法直接发送邮件的问题。通过作为中间转发层，镜像能够接收来自集群内应用的邮件请求，并将其安全、可靠地转发至外部SMTP服务器，实现Kubernetes环境下的邮件通信能力。

核心功能与特性

• Kubernetes原生适配：支持在Kubernetes Pod中部署，兼容集群网络环境
• 标准SMTP协议支持：完全兼容SMTP协议，支持SMTP、ESMTP标准命令
• 邮件转发可靠性：内置队列机制，确保邮件发送失败时自动重试
• 灵活配置选项：通过环境变量实现全参数配置，无需修改配置文件
• 安全传输支持：支持TLS/SSL加密传输，保障邮件数据传输安全
• 轻量级设计：基于精简基础镜像，容器体积小，资源占用低

使用场景与适用范围

• Kubernetes集群内应用程序发送通知邮件（如告警通知、状态报告）
• 微服务架构中需要跨服务发送邮件的场景
• 容器化应用需要统一管理邮件发送通道的场景
• 对邮件发送可靠性有要求的业务系统（如订单通知、用户验证邮件）

使用方法与配置说明

快速启动

通过以下命令可快速启动SMTP中继服务：

bash
docker run -d \
  --name smtp-relay \
  -p 25:25 \
  -e SMTP_HOST=smtp.example.com \
  -e SMTP_PORT=587 \
  -e SMTP_USER=your_username \
  -e SMTP_PASSWORD=your_password \
  -e FROM_ADDRESS=noreply@example.com \
  smtp-relay-k8s:latest

Docker Compose配置示例

yaml
version: '3'
services:
  smtp-relay:
    image: smtp-relay-k8s:latest
    container_name: smtp-relay
    ports:
      - "25:25"
    environment:
      - SMTP_HOST=smtp.example.com  # 外部SMTP服务器地址
      - SMTP_PORT=587              # 外部SMTP服务器端口
      - SMTP_USER=user@example.com # SMTP服务器认证用户名
      - SMTP_PASSWORD=secret       # SMTP服务器认证密码
      - FROM_ADDRESS=noreply@example.com  # 默认发件人地址
      - USE_TLS=true               # 是否启用TLS加密
      - MAX_RETRIES=3              # 邮件发送失败最大重试次数
      - RETRY_DELAY=60             # 重试间隔（秒）
    restart: unless-stopped

Kubernetes部署示例

yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: smtp-relay
spec:
  replicas: 1
  selector:
    matchLabels:
      app: smtp-relay
  template:
    metadata:
      labels:
        app: smtp-relay
    spec:
      containers:
      - name: smtp-relay
        image: smtp-relay-k8s:latest
        ports:
        - containerPort: 25
        env:
        - name: SMTP_HOST
          valueFrom:
            secretKeyRef:
              name: smtp-credentials
              key: host
        - name: SMTP_PORT
          value: "587"
        - name: SMTP_USER
          valueFrom:
            secretKeyRef:
              name: smtp-credentials
              key: username
        - name: SMTP_PASSWORD
          valueFrom:
            secretKeyRef:
              name: smtp-credentials
              key: password
        - name: FROM_ADDRESS
          value: "alerts@example.com"
        - name: USE_TLS
          value: "true"

环境变量配置说明

注意事项

• 在Kubernetes环境中部署时，建议使用Secret管理SMTP认证信息，避免明文配置
• 确保外部SMTP服务器允许从Kubernetes集群IP段发送邮件，或配置正确的认证信息
• 如使用企业***服务（如Gmail、Outlook），需提前开启SMTP访问权限并获取应用专用密码
• 高并发场景下建议适当调整MAX_RETRIES和RETRY_DELAY参数，避免邮件队列积压