veita/test-postfix-dovecot

cont-test-postfix-dovecot 镜像文档

镜像概述

cont-test-postfix-dovecot是一个集成Postfix（SMTP服务器）和Dovecot（IMAP服务器）的轻量级Docker容器，专为开发和测试环境设计。该镜像提供开箱即用的邮件服务模拟功能，无需配置复杂的生产级邮件系统，即可快速验证应用程序的邮件发送（SMTP）和接收（IMAP）能力。

核心功能与特性

• 完整邮件服务栈：集成Postfix（SMTP）和Dovecot（IMAP），支持邮件发送与接收全流程测试
• 轻量级部署：基于精简基础镜像，资源占用低，启动速度快
• 零外部依赖：无需连接外部邮件服务或DNS配置，独立运行
• 灵活配置：支持自定义测试账户、端口映射及邮件存储路径
• 测试友好：默认禁用邮件转发限制，适合模拟各类邮件场景

使用场景与适用范围

• 开发环境测试：验证应用程序的邮件发送功能（如注册验证、密码重置邮件）
• 邮件流程调试：排查SMTP连接、邮件格式、附件处理等问题
• CI/CD集成：在自动化测试流程中验证邮件通知逻辑
• 邮件客户端测试：测试邮件客户端（如Thunderbird、Outlook）的SMTP/IMAP配置

使用方法与配置说明

快速启动（docker run）

通过以下命令快速启动容器，映射默认SMTP（25）和IMAP（143）端口：

bash
docker run -d \
  -p 25:25 \
  -p 143:143 \
  --name test-mail-server \
  veita/cont-test-postfix-dovecot

Docker Compose配置

创建docker-compose.yml文件集成到项目中：

yaml
version: '3'
services:
  mail-server:
    image: veita/cont-test-postfix-dovecot
    ports:
      - "25:25"   # SMTP端口
      - "143:143" # IMAP端口
    environment:
      - TEST_USER=test@example.com  # 自定义测试账户
      - TEST_PASSWORD=testpass123   # 测试账户密码
    volumes:
      - ./mail-data:/var/mail       # 持久化邮件存储（可选）

启动服务：

bash
docker-compose up -d

配置参数与环境变量

自定义测试账户

通过环境变量TEST_USER和TEST_PASSWORD创建测试账户后，可使用以下凭证连接：

• SMTP服务器：localhost:25（无需认证，或使用测试账户认证）
• IMAP服务器：localhost:143（使用TEST_USER和TEST_PASSWORD认证）

验证服务可用性

1. 发送测试邮件（SMTP）： 使用telnet或邮件客户端发送邮件至测试账户：

   bash
   telnet localhost 25
   HELO example.com
   MAIL FROM: sender@example.com
   RCPT TO: test@example.com
   DATA
   Subject: Test Email
   
   This is a test email.
   .
   QUIT
   

2. 接收测试邮件（IMAP）： 使用IMAP客户端连接localhost:143，登录测试账户即可查看接收的邮件。

注意事项

• 生产环境禁用：该镜像仅用于测试，未配置安全措施（如TLS、SPF/DKIM），禁止用于生产环境
• 端口冲突：若主机已占用25/143端口，可通过-p 2525:25 -p 1430:143映射至其他端口
• 数据持久化：挂载/var/mail卷可保留测试邮件，便于事后查看