jgosmann/dmarc-metrics-exporter

DMARC指标导出器镜像

概述

该Docker镜像用于从DMARC聚合报告中提取关键指标，并通过HTTP端点导出至Prometheus监控系统。镜像通过IMAP协议定期轮询邮件服务器，获取新的DMARC聚合报告邮件，解析后生成标准化指标，助力用户监控邮件系统的DMARC合规性、SPF/DKIM验证状态等关键安全指标。

核心功能与特性

收集的指标

镜像可收集并暴露以下DMARC相关指标（均为计数器类型）：

• dmarc_total: 报告的邮件总数
• dmarc_compliant_total: DMARC合规的邮件总数
• dmarc_quarantine_total: 被隔离的邮件总数
• dmarc_reject_total: 被拒绝的邮件总数
• dmarc_spf_aligned_total: SPF对齐的邮件总数
• dmarc_spf_pass_total: SPF验证通过的原始邮件总数
• dmarc_dkim_aligned_total: DKIM对齐的邮件总数
• dmarc_dkim_pass_total: DKIM验证通过的原始邮件总数

指标标签

每个指标均包含以下标签，支持多维度分析：

• reporter: DMARC聚合报告的来源域名
• from_domain: 被评估邮件的发件域名
• dkim_domain: DKIM签名对应的域名
• spf_domain: 用于SPF验证的域名

使用场景

适用于需要监控邮件系统安全状态的组织或个人，尤其适合已部署Prometheus+Grafana监控体系的环境。典型应用场景包括：

• 跟踪DMARC政策合规率变化趋势
• 监控SPF/DKIM对齐率及验证通过率
• 分析不同报告来源（reporter）或发件域名（from_domain）的邮件安全表现
• 及时发现邮件伪造、域名滥用等潜在风险

使用方法

基本部署（Docker Run）

通过以下命令快速启动容器，需替换环境变量为实际配置：

bash
docker run -d \
  --name dmarc-exporter \
  -p 9276:9276 \  # 指标暴露端口（默认9276）
  -e IMAP_HOST=imap.example.com \  # IMAP服务器地址
  -e IMAP_PORT=993 \  # IMAP端口（SSL默认993，非SSL默认143）
  -e IMAP_USER=your-email@example.com \  # IMAP登录用户名
  -e IMAP_PASSWORD=your-imap-password \  # IMAP登录密码（或应用专用密码）
  -e POLL_INTERVAL=3600 \  # 轮询间隔（秒，默认3600即1小时）
  jgosmann/dmarc-metrics-exporter

Docker Compose配置

创建docker-compose.yml文件，示例如下：

yaml
version: '3'
services:
  dmarc-exporter:
    image: jgosmann/dmarc-metrics-exporter
    container_name: dmarc-exporter
    ports:
      - "9276:9276"
    environment:
      - IMAP_HOST=imap.example.com
      - IMAP_PORT=993
      - IMAP_USER=your-email@example.com
      - IMAP_PASSWORD=your-imap-password
      - POLL_INTERVAL=3600
      - IMAP_FOLDER=INBOX  # 存放DMARC报告的邮件文件夹（默认INBOX）
      - METRICS_PATH=/metrics  # 指标暴露路径（默认/metrics）
    restart: unless-stopped

启动命令：docker-compose up -d

指标访问

容器启动后，Prometheus可通过http://<容器IP>:9276/metrics拉取指标。建议在Prometheus配置中添加如下job：

yaml
scrape_configs:
  - job_name: 'dmarc'
    static_configs:
      - targets: ['dmarc-exporter:9276']  # 容器名或IP:端口

配置参数

镜像通过环境变量进行配置，关键参数说明如下：

注意事项

• 确保IMAP服务器允许第三方应用访问（如Gmail需开启"Less secure app access"或使用应用专用密码）。
• 首次启动时，容器会解析历史报告邮件，建议配置合理的POLL_INTERVAL避免频繁轮询。
• 完整配置及最新更新请参考https://github.com/jgosmann/dmarc-metrics-exporter%E3%80%82