wildwildangel/postfix-relay

docker-alpine-postfix-relay

镜像概述

wildwildangel/postfix-relay是一个基于Alpine Linux的轻量级Postfix SMTP中继Docker镜像。该镜像未配置本地认证机制，设计用于可信网络环境，主要功能是作为中间中继节点，将内部服务发送的邮件转发至指定的外部SMTP服务器。

核心功能与特性

• 轻量级基础：基于Alpine Linux，镜像体积小，资源占用低
• SMTP中继能力：支持将内部邮件转发至外部SMTP服务器
• 灵活认证：可选配置SMTP服务器认证，支持密码直接配置或通过文件挂载（SMTP_PASSWORD_FILE）
• 网络访问控制：可自定义允许中继的网络范围（SMTP_NETWORKS）
• 调试支持：通过DEBUG环境变量启用调试模式，便于问题排查

适用场景

• 可信网络环境中，内部服务（如应用服务器、监控系统）需要发送邮件时作为中继节点
• Docker容器集群内的服务需统一通过外部SMTP服务器发送邮件的场景
• 需要限制特定网络范围才能使用中继服务的场景

使用方法

环境变量配置

必填环境变量

可选环境变量

部署示例

基础部署（无认证）

适用于目标SMTP服务器无需认证的场景：

bash
docker run -d \
  --name postfix-relay \
  -e SERVER_HOSTNAME=relay.internal \
  -e SMTP_SERVER=smtp.example.com \
  wildwildangel/postfix-relay

带SMTP认证的部署

当目标SMTP服务器要求认证时，需提供用户名和密码：

bash
docker run -d \
  --name postfix-relay \
  -e SERVER_HOSTNAME=relay.internal \
  -e SMTP_SERVER=smtp.example.com \
  -e SMTP_PORT=587 \
  -e SMTP_USERNAME=service@example.com \
  -e SMTP_PASSWORD=your-smtp-password \
  wildwildangel/postfix-relay

通过文件挂载密码的部署

为避免密码明文暴露，可通过文件挂载方式提供密码：

bash
# 准备密码文件（例如/path/to/smtp-password.txt，内容为密码）
echo "your-smtp-password" > /path/to/smtp-password.txt

docker run -d \
  --name postfix-relay \
  -e SERVER_HOSTNAME=relay.internal \
  -e SMTP_SERVER=smtp.example.com \
  -e SMTP_USERNAME=service@example.com \
  -e SMTP_PASSWORD_FILE=/run/secrets/smtp-password \
  -v /path/to/smtp-password.txt:/run/secrets/smtp-password:ro \
  wildwildangel/postfix-relay

注意事项

• 可信环境要求：由于未配置本地认证，必须在可信网络环境中部署，避免未授权访问
• 网络安全：建议通过SMTP_NETWORKS严格限制允许中继的网络范围，仅开放给内部可信服务
• 密码安全：优先使用SMTP_PASSWORD_FILE通过文件挂载方式提供密码，而非直接设置SMTP_PASSWORD环境变量，降低密码泄露风险