aerzas/mailcatcher

MailCatcher

镜像概述和主要用途

极简的MailCatcher Docker容器镜像，无需特定用户或root权限即可运行。MailCatcher是一款轻量级邮件捕获工具，能够接收应用程序发送的邮件并通过Web界面展示，主要用于开发和测试环境中，方便开发者查看邮件内容、验证邮件发送逻辑，无需依赖真实邮件服务器。

核心功能和特性

• 极简设计：镜像体积小巧，部署配置简单，易于集成到开发环境
• 权限友好：无需特定用户或root权限即可正常运行，提升安全性
• 版本支持：提供稳定的标签版本，包括latest（最新版）和2.4.0（特定版本）

使用场景和适用范围

适用于各类需要测试邮件发送功能的开发场景，例如：

• Web应用开发中测试用户注册、密码重置等邮件通知功能
• 验证邮件模板的渲染效果和格式正确性
• 调试邮件发送配置（如SMTP服务器设置、发送频率限制等）
• 本地开发环境中捕获邮件，避免垃圾邮件发送到真实用户***

使用方法和配置说明

支持的标签

• https://github.com/Aerzas/docker-mailcatcher/blob/2.4.0/Dockerfile%EF%BC%9A%E6%9C%80%E6%96%B0%E7%A8%B3%E5%AE%9A%E7%89%88%E6%9C%AC
• https://github.com/Aerzas/docker-mailcatcher/blob/2.4.0/Dockerfile%EF%BC%9A%E7%89%B9%E5%AE%9A%E7%89%88%E6%9C%AC

Docker Compose示例

yaml
version: '3.5'
services:
    mailcatcher:
        image: aerzas/mailcatcher:latest
        ports:
            - '1025:1025'  # SMTP端口，应用程序应将邮件发送到此端口
            - '1080:1080'  # Web界面端口，通过浏览器访问查看捕获的邮件
        healthcheck:
            test: ["CMD", "/scripts/docker-healthcheck.sh"]  # 健康检查命令
            interval: 30s  # 检查间隔
            timeout: 1s    # 超时时间
            retries: 3     # 重试次数
            start_period: 5s  # 启动等待时间

关键配置说明

• 端口映射：
  • 1025/tcp：SMTP服务端口，应用程序需将SMTP服务器配置为mailcatcher:1025（容器内）或localhost:1025（宿主机）
  • 1080/tcp：Web界面端口，启动后通过浏览器访问http://localhost:1080即可查看所有捕获的邮件
• 健康检查：示例中配置了健康检查，通过/scripts/docker-healthcheck.sh脚本定期检查服务状态，确保容器正常运行

基本使用流程

1. 使用上述Docker Compose配置启动容器
2. 配置应用程序的SMTP服务器为localhost:1025
3. 触发应用程序发送邮件
4. 访问http://localhost:1080在Web界面中查看捕获的邮件内容、收件人、发送时间等信息