cd2team/mailhog

mailhog-docker

Docker化的MailHog，适用于树莓派及多架构设备。最初仅支持树莓派，现借助Docker对多架构的稳定支持，可基于Alpine构建适用于x86及多种ARM架构的镜像（理论上也支持Windows）。该镜像体积小巧，用于在本地环境中拦截、测试邮件，无需互联网连接即可进行邮件功能调试。

环境准备

需先安装Docker运行时，并确保用户有权限下载、构建和运行Docker镜像。

• 树莓派安装指南
• 其他平台安装指南

安装后无法运行Docker？

• 尝试执行sudo usermod -aG docker $USERNAME，然后登出并重新登录或重启设备。该命令将用户添加到具有Docker运行权限的用户组。

运行容器

bash
docker run --restart always --name mailhog -p 1025:1025 -p 8025:8025 -d cd2team/mailhog:latest

镜像标签包含{timestamp}版本，便于在重新标记latest和alpine时维护历史版本。若latest标签出现问题，可尝试使用上一次成功构建的timestamp版本，其哈希值与上一个可用的latest版本一致。

故障排除

邮件未被拦截？

• 是否通过1025或8025端口发送邮件？
• 是否使用解析到MailHog容器的主机名（如localhost或127.0.0.1）？
• Docker服务是否运行（执行docker ps -a查看mailhog容器状态是否为“Up {时长}”）？

设计目标

便利性

https://github.com/mailhog/MailHog%E5%8A%9F%E8%83%BD%E5%BC%BA%E5%A4%A7%EF%BC%8C%E6%A0%91%E8%8E%93%E6%B4%BE%E4%BB%B7%E6%A0%BC%E4%BD%8E%E5%BB%89%E4%B8%94%E4%BD%BF%E7%94%A8%E4%BE%BF%E6%8D%B7%EF%BC%8C%E7%BB%93%E5%90%88%E8%AE%BE%E5%A4%87%E6%A8%A1%E5%BC%8F%E5%8F%AF%E8%BD%BB%E6%9D%BE%E6%90%AD%E5%BB%BA%E9%9A%94%E7%A6%BB%E7%9A%84%E9%82%AE%E4%BB%B6%E6%B5%8B%E8%AF%95%E7%8E%AF%E5%A2%83%E3%80%82

互操作性

便于整合不同技术，无需互联网连接即可随时随地测试邮件功能。

可扩展性

与pi-hole结合，可在内部伪造非SSL邮件，确保测试或staging环境的邮件不会外泄。

支持实验

适用于测试IoT设备的邮件通知功能，可切换使用MailHog MTA或真实MTA进行测试。

特别感谢

• Docker - 提供打包、分发和运行时支持。
• GBAMan - 详细记录了树莓派设备模式扩展。
• Alpine Project - 提供轻量级Docker镜像，减少依赖组件。
• https://github.com/mailhog/MailHog - 提供Docker容器中运行的核心程序。
• https://github.com - 开发了优秀的工具和平台。
• https://github.com/crazy-max/ghaction-docker-buildx - 简化了多架构镜像的构建过程。