jivanyatra/maildump

maildump Docker镜像文档

镜像概述和主要用途

本Docker镜像是ThiefMaster/maildump的容器化实现，基于Alpine Python基础镜像构建，轻量级且高效。maildump是Samuel Cochran的MailCatcher的Python实现，核心功能为启动一个SMTP服务器捕获 outgoing 邮件，同时提供Web界面查看捕获的邮件内容，适用于本地开发测试、homelab环境等场景，避免使用真实或临时进行测试。

核心功能和特性

• SMTP邮件捕获：运行SMTP服务器（默认端口1025），接收并捕获所有发送至该服务器的邮件
• Web界面查看：提供Web界面（默认端口1080），可直观查看捕获的邮件内容、附件等信息
• 轻量级设计：基于Alpine Python基础镜像，镜像体积小，资源占用低
• 可选数据持久化：支持将捕获的邮件保存至SQLite数据库，通过配置实现数据持久化
• 跨架构支持：提供linux/amd64和linux/arm64架构镜像，适配x86_64设备及树莓派等ARM设备

使用场景和适用范围

• 本地开发测试：开发过程中测试邮件发送功能，无需配置真实SMTP服务器
• homelab环境：捕获服务发出的邮件（如密码管理器邀请邮件），避免依赖外部***服务
• CI/CD测试流程：集成到自动化测试流程，验证邮件发送逻辑

详细使用方法和配置说明

基本部署（docker-compose）

以下是标准的docker-compose.yml配置示例：

yaml
version: '3.9'

services:
  maildump:
    image: jivanyatra/maildump:latest
    container_name: "maildump"
    environment:
      # 若仅需内存中存储邮件，注释此环境变量
      - DBFILE=1
    volumes:
      # 若仅需内存中存储邮件，注释此卷挂载
      - /path/to/MailDump/temp.db:/data/maildump.db
    ports:
      - 1025:1025 # SMTP服务端口
      - 8087:1080 # Web界面端口

配置参数说明

环境变量

卷挂载

• 数据库文件挂载：若启用DBFILE，需将宿主机目录下的SQLite数据库文件挂载至容器内/data/maildump.db，实现数据持久化。示例：/path/to/MailDump/temp.db:/data/maildump.db

端口映射

初始化SQLite数据库

若需使用数据库存储邮件，需先初始化空SQLite数据库文件，执行以下命令：

bash
sqlite3 maildump.db "VACUUM;"

测试镜像说明

版本标签

• maildump:1.2-testing：测试版本，基于replacing_smtpd_with_aiosmtp分支，尝试替换已弃用的smtpd库，仍在开发中。

镜像架构和基础

未来将维护两类镜像，支持x86_64和arm64架构：

• maildump:version：基于Debian bookworm
• maildump:version-alpine：基于Alpine（当前Alpine镜像启动速度较慢，正在优化）

注意事项

• 镜像未包含.htaccess密码保护功能，原因：本地测试无需密码保护；生产/测试服务器可通过NGINX反向代理实现认证。
• 源码及Dockerfile可在https://github.com/jivanyatra/maildump-docker%E8%8E%B7%E5%8F%96%E3%80%82