jderusse/mailcatcher

Mailcatcher Docker 镜像文档

镜像概述

本镜像为Mailcatcher提供轻量级Docker化部署方案。Mailcatcher是一款开发测试工具，可运行本地SMTP服务器捕获所有发送的邮件，并通过Web界面展示邮件内容，无需实际发送到真实***。

核心功能和特性

• 轻量级设计：基于精简基础镜像，资源占用低，启动快速
• SMTP服务器：内置SMTP服务（默认端口1025），接收应用发送的邮件
• Web界面：提供直观的Web界面（默认端口1080），用于查看、搜索和管理捕获的邮件
• 无持久化存储：邮件数据仅保存在内存中，容器重启后自动清除，适合开发测试场景
• 跨平台兼容：可在任何支持Docker的环境中运行，无需复杂依赖配置

使用场景和适用范围

• 开发环境邮件测试：在应用开发过程中测试邮件发送功能，无需配置真实***
• 邮件模板调试：预览邮件格式、样式和内容，验证HTML和文本邮件渲染效果
• CI/CD流程集成：作为自动化测试环境的邮件捕获工具，验证应用邮件发送逻辑
• 教学和演示：展示邮件发送机制，无需涉及真实邮件服务

使用方法和配置说明

基本运行命令

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

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

参数说明：

• -d：后台运行容器
• -p 1025:1025：映射SMTP服务端口（容器内端口:宿主机端口）
• -p 1080:1080：映射Web界面端口
• --name mailcatcher：指定容器名称

访问Web界面

启动后，通过浏览器访问以下地址查看捕获的邮件：

http://localhost:1080

应用配置示例

将应用的SMTP服务器配置为Mailcatcher容器地址：

• SMTP服务器：localhost（或Docker宿主机IP）
• SMTP端口：1025
• 无需身份验证

docker-compose配置

创建docker-compose.yml文件：

yaml
version: '3'
services:
  mailcatcher:
    image: schickling/mailcatcher
    ports:
      - "1025:1025"  # SMTP端口
      - "1080:1080"  # Web界面端口
    restart: unless-stopped

启动服务：

bash
docker-compose up -d

自定义配置（可选）

可通过命令行参数自定义Mailcatcher配置，例如修改端口：

bash
docker run -d -p 25:25 -p 8080:8080 --name mailcatcher schickling/mailcatcher --smtp-port 25 --http-port 8080

常用参数：

• --smtp-port：指定SMTP服务端口（默认1025）
• --http-port：指定Web界面端口（默认1080）
• --ip：绑定IP地址（默认0.0.0.0）