schickling/mailcatcher

mailcatcher

镜像概述

mailcatcher是一个超小型Docker镜像（261.9 MB），主要用于在开发和测试环境中捕获邮件，提供Web界面查看已发送的邮件，无需配置真实邮件服务器即可测试邮件发送功能。

核心功能和特性

• 超小体积：镜像大小仅261.9 MB，资源占用低
• 邮件捕获：提供SMTP服务（默认端口1025），接收应用发送的邮件
• Web界面：通过Web端口（默认1080）查看捕获的邮件内容、附件等
• 易于集成：可与其他容器链接，方便应用测试邮件发送功能

使用场景

• 开发环境中测试邮件发送功能（如注册验证邮件、通知邮件等）
• 调试邮件模板、内容格式和发送逻辑
• 避免在测试过程中向真实***发送邮件

使用方法

基本运行

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

sh
docker run -d -p 1080:1080 --name mailcatcher docker.xuanyuan.run/schickling/mailcatcher

参数说明：

• -d：后台运行容器
• -p 1080:1080：将容器的1080端口映射到主机，用于访问Web界面
• --name mailcatcher：指定容器名称为mailcatcher

启动后，可通过 http://localhost:1080 访问Web界面查看捕获的邮件。

与其他容器链接

将mailcatcher容器链接到应用容器，应用可通过SMTP端口1025发送邮件。链接后，应用容器可通过环境变量 $MAILCATCHER_PORT_1025_TCP_ADDR 获取mailcatcher容器的地址，使用端口1025进行邮件发送。

例如，在docker-compose中配置：

yaml
version: '3'
services:
  app:
    build: .
    links:
      - mailcatcher
    environment:
      - SMTP_HOST=mailcatcher
      - SMTP_PORT=1025
  mailcatcher:
    image: docker.xuanyuan.run/schickling/mailcatcher
    ports:
      - "1080:1080"

应用容器中配置SMTP服务器为 mailcatcher:1025，发送的邮件将被mailcatcher捕获并显示在Web界面中。