tabascoterrier/docker-imap-devel

docker-imap-devel 镜像文档

镜像概述

docker-imap-devel是一个面向开发环境的轻量级IMAP和SMTP服务器镜像，基于antespi/docker-imap-devel项目分支开发，进行了功能更新并提供arm64与amd64双架构支持。该镜像旨在为开发人员提供本地邮件服务测试环境，无需依赖外部邮件服务器即可完成邮件发送、接收等功能的开发与调试。

核心功能和特性

• 协议支持：完整支持IMAP（互联网消息访问协议）和SMTP（简单邮件传输协议），满足邮件收发基本需求
• 多架构支持：同时提供arm64和amd64架构镜像，适配不同硬件平台
• 轻量级设计：基于精简基础镜像构建，资源占用低，启动速度快
• 即开即用：无需复杂配置，启动即可使用默认邮件服务
• 开发友好：支持动态创建测试***账户，方便模拟不同邮件场景

使用场景和适用范围

• 邮件功能开发：本地开发邮件发送、接收相关功能时作为测试服务器
• 应用调试：验证应用程序的邮件通知、注册邮件、密码重置邮件等功能
• CI/CD测试：集成到持续集成/持续部署流程中，自动化测试邮件相关模块
• 教学演示：邮件协议学习和测试环境搭建

使用方法和配置说明

基本运行命令

通过以下命令快速启动镜像：

bash
docker run -d \
  --name imap-devel \
  -p 25:25 \  # SMTP端口
  -p 143:143 \ # IMAP端口
  tabascoterrier/imap-devel

端口说明

默认配置

镜像启动后默认提供以下配置：

• 无需身份验证即可发送邮件
• 支持任意账户（无需预先创建，直接使用任意地址登录）
• 邮件存储于容器内存中，容器重启后数据会丢失（适合开发测试场景）

连接测试

使用邮件客户端或命令行工具测试连接：

SMTP测试（使用telnet）：

bash
telnet localhost 25
EHLO example.com
MAIL FROM: test@example.com
RCPT TO: recipient@example.com
DATA
Subject: Test Email
This is a test email from docker-imap-devel.
.
QUIT

IMAP测试（使用telnet）：

bash
telnet localhost 143
LOGIN recipient@example.com password  # 任意密码均可登录
LIST "" "*"  # 列出邮件文件夹
FETCH 1 BODY[TEXT]  # 获取第一封邮件内容
QUIT

docker-compose配置示例

创建docker-compose.yml文件：

yaml
version: '3'
services:
  imap-devel:
    image: tabascoterrier/imap-devel
    ports:
      - "25:25"
      - "143:143"
    restart: unless-stopped

启动服务：

bash
docker-compose up -d

注意事项

• 该镜像仅适用于开发测试环境，不具备生产环境所需的安全性和稳定性
• 容器重启后所有邮件数据将丢失，请勿用于存储重要数据
• 默认配置未启用加密（如TLS/SSL），生产环境需额外配置安全层