phamhieu/inbucket

Inbucket镜像说明

镜像概述

Inbucket是一款轻量级邮件测试服务，旨在帮助开发者验证邮件发送功能。它支持接收任意***地址的消息，并通过Web界面、REST API及POP3协议提供消息访问能力。该镜像内置HTTP、SMTP、POP3服务及存储功能，无需外部依赖，可快速部署用于开发测试场景。

核心功能

• 多协议支持：接收SMTP邮件，通过Web界面、REST API和POP3协议查询消息
• 独立运行：编译后无外部依赖（如数据库），可直接启动
• 开源许可：基于MIT协议开源，允许自由使用与二次开发
• 跨平台兼容：支持Unix、OS X等主流操作系统

使用场景

• 开发阶段测试邮件发送逻辑，无需真实***账号
• 调试邮件模板渲染效果与格式正确性
• 验证系统邮件通知功能的可靠性
• 模拟第三方邮件服务的接收行为

配置说明

Inbucket通过环境变量配置，默认参数如下：

• SMTP服务监听localhost:2500
• Web界面访问地址http://localhost:9000
• 可通过官方Configurator工具生成自定义配置文件

Docker部署示例

基础运行

bash
docker run -d -p 2500:2500 -p 9000:9000 phamhieu/inbucket

映射容器内SMTP端口（2500）和Web端口（9000）到主机，访问http://localhost:9000即可查看Web界面。

自定义端口配置

如需修改服务端口，可通过环境变量指定：

bash
docker run -d -p 25:25 -p 8080:8080 \
  -e SMTP_BIND=0.0.0.0:25 \
  -e HTTP_BIND=0.0.0.0:8080 \
  phamhieu/inbucket

此命令将SMTP服务改为25端口，Web服务改为8080端口。