arjenz/mailhog

MailHog Docker镜像（linux/arm64支持版）

镜像概述

MailHog是一款面向开发者的邮件测试工具，灵感源自MailCatcher，且更易于安装。本镜像为mailhog/MailHog的衍生版本，专门支持linux/arm64架构。通过配置应用使用MailHog作为SMTP服务器，开发者可在Web界面或通过JSON API查看发送的邮件，还可选择将邮件释放到真实SMTP服务器进行投递。MailHog基于Go构建，跨平台运行且无需安装。

核心功能与特性

• ESMTP服务器：实现RFC5321标准，支持SMTP AUTH（RFC4954）和PIPELINING（RFC2920）
• Web界面：可查看邮件内容（纯文本、HTML或源文件），支持RFC2047编码头
• 实时更新：通过EventSource实现邮件接收实时通知
• 邮件释放：支持将捕获的邮件释放到真实SMTP服务器
• 故障测试：内置Chaos Monkey（Jim）功能，用于模拟邮件发送故障
• HTTP API：提供APIv1和APIv2接口，支持邮件列表查询、获取和删除
• 访问控制：支持HTTP基本认证保护Web UI和API
• MIME支持：支持多部分MIME邮件，可单独下载MIME部分
• 存储方式：默认内存存储，可选MongoDB或文件存储实现持久化
• 轻量便携：无需安装，可直接运行

使用场景

• 开发环境中测试邮件发送功能，避免向真实用户发送测试邮件
• CI/CD流程中验证应用邮件发送逻辑
• 调试邮件格式、内容及发送配置
• 模拟邮件发送故障场景，测试系统容错能力

使用方法与配置

Docker运行

可直接从Docker Hub拉取镜像运行：

bash
docker run -d -p 1025:1025 -p 8025:8025 docker.xuanyuan.run/arjenz/mailhog

参数说明：

• -p 1025:1025：映射SMTP服务端口（默认1025）
• -p 8025:8025：映射Web UI及API端口（默认8025）

Docker Compose配置

创建docker-compose.yml文件：

yaml
version: '3'
services:
  mailhog:
    image: docker.xuanyuan.run/arjenz/mailhog
    ports:
      - "1025:1025"  # SMTP端口
      - "8025:8025"  # Web UI端口
    restart: always

启动服务：

bash
docker-compose up -d

访问Web UI

运行后，通过浏览器访问 http://localhost:8025 即可打开MailHog Web界面，查看所有捕获的邮件。

默认配置

无需额外配置即可使用默认设置：

• SMTP服务器：端口1025
• HTTP服务器（Web UI/API）：端口8025
• 消息存储：内存存储（服务重启后消息丢失）

高级配置

如需自定义配置，可通过环境变量或命令行参数调整，例如：

• 修改SMTP端口：-smtp-bind-addr :2525
• 使用MongoDB存储：-storage mongodb --mongodb-uri mongodb://mongo:27017/mailhog

详细配置说明可参考https://github.com/mailhog/MailHog/blob/master/docs/CONFIG.md。

sendmail集成

mhsendmail

https://github.com/mailhog/mhsendmail是MailHog的sendmail替代品，可将邮件重定向至MailHog。也可直接使用`MailHog sendmail ...`命令替代独立的mhsendmail二进制文件。

原生sendmail配置

通过-S参数使用系统原生sendmail命令：

bash
/usr/sbin/sendmail -S mail:1025

PHP配置示例

在php.ini中添加以下配置：

ini
sendmail_path = /usr/local/bin/mhsendmail
# 或
sendmail_path = /usr/sbin/sendmail -S mail:1025

相关文档

• https://github.com/mailhog/MailHog/blob/master/docs/APIv1.md
• https://github.com/mailhog/MailHog/blob/master/docs/APIv2.md
• https://github.com/mailhog/MailHog/blob/master/docs/JIM.md
• https://github.com/mailhog/MailHog/blob/master/docs/Auth.md

许可证

本镜像基于MailHog项目，遵循MIT许可证。详见https://github.com/mailhog/MailHog/blob/master/LICENSE.md。