instructure/mailcatcher

MailCatcher

镜像概述

MailCatcher Docker容器是对MailCatcher的包装，运行一个SMTP服务器（端口1025）以接收任意发送的邮件，并提供Web服务器（端口8080）用于在网页邮件界面中浏览这些邮件。

核心功能与特性

• SMTP服务器：监听端口1025，无需认证，可接收任意邮件
• Web邮件界面：通过端口8080提供网页访问，收件箱会自动刷新显示新邮件
• 开发友好：配置简单，无需复杂认证，直接作为开发环境SMTP服务器使用

使用场景与适用范围

特别适用于开发环境中，为应用程序配置默认SMTP服务器，方便测试邮件发送功能，无需依赖外部邮件服务。

使用方法与配置说明

Docker Compose配置

在docker-compose.yml中添加以下配置：

yaml
mailcatcher:
  image: docker.xuanyuan.run/instructure/mailcatcher
  environment:
    VIRTUAL_HOST: mail.example.docker  # Web访问域名
    VIRTUAL_PORT: 8080                 # Web服务器端口

应用SMTP服务器配置

配置开发环境的SMTP服务器设置（无需认证）：

• 地址：mailcatcher（容器名）
• 端口：1025

Rails应用示例

在config/environments/development.rb中添加：

ruby
config.action_mailer.smtp_settings = {
  address: 'mailcatcher', port: 1025
}

访问邮件网页界面

启动容器后，通过浏览器访问以下地址即可查看邮件：

• [***]

网页收件箱会自动刷新，显示所有 incoming 邮件。