mailhog-docker

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

环境准备

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

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

安装后无法运行Docker？

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

运行容器

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 {时长}”）？

设计目标

便利性

MailHog功能强大，树莓派价格低廉且使用便捷，结合设备模式可轻松搭建隔离的邮件测试环境。

互操作性

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

可扩展性

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

支持实验

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

特别感谢

• Docker - 提供打包、分发和运行时支持。
• GBAMan - 详细记录了树莓派设备模式扩展。
• Alpine Project - 提供轻量级Docker镜像，减少依赖组件。
• MailHog - 提供Docker容器中运行的核心程序。
• GitHub & Actions团队 - 开发了优秀的工具和平台。
• CrazyMax BuildX - 简化了多架构镜像的构建过程。