chatwork/mailcatcher

MailCatcher Docker镜像

官方网站

镜像概述

MailCatcher Docker镜像封装了MailCatcher工具，专为开发和测试环境设计。它提供本地SMTP服务器接收邮件，并通过Web界面和API展示邮件内容，无需配置真实邮件服务器即可测试邮件发送功能。

核心功能和特性

• 本地SMTP服务器：监听1025端口，接收应用发送的邮件
• Web界面：通过1080端口提供直观界面，查看所有捕获的邮件
• Web API：支持JSON格式获取邮件数据，便于自动化测试
• 轻量级设计：无需外部依赖，快速启动
• 完整邮件展示：显示发件人、收件人、主题、正文等完整邮件属性

使用场景

• 开发邮件发送功能时进行本地测试
• 单元测试/集成测试中验证邮件发送逻辑
• 前端开发中模拟邮件接收场景
• 避免向真实用户发送测试邮件

使用方法

启动容器

bash
docker run -it --rm -p 1080:1080 -p 1025:1025 --name mailcatcher chatwork/mailcatcher

参数说明：

• -it：交互式终端
• --rm：容器退出后自动删除
• -p 1080:1080：映射Web界面端口
• -p 1025:1025：映射SMTP服务器端口
• --name mailcatcher：指定容器名称

启动成功后将显示：

Starting MailCatcher
==> smtp://0.0.0.0:1025
==> http://0.0.0.0:1080/

发送测试邮件

使用telnet协议连接SMTP服务器发送测试邮件：

bash
curl telnet://localhost:1025

连接后输入SMTP命令：

220 EventMachine SMTP Server
helo a
250 Ok EventMachine SMTP Server
mail from:<from@example.com>
250 Ok
rcpt to:<to@example.com>
250 Ok
data
354 Send it
Subject: Hello

Body
.
250 Message accepted

访问Web界面

在浏览器中打开Web界面查看邮件：

bash
open http://localhost:1080/

Web界面展示所有捕获的邮件，包括发件人、收件人、主题和正文内容。

使用Web API

通过Web API以JSON格式获取邮件数据：

bash
curl http://localhost:1080/messages | jq .

返回示例：

json
[
  {
    "id": 1,
    "sender": "<from@example.com>",
    "recipients": [
      "<to@example.com>"
    ],
    "subject": "Hello",
    "size": "24",
    "created_at": "2019-04-02T07:20:44+00:00"
  }
]

界面预览

!mailcatcher