jcalonso/mailhog

MailHog多架构镜像

镜像概述

本镜像为MailHog的分支版本（Fork），主要增强了多架构Docker镜像构建支持。MailHog是一款轻量级邮件测试工具，可在开发环境中模拟SMTP服务器，捕获应用程序发送的邮件并通过Web界面进行查看，无需实际发送到真实***。本分支版本延续了MailHog的核心功能，并提供对多种硬件架构（如amd64、arm64等）的支持。

项目地址：https://github.com/jcalonso/MailHog

核心功能与特性

基础功能

• 内置SMTP服务器，默认监听端口1025，接收应用发送的邮件
• 提供Web界面，默认端口8025，用于查看捕获的邮件内容、附件及邮件头信息
• 支持邮件存储（内存或文件系统）
• 支持邮件搜索和过滤

多架构支持

• 支持构建并运行于多种硬件架构，包括但不限于：
  • amd64（x86_64）
  • arm64（ARMv8）
  • 其他常见架构（具体取决于构建配置）

使用场景

• 开发环境邮件测试：在应用开发过程中，测试邮件发送功能（如注册验证、密码重置、通知邮件等），无需配置真实SMTP服务
• CI/CD流程集成：在自动化测试中验证邮件发送逻辑
• 多架构开发环境：在不同硬件架构（如ARM开发板、Apple Silicon设备）上部署邮件测试服务

使用方法

基本部署（Docker Run）

bash
docker run -d -p 1025:1025 -p 8025:8025 docker.xuanyuan.run/jcalonso/mailhog

参数说明：

• -p 1025:1025：映射SMTP服务端口（容器内1025端口映射到主机1025端口）
• -p 8025:8025：映射Web界面端口（容器内8025端口映射到主机8025端口）
• -d：后台运行容器

Docker Compose配置

yaml
version: '3'
services:
  mailhog:
    image: docker.xuanyuan.run/jcalonso/mailhog
    ports:
      - "1025:1025"  # SMTP端口
      - "8025:8025"  # Web界面端口
    restart: always

访问Web界面

部署完成后，通过浏览器访问 http://<主机IP>:8025 即可打开MailHog Web界面，查看所有捕获的邮件。

配置环境变量

可通过环境变量自定义MailHog行为，常用变量包括：

示例：自定义端口

bash
docker run -d \
  -p 2525:2525 \
  -p 8080:8080 \
  -e MH_SMTP_BIND_ADDR=0.0.0.0:2525 \
  -e MH_WEB_BIND_ADDR=0.0.0.0:8080 \
  docker.xuanyuan.run/jcalonso/mailhog

注意事项

• 本镜像仅用于开发和测试环境，不建议在生产环境中使用
• 内存存储模式下，容器重启后邮件数据将丢失；如需持久化，可配置文件存储或挂载卷
• 多架构支持需Docker环境支持相应架构（如使用docker manifest或多架构镜像仓库）