jeanberu/mailcatcher

Mailcatcher 镜像文档

镜像概述

Mailcatcher 是一个轻量级邮件捕获工具，基于 Alpine Linux 构建，镜像体积仅约20MB。它通过运行 SMTP 服务器接收邮件，并提供 Web 界面用于查看和管理捕获的邮件，主要用于开发和测试环境，避免实际发送邮件到真实***。

核心功能与特性

• 轻量级设计：基于 Alpine Linux，镜像体积仅约20MB，资源占用低
• SMTP 服务器：内置 SMTP 服务，默认监听 1025 端口接收邮件
• Web 界面：提供直观的 Web 界面（默认 1080 端口），可查看所有捕获的邮件内容
• 可配置性：支持通过命令行参数自定义 IP 绑定、端口等配置

使用场景

• 开发环境中测试邮件发送功能，无需配置真实邮件服务器
• 调试邮件模板、内容和发送逻辑
• 集成到 CI/CD 流程中，验证邮件发送功能的正确性
• 避免测试过程中向真实用户发送垃圾邮件

使用方法

基本运行

通过以下命令启动 Mailcatcher 容器：

bash
docker run -d -p 1025:1025 -p 1080:1080 --name mailcatcher jeanberu/mailcatcher

• SMTP 端口：1025（用于接收邮件）
• Web 界面端口：1080（用于查看邮件）

启动后：

1. 将应用的邮件发送配置指向 smtp://127.0.0.1:1025
2. 访问 http://127.0.0.1:1080 查看捕获的邮件

自定义配置参数

可通过替换默认命令修改 Mailcatcher 运行参数，完整参数列表参见 https://github.com/sj26/mailcatcher#command-line-options%E3%80%82

示例：修改 Web 界面端口为 80

bash
docker run -d --expose 80 -p 80:80 -p 1025:1025 --name mailcatcher jeanberu/mailcatcher --ip=0.0.0.0 --http-port=80

默认配置说明

镜像默认启动参数为：--ip=0.0.0.0（允许所有网络接口访问），确保容器外部可访问 SMTP 和 Web 服务。