s1t5/mailarchiver

自动电子邮件归档 Docker 镜像文档

镜像概述

本Docker镜像提供了一套自动化电子邮件归档解决方案，旨在简化电子邮件的自动收集、分类、存储和管理流程。通过容器化部署，可快速集成到现有IT环境，减少手动操作成本，确保邮件数据的安全存储与便捷检索。

核心功能和特性

• 多协议支持：兼容IMAP、POP3、SMTP等主流邮件协议，适配各类邮件服务提供商（如Gmail、Outlook、企业自建邮件服务器等）。
• 定时自动同步：支持自定义同步频率（如每小时、每日），自动从指定***拉取新邮件并归档。
• 智能分类与标签：可根据发件人、主题、内容关键词等自动分类邮件，添加自定义标签，提升检索效率。
• 高效存储优化：内置邮件压缩算法，支持重复邮件去重，显著节省存储空间。
• 数据安全保障：支持传输层加密（TLS/SSL）和存储加密，保护邮件内容隐私与数据完整性。
• 灵活存储后端：支持本地文件系统、NFS、S3兼容对象存储（如AWS S3、MinIO）等多种存储方式。
• 日志与监控：提供详细操作日志，支持集成Prometheus等监控工具，实时追踪归档状态。

使用场景和适用范围

• 企业合规归档：满足***、等行业要求，自动归档员工邮件，支持长期保留与审计追溯。
• 个人邮件备份：个人用户自动备份重要邮件（如工作邮件、账单通知、合同往来等），防止数据丢失。
• 多账户集中管理：统一管理多个账户（如个人、工作***、客户服务***）的邮件归档。
• 历史邮件迁移：协助从旧邮件系统批量迁移历史邮件至新存储平台，减少手动操作。

使用方法和配置说明

快速启动（Docker Run）

bash
docker run -d \
  --name email-archiver \
  -e MAIL_PROTOCOL=imap \
  -e MAIL_SERVER=imap.example.com \
  -e MAIL_PORT=993 \
  -e MAIL_USERNAME=user@example.com \
  -e MAIL_PASSWORD=your_secure_password \
  -e SYNC_INTERVAL=3600 \  # 同步间隔（秒），默认3600秒（1小时）
  -e STORAGE_PATH=/archive \
  -v /host/archive/path:/archive \  # 挂载本地目录持久化存储归档邮件
  email-archiver:latest

核心环境变量配置

Docker Compose 配置示例

yaml
version: '3'
services:
  email-archiver:
    image: email-archiver:latest
    container_name: email-archiver
    restart: always
    environment:
      - MAIL_PROTOCOL=imap
      - MAIL_SERVER=imap.example.com
      - MAIL_PORT=993
      - MAIL_USERNAME=user@example.com
      - MAIL_PASSWORD=your_secure_password
      - SYNC_INTERVAL=3600
      - ENCRYPT_STORAGE=true
      - LOG_LEVEL=info
    volumes:
      - ./local-archive:/archive  # 本地目录挂载，持久化存储
    networks:
      - email-network

networks:
  email-network:
    driver: bridge

数据持久化

通过 -v /host/path:/archive 挂载本地目录，确保容器重启或升级后归档数据不丢失。对于大规模部署，建议使用NFS或S3兼容存储作为后端。

日志与监控

容器日志可通过 docker logs email-archiver 查看，详细记录同步状态、错误信息等。如需集成监控，可配置 PROMETHEUS_EXPORTER_PORT 环境变量启用Prometheus指标导出（默认端口9090）。

注意事项

• 部分邮件服务（如Gmail）需开启"Less secure app access"或使用应用专用密码（2-Step Verification启用时）。
• 首次运行时可能需要较长时间同步历史邮件，建议初始同步在非高峰时段进行。
• 敏感信息（如***密码）建议通过Docker Secrets或环境变量加密工具管理，避免明文暴露。