engines/imap

邮件存储服务镜像

镜像概述和主要用途

该Docker镜像提供基于LMTP协议的邮件存储功能，同时集成IMAP(s)和POP3(s)邮件访问服务，作为邮件引擎的后端存储解决方案。它能够接收、存储邮件，并允许客户端通过标准邮件协议访问邮件数据，适用于构建邮件系统或为需要邮件功能的应用提供后端支持。

核心功能和特性

• LMTP协议支持：通过LMTP（本地邮件传输协议）接收和存储邮件，兼容主流邮件传输代理
• 多协议访问：提供IMAP和IMAPS（加密）协议，支持邮件的管理和访问；同时支持POP3和POP3S（加密）协议，满足邮件下载需求
• 数据持久化：支持邮件数据的持久化存储，确保服务重启后数据不丢失
• 安全传输：内置TLS/SSL加密支持，保障邮件传输过程中的数据安全
• 灵活配置：可通过环境变量和配置文件自定义服务参数，适应不同使用场景

使用场景和适用范围

• 企业邮件系统的后端存储组件
• 邮件服务器的核心存储服务
• 需要集成邮件接收和访问功能的应用引擎
• 开发测试环境中的邮件服务搭建
• 小型邮件服务的快速部署

使用方法和配置说明

基本使用（docker run）

bash
docker run -d \
  --name email-store \
  -p 143:143 \  # IMAP非加密端口
  -p 993:993 \  # IMAPS加密端口
  -p 110:110 \  # POP3非加密端口
  -p 995:995 \  # POP3S加密端口
  -p 24:24 \    # LMTP接收端口
  -v /path/to/maildata:/var/mail \  # 邮件数据持久化
  -e ADMIN_USER=admin \             # 管理员用户名
  -e ADMIN_PASSWORD=securepass \    # 管理员密码
  -e TLS_ENABLED=true \             # 启用TLS加密
  your-image-name:latest

Docker Compose配置

yaml
version: '3'
services:
  email-store:
    image: docker.xuanyuan.run/your-image-name:latest
    container_name: email-store
    ports:
      - "143:143"
      - "993:993"
      - "110:110"
      - "995:995"
      - "24:24"
    volumes:
      - maildata:/var/mail
      - ./tls:/etc/tls  # 挂载TLS证书目录
    environment:
      - ADMIN_USER=admin
      - ADMIN_PASSWORD=securepass
      - TLS_ENABLED=true
      - TLS_CERT_PATH=/etc/tls/cert.pem
      - TLS_KEY_PATH=/etc/tls/key.pem
      - MAX_MAIL_SIZE=50M  # 最大邮件大小
      - STORAGE_QUOTA=1G   # 用户存储配额
    restart: unless-stopped

volumes:
  maildata:  # 持久化邮件数据卷

配置参数说明

环境变量

端口映射

存储卷

• /var/mail：邮件数据存储目录，建议挂载外部卷以实现数据持久化
• /etc/tls：TLS证书存储目录，启用TLS时需挂载包含证书和私钥的目录