zolweb/docker-mailcatcher

Docker: Mailcatcher

镜像概述

本镜像用于运行Mailcatcher，这是一个轻量级的邮件测试工具，主要用于开发环境中捕获和查看应用程序发送的测试邮件，避免向真实***发送测试邮件。

核心功能与特性

• 提供SMTP服务，默认监听1025端口，用于接收应用程序发送的邮件
• 内置Web界面，默认通过1080端口访问，可直观查看捕获的邮件内容
• 支持容器端口映射，可自定义映射到主机的端口
• 轻量级设计，易于部署和集成到开发环境

使用场景

• 开发环境中测试邮件发送功能
• 调试邮件模板和内容
• 验证应用程序的邮件发送逻辑
• 避免在测试过程中向真实用户发送邮件

使用方法

基本运行

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

sh
# 后台运行容器并命名为mailcatcher
sudo docker run \
    -d \  # 后台模式运行
    --name mailcatcher \  # 指定容器名称，方便后续管理
    zolweb/docker-mailcatcher

访问方式

• SMTP服务：通过容器的1025端口接收邮件，应用程序可配置SMTP服务器为容器IP或主机映射IP，端口1025
• Web界面：通过http://localhost:1080访问邮件查看界面

自定义端口映射

如需自定义端口映射，可使用-p参数：

sh
# 将容器1025端口映射到主机2525端口，1080端口映射到主机8080端口
sudo docker run -d --name mailcatcher -p 2525:1025 -p 8080:1080 zolweb/docker-mailcatcher

此时，SMTP服务通过主机2525端口访问，Web界面通过http://localhost:8080访问。

开发相关

手动构建镜像

sh
# 使用make命令构建镜像
make build  # 等效于: sudo docker build -t zolweb/docker-mailcatcher .

测试镜像

sh
# 运行测试容器并映射1080端口
make run  # 等效于: sudo docker run --rm=true -t -i -p 1080:1080 zolweb/docker-mailcatcher

运行后可通过http://localhost:1080验证Web界面是否正常。

删除镜像

sh
# 移除本地镜像
make clear  # 等效于: sudo docker rmi -f zolweb/docker-mailcatcher