dbck/mailtrap

dbck/mailtrap 镜像文档

镜像概述与主要用途

本镜像提供一个简单的全能邮件服务器，适用于开发环境，支持SMTP、IMAP协议及Webmail功能。基于Debian系统构建，仅使用默认软件包。请注意：此镜像仅用于开发目的，设计上不考虑安全性。若可从互联网访问，可能导致开放中继邮件服务器风险。

核心功能与特性

• 开发专用邮件捕获：为开发环境提供邮件接收和查看功能，避免向真实***发送测试邮件
• 高性能存储：使用Dovecot作为邮件投递代理(MDA)，采用sdbox存储格式，相比mbox在处理数千封邮件时提供更优的性能和稳定性
• 安全协议支持：提供StartTLS/SSL加密，使用自签名snakeoil证书
• 多协议支持：同时支持SMTP、IMAP协议及Webmail界面
• Web API接口：提供/api/inbox端点，可通过JSON格式获取收件箱邮件

可用服务与端口

环境变量配置

可通过以下环境变量自定义容器行为，默认值如下：

使用方法

启动容器注意事项

• --rm 标志：容器停止时自动删除实例
• --init 标志：加速容器关闭过程，建议添加
• 端口绑定：建议仅绑定到localhost，避免外部访问

简单启动

bash
docker container run -d --rm --init --name=mailtrap -p 127.0.0.1:9080:80 -p 127.0.0.1:9025:25 dbck/mailtrap

映射所有端口

bash
docker container run -d --rm --init --name=mailtrap \
  -p 127.0.0.1:9080:80 \
  -p 127.0.0.1:9025:25 \
  -p 127.0.0.1:9587:587 \
  -p 127.0.0.1:9465:465 \
  -p 127.0.0.1:9143:143 \
  -p 127.0.0.1:9993:993 \
  dbck/mailtrap

建议的端口映射

bash
docker container run -d --rm --init --name=mailtrap \
  -p 127.0.0.1:9080:80 \
  -p 127.0.0.1:9025:25 \
  -p 127.0.0.1:9587:587 \
  -p 127.0.0.1:9143:143 \
  dbck/mailtrap

# 查看容器日志
docker logs -f mailtrap

Docker Compose配置示例

完整的docker-compose配置可参考 https://github.com/dbck/docker-mailtrap/blob/main/docker-compose.example.yml

更多文档

详细文档请参考 https://github.com/dbck/docker-mailtrap/blob/main/README.adoc