instrumentisto/opendmarc

OpenDMARC Docker镜像

https://github.com/instrumentisto/opendmarc-docker-image/actions/workflows/ci.yml/badge.svg?branch=main "CI"](https://github.com/instrumentisto/opendmarc-docker-image/actions?query=workflow%3ACI+branch%3Amain)

https://hub.docker.com/r/instrumentisto/opendmarc | https://github.com/orgs/instrumentisto/packages/container/package/opendmarc | Quay.io

https://github.com/instrumentisto/opendmarc-docker-image/blob/main/CHANGELOG.md

支持的标签及对应的 Dockerfile 链接

• https://github.com/instrumentisto/opendmarc-docker-image/blob/main/debian/Dockerfile
• https://github.com/instrumentisto/opendmarc-docker-image/blob/main/alpine/Dockerfile

什么是OpenDMARC？

OpenDMARC是DMARC（基于域名的消息认证、报告和合规性）规范的免费开源软件实现。

OpenDMARC Docker镜像提供基于milter的过滤器应用，可插入到任何支持milter的MTA中，为较新版本的sendmail MTA及其他支持milter协议的MTA提供服务。

OpenDMARC是可信域名项目（The Trusted Domain Project）的一部分。

[***]

如何使用此镜像

要运行OpenDMARC milter应用，只需启动容器：

bash
docker run -d -p 8893:8893 instrumentisto/opendmarc

配置

可通过以下方式之一配置OpenDMARC（不可同时使用两种方式）：

1. 配置文件片段
   将配置文件（必须以 .conf 结尾）放入 /etc/opendmarc/conf.d/ 目录。容器启动时，这些文件将应用于默认OpenDMARC配置。

   bash
   docker run -d -p 8893:8893 \
              -v /本地/custom.conf:/etc/opendmarc/conf.d/10-custom.conf:ro \
          instrumentisto/opendmarc
   

   此方式适用于只需对默认配置进行少量修改，或希望将不同配置部分分开保存的场景。

2. 完整配置文件
   将配置文件 opendmarc.conf 放入 /etc/opendmarc/ 目录，完全替换镜像提供的默认配置文件。

   bash
   docker run -d -p 8893:8893 \
              -v /本地/custom.conf:/etc/opendmarc/opendmarc.conf:ro \
          instrumentisto/opendmarc
   

   此方式适用于更方便一次性指定完整配置，而非修改默认选项的场景。

默认配置

要查看此Docker镜像的默认OpenDMARC配置，运行：

bash
docker run --rm instrumentisto/opendmarc cat /etc/opendmarc/opendmarc.conf

发送报告

此镜像预装了msmtp MTA，当DMARC记录中包含ruf标签时，可用于发送报告。

要实现此功能，需在 opendmarc.conf 中设置 FailureReports true 并将 FailureReportsSentBy 设为发件人地址（通常为 noreply）。然后创建 /etc/msmtprc 配置文件，内容如下：

defaults
logfile -

account default
host <SMTP服务器>
port <SMTP端口>
from <发件人地址>

除替换MTA主机名/端口和发件人地址外，若涉及不可信网络，建议添加TLS和认证配置。详情参见msmtp手册。

注意避免邮件循环：若处理报告邮件时违反自身DMARC规则，可能导致生成更多报告。

重要提示

由于OpenDMARC仅将日志写入 syslog，容器内运行 syslog 守护进程作为第二个辅助进程，由https://github.com/just-containers/s6-overlay提供的s6进程管理器进行监控。

日志

此镜像的 syslog 守护进程配置为将所有日志写入 /dev/stdout。

要修改此行为，挂载自定义 /etc/syslog.conf 文件并定义所需日志规则。

s6-overlay

此镜像包含https://github.com/just-containers/s6-overlay，如需可使用其提供的https://github.com/just-containers/s6-overlay#usage。

镜像标签

<X>

最新主要版本 X 的最新标签。

<X.Y>

最新次要版本 X.Y 的最新标签。

<X.Y.Z>

具体版本 X.Y.Z 的最新标签。

<X.Y.Z>-r<N>

具体版本 X.Y.Z 的第 N 版镜像修订标签。

构建后不再更新。

alpine

基于流行的Alpine Linux项目（可在https://hub.docker.com/_/alpine中获取）。Alpine Linux比大多数发行版基础镜像小得多（约5MB），因此生成的镜像通常更精简。

当需要最小最终镜像体积时，强烈推荐此变体。需注意其使用musl libc而非glibc及类似库，某些软件可能因libc依赖深度而出现问题。但大多数软件无此问题，因此通常是安全选择。更多关于使用Alpine镜像的优缺点讨论参见此Hacker News评论线程。

许可证

OpenDMARC使用BSD许可证。

与所有Docker镜像一样，此镜像可能包含其他软件，可能使用其他许可证（如基础发行版中的Bash等，以及主要软件的直接或间接依赖）。

对于任何预构建镜像的使用，镜像用户有责任确保其使用符合包含的所有软件的相关许可证要求。

生成 instrumentisto/opendmarc Docker镜像的https://github.com/instrumentisto/opendmarc-docker-image使用https://github.com/instrumentisto/opendmarc-docker-image/blob/main/LICENSE.md许可证。

问题反馈

我们无法关注https://hub.docker.com（或其他容器仓库）的评论，因此请勿通过这些渠道报告问题或提问。

如遇此镜像相关问题或疑问，请通过https://github.com/instrumentisto/opendmarc-docker-image/issues联系我们。