patschi/parsedmarc

镜像概述

parsedmarc-dockerized 是将 parsedmarc（一款 DMARC 报告解析工具）打包为 Docker 容器的镜像，旨在简化 parsedmarc 的部署与使用流程。该镜像基于 https://github.com/patschi/parsedmarc-dockerized 构建，核心功能为解析电子邮件 DMARC（域名系统基于消息认证的报告与一致性）报告，帮助用户高效分析电子邮件安全状态、监控域名认证合规性，适用于需要简化邮件安全工具部署的场景。

核心功能与特性

1. Docker 容器化部署

• 提供预配置的 Docker 镜像，无需手动安装 parsedmarc 及其依赖（如 Python 环境、解析库等），降低部署门槛。
• 支持跨平台运行，兼容 Linux、macOS 及 Windows（需 Docker 环境）。

2. DMARC 报告解析能力

• 集成 parsedmarc 核心功能，支持解析 XML 格式的 DMARC 聚合报告（Aggregate Reports）和 forensic 报告（Forensic Reports）。
• 可提取报告中的发件域名、IP 地址、SPF/DKIM 验证结果、邮件数量等关键数据，生成结构化输出（如 JSON、CSV 或数据库记录）。

3. 灵活的数据处理与输出

• 支持将解析结果输出至本地文件、标准输出或第三方服务（如 Elasticsearch、MongoDB 等，需通过配置文件定义）。
• 支持自定义解析规则，适配不同格式的 DMARC 报告。

使用场景与适用范围

适用场景

• 企业邮件安全监控：定期解析 DMARC 报告，跟踪域名被滥用情况，评估邮件认证策略（SPF/DKIM/DMARC）有效性。
• 邮件管理员日常运维：快速定位邮件投递失败原因，分析第三方邮件发送源合规性。
• 电子邮件安全审计：生成 DMARC 合规性报告，满足数据安全与隐私保护相关***要求。

适用人群

• 企业 IT 运维人员、邮件系统管理员
• 负责电子邮件安全的安全工程师
• 需要监控域名邮件认证状态的组织或个人

使用方法与配置说明

前置要求

• 已安装 Docker Engine（20.10+ 版本推荐）
• （可选）Docker Compose（用于多容器部署场景）

基础使用流程

1. 获取镜像：从 Docker Hub 或通过 GitHub 项目构建镜像（具体参考项目文档）。
2. 准备配置文件：根据 parsedmarc 需求，创建配置文件（如 parsedmarc.ini），定义报告来源、解析规则、输出目标等。
3. 启动容器：通过 docker run 或 docker-compose 启动容器，挂载配置文件与报告存储目录。

Docker 部署示例

1. 使用 docker run 快速启动

bash
# 挂载本地配置文件和报告目录
docker run -d \
  --name parsedmarc \
  -v /path/to/local/config:/config \  # 本地配置文件目录（含 parsedmarc.ini）
  -v /path/to/dmarc/reports:/reports \  # 本地 DMARC 报告存储目录
  patschi/parsedmarc-dockerized

2. 使用 docker-compose 部署

创建 docker-compose.yml 文件：

yaml
version: '3'
services:
  parsedmarc:
    image: patschi/parsedmarc-dockerized
    container_name: parsedmarc
    volumes:
      - /path/to/local/config:/config  # 配置文件目录
      - /path/to/dmarc/reports:/reports  # 报告存储目录
    restart: unless-stopped  # 容器退出时自动重启（可选）

启动服务：

bash
docker-compose up -d

配置参数与环境变量

核心配置文件

parsedmarc 的行为主要通过配置文件（如 parsedmarc.ini）定义，需挂载至容器内 /config 目录。配置文件示例（参考 https://github.com/domainaware/parsedmarc%EF%BC%89%EF%BC%9A

ini
[general]
save_aggregate = True
aggregate_output = /reports/aggregate.json
forensic_output = /reports/forensic.json

[imap]
# 若从 IMAP 邮箱获取报告，配置邮箱信息
server = imap.example.com
user = dmarc@example.com
password = your_password
folder = INBOX/DMARC

环境变量（可选）

部分配置可通过环境变量覆盖，具体支持的变量需参考项目文档，常见变量可能包括：

• PARSEDARC_CONFIG：指定容器内配置文件路径（默认 /config/parsedmarc.ini）
• LOG_LEVEL：日志级别（如 INFO、DEBUG，默认 INFO）

注意事项

• 确保挂载的本地目录具有读写权限，避免容器因权限问题无法访问配置或写入报告。
• DMARC 报告通常为 XML 格式，需确保报告文件存放于挂载的 /reports 目录（或配置文件中定义的路径）。
• 详细配置与高级功能（如数据库集成、Web UI）请参考 https://github.com/patschi/parsedmarc-dockerized%E3%80%82