sumizadocker/smtp-parser

SMTP Server Parser 镜像文档

镜像概述

SMTP Server Parser 是一个基于 Python 的 SMTP 服务器，用于检查入站邮件的各种属性（如 SPF 和 DKIM 验证），并根据配置将邮件发送到 webhook 或打印到控制台。它还支持通过附加脚本实现自定义解析或发送等高级功能。

项目地址：https://github.com/Sumiza/smtp-parser
Docker Hub 地址：https://hub.docker.com/r/sumizadocker/smtp-parser

Docker Hub 标签

为保持依赖更新，每日构建新镜像并标记为 latest。若需固定版本，可使用日期、提交哈希标签，或使用 master 标签仅在代码变更时更新：

• latest：每日更新及新构建时更新
• master：代码变更时触发更新
• date：每日构建版本（按日期标记）
• commit hash：基于 GitHub 提交哈希的构建版本
• beta：beta 分支的测试版本，可能不稳定，不建议生产环境使用

环境变量配置

通过以下环境变量可配置 SMTP 服务器行为，所有变量均为可选：

使用方法

基础部署

默认配置下运行，绑定 0.0.0.0:25 端口：

bash
docker run -d -p 25:25 sumizadocker/smtp-parser:latest

带 webhook 转发配置

将邮件转发至指定 webhook，启用 DEBUG 日志：

bash
docker run -d -p 25:25 \
  -e WEBHOOK_URL="https://your-webhook-service.com/email" \
  -e WEBHOOK_HEADERS='{"Authorization":"Bearer your-token","Content-Type":"application/json"}' \
  -e HMAC_SECRET="your-hmac-secret" \
  -e LOGGER="DEBUG" \
  sumizadocker/smtp-parser:latest

邮件过滤与验证配置

仅接收发件人为 @example.com、收件人为 support@example.com 且 SPF 验证通过的邮件：

bash
docker run -d -p 25:25 \
  -e SOURCE_EMAIL="@example.com" \
  -e TARGET_EMAIL="support@example.com" \
  -e SPF_ALLOW_LIST="pass" \
  -e DKIM_REJECT="true" \
  sumizadocker/smtp-parser:latest

核心功能与特性

• 多维度验证：支持 SPF 响应过滤、DKIM 验证及密钥长度检查，提升邮件安全性。
• 精准过滤：通过发件人/收件人规则筛选邮件，减少无关流量。
• 灵活集成：支持 webhook 转发，可对接日志系统、工单平台等业务系统。
• 可扩展配置：通过环境变量调整端口、邮件大小、日志级别等核心参数。
• 自定义扩展：支持安装额外 pip 包，通过附加脚本实现个性化解析或发送逻辑。

适用场景

• 企业邮件安全网关：前置验证 SPF/DKIM，过滤伪造或未授权邮件。
• 邮件钩子服务：将特定邮件实时转发至 web 服务（如 CRM、自动化工作流）。
• 开发测试环境：本地快速搭建邮件接收服务，调试邮件发送功能。
• 日志审计系统：收集并分析入站邮件日志，满足合规需求。