werkspot/docker-imap-devel

Dockerized IMAP 服务器

镜像概述和主要用途

本Docker镜像提供一个用于开发和调试的IMAP服务器，基于Postfix（SMTP）和Dovecot（IMAP）构建。重要提示：此镜像仅用于开发/调试目的，不适合生产环境。

该镜像基于https://github.com/tomav/docker-mailserver%E9%A1%B9%E7%9B%AE%E7%AE%80%E5%8C%96%E8%80%8C%E6%9D%A5%EF%BC%8C%E6%AF%94%60tvial/docker-mailserver%60%E6%9B%B4%E8%BD%BB%E9%87%8F%EF%BC%8C%E5%8C%85%E5%90%AB%E4%B8%80%E4%B8%AA%E9%BB%98%E8%AE%A4%E7%9A%84catchall***%60debug@example.org%60%EF%BC%8C%E5%8F%AF%E6%8E%A5%E6%94%B6%E6%89%80%E6%9C%89%E5%8F%91%E9%80%81%E5%88%B0%E8%AF%A5%E6%9C%8D%E5%8A%A1%E5%99%A8%E7%9A%84%E9%82%AE%E4%BB%B6%E3%80%82%E6%AD%A4%E5%A4%96%EF%BC%8C%E8%BF%98%E6%94%AF%E6%8C%81%E9%85%8D%E7%BD%AE%E9%A2%9D%E5%A4%96%E7%9A%84%E6%99%AE%E9%80%9A%E7%94%A8%E6%88%B7***%EF%BC%8C%E4%BE%BF%E4%BA%8E%E6%B5%8B%E8%AF%95%E9%82%AE%E4%BB%B6%E5%8F%91%E9%80%81%E5%92%8C%E6%8E%A5%E6%94%B6%E6%B5%81%E7%A8%8B%E3%80%82

核心功能和特性

• 轻量级设计：仅包含Postfix（SMTP）和Dovecot（IMAP）核心组件
• Catchall***：默认***debug@example.org接收所有邮件，确保测试安全
• 可选普通***：支持通过环境变量配置额外的用户***
• 简化配置：无需复杂设置，快速部署调试环境
• SMTP无认证：允许无认证发送邮件，便于测试应用发送功能
• IMAP SSL加密：支持SSL加密的IMAP连接，模拟真实邮件接收场景

使用场景和适用范围

• 开发环境中测试Web应用的邮件发送功能
• 调试邮件模板渲染和内容格式
• 安全测试邮件发送逻辑，避免向真实用户***发送测试邮件
• 验证邮件接收流程和格式正确性

使用方法和配置说明

环境准备

确保已安装Docker和Docker Compose。

部署步骤

1. 获取docker-compose配置文件

bash
cp docker-compose.yml.dist docker-compose.yml

2. 编辑配置文件

修改docker-compose.yml中的环境变量：

• MAILNAME：邮件域名（默认值：localdomain.test）
• MAIL_ADDRESS：可选，普通用户***地址（如user@example.org）
• MAIL_PASS：可选，普通用户***密码

3. 启动容器

bash
docker-compose up

邮件客户端配置

Catchall调试***（默认）

• IMAP服务器：imap

• IMAP加密：SSL

• IMAP端口：993

• IMAP用户名：debug@example.org（将example.org替换为您的MAILNAME值）

• IMAP密码：debug

• SMTP服务器：imap

• SMTP加密：无

• SMTP端口：25

• SMTP认证：无

普通用户***（可选）

仅当配置了MAIL_ADDRESS和MAIL_PASS时可用：

• IMAP服务器：imap

• IMAP加密：SSL

• IMAP端口：993

• IMAP用户名：address@example.org（替换为您配置的MAIL_ADDRESS值）

• IMAP密码：pass（替换为您配置的MAIL_PASS值）

• SMTP服务器：imap

• SMTP加密：无

• SMTP端口：25

• SMTP认证：无

使用示例

向任意地址发送测试邮件（如test@example.com），邮件将被自动投递到debug@example.org，通过IMAP客户端连接即可查看邮件内容。