clevyr/mailhog

MailHog 镜像文档

概述

MailHog是一款面向开发者的邮件测试工具：

• 配置应用使用MailHog进行SMTP投递
• 通过Web UI查看邮件，或通过JSON API检索邮件
• 可选择将邮件释放到真实SMTP服务器进行投递

安装与部署

Docker部署

可直接从Docker Hub运行，或使用提供的Dockerfile构建：

bash
# 从Docker Hub运行
docker run -d -p 1025:1025 -p 8025:8025 mailhog/mailhog

上述命令启动MailHog容器，映射SMTP端口1025（邮件接收）和HTTP端口8025（Web UI）到主机。

其他安装方式（可选）

MacOS

bash
brew update && brew install mailhog
# 启动命令：mailhog

Debian/Ubuntu

bash
sudo apt-get -y install golang-go
go get github.com/mailhog/MailHog
# 启动命令（默认路径示例）：~/go/bin/MailHog

配置

默认配置无需额外设置，直接使用以下参数：

• SMTP服务器端口：1025（接收邮件）
• HTTP服务器端口：8025（Web UI与API）
• 消息存储：内存存储（重启后数据丢失）

如需自定义配置（如持久化存储、认证等），可参考https://github.com/mailhog/MailHog/blob/master/docs/CONFIG.md%EF%BC%8C%E6%94%AF%E6%8C%81MongoDB%E3%80%81%E6%96%87%E4%BB%B6%E5%AD%98%E5%82%A8%E7%AD%89%E6%8C%81%E4%B9%85%E5%8C%96%E6%96%B9%E5%BC%8F%E3%80%82

核心功能和特性

• ESMTP服务器：实现RFC5321标准，支持SMTP AUTH（RFC4954）和PIPELINING（RFC2920）
• Web界面：访问http://localhost:8025查看邮件，支持纯文本、HTML格式及源文件查看，兼容RFC2047编码头
• 实时更新：通过EventSource技术实时接收新邮件通知
• 邮件释放：可手动将测试邮件释放到真实SMTP服务器进行实际投递测试
• 故障测试：内置"Chaos Monkey"（Jim）功能，模拟邮件发送失败场景
• HTTP API：提供APIv1和APIv2接口，支持列出、检索、删除邮件（详见https://github.com/mailhog/MailHog/tree/master/docs%EF%BC%89
• 认证保护：支持为Web UI和API配置HTTP基本认证
• MIME支持：完整支持多部分MIME邮件，可单独下载各MIME部分
• 存储灵活性：默认内存存储，可选MongoDB或文件系统实现数据持久化
• 轻量便携：无需安装，直接运行，跨Windows、Linux、macOS等平台

sendmail集成

可通过以下方式将应用发送的邮件重定向到MailHog：

使用mhsendmail

bash
# 安装mhsendmail（需Go环境）
go get github.com/mailhog/mhsendmail

配置应用示例

PHP配置（修改php.ini）：

ini
# 使用mhsendmail
sendmail_path = /usr/local/bin/mhsendmail
# 或使用系统sendmail指定SMTP服务器
sendmail_path = /usr/sbin/sendmail -S mail:1025

直接使用MailHog命令：

bash
MailHog sendmail recipient@example.com <<EOF
Subject: Test Email
From: sender@example.com

This is a test email.
EOF

使用场景

• 开发环境邮件功能测试，避免向真实用户发送测试邮件
• 调试邮件格式（HTML、纯文本、附件）及投递逻辑
• 模拟邮件发送失败场景，验证应用容错能力
• 集成CI/CD流程，自动化测试邮件发送功能