philiplehmann/mailcatcher

MailCatcher 多架构镜像

概述

MailCatcher 多架构Docker镜像是一个轻量级工具，专为开发和测试环境设计，用于捕获应用程序发送的电子邮件，避免向真实***发送测试邮件。该镜像支持多种CPU架构，可在不同硬件平台上运行，提供SMTP服务器接收邮件和Web界面查看邮件内容。

核心功能与特性

• 多架构支持：适配多种CPU架构，确保在不同硬件环境中正常运行。
• SMTP服务器：内置SMTP服务器（默认端口1025），接收应用程序发送的邮件。
• Web界面：提供Web界面（默认端口1080），可直观查看、搜索和管理捕获的邮件。
• 零配置启动：无需复杂配置，默认参数即可满足大多数开发场景需求。

使用场景

• 开发环境调试：在应用程序开发过程中，捕获并查看邮件发送功能，验证邮件内容、格式和发送逻辑。
• 测试环境验证：自动化测试或手动测试时，确保邮件发送功能正常，无需依赖外部邮件服务。
• 教学与演示：演示邮件发送流程，安全查看邮件内容，避免信息泄露。

使用方法

基本运行命令

通过以下命令启动MailCatcher容器，映射必要端口：

bash
docker run -p 1080:1080 -p 1025:1025 --name mailcatcher-server philiplehmann/mailcatcher:latest

参数说明

• -p 1025:1025：将容器内SMTP端口（1025）映射到主机，应用程序需配置SMTP服务器地址为主机IP:1025以发送邮件。
• -p 1080:1080：将容器内Web界面端口（1080）映射到主机，通过http://主机IP:1080访问Web界面。
• --name mailcatcher-server：为容器指定名称，便于管理（可选）。

Docker Compose 示例

如需集成到现有项目，可使用docker-compose.yml配置：

yaml
version: '3'
services:
  mailcatcher:
    image: philiplehmann/mailcatcher:latest
    ports:
      - "1025:1025"  # SMTP端口
      - "1080:1080"  # Web界面端口
    restart: unless-stopped  # 可选：容器退出时自动重启

启动命令：

bash
docker-compose up -d

访问Web界面

容器启动后，通过浏览器访问 http://localhost:1080 即可打开Web界面，查看所有捕获的邮件。

应用程序配置

在应用程序中，将SMTP服务器配置为 mailcatcher-server:1025（容器名访问）或 主机IP:1025（外部访问），发送邮件后即可在Web界面查看。

端口说明

配置说明

默认配置已满足大多数场景需求。如需自定义（如修改端口、存储路径等），可参考项目GitHub文档获取高级配置方法。

相关链接

• GitHub项目地址：https://github.com/philiplehmann/container/tree/main/apps/mailcatcher