easyengine/mail 镜像文档

镜像概述和主要用途

easyengine/mail 是 EasyEngine 项目使用的 Postfix 3.3 邮件服务器镜像，基于轻量级 Linux 基础镜像构建。主要用途是在 EasyEngine 环境中提供可靠的 SMTP 邮件服务，支持邮件发送、队列管理及基础邮件路由功能，满足网站或应用的邮件通知需求。

核心功能和特性

• Postfix 3.3 核心功能：支持 SMTP 协议（RFC 5321 兼容），提供邮件发送、接收（可选）、队列管理及别名映射能力。
• 轻量级设计：优化资源占用，适合与 EasyEngine 其他组件（如 Nginx、PHP、数据库）协同部署。
• 灵活配置：支持通过环境变量快速定义基础参数（如域名、允许发送的网络范围），也可通过挂载配置文件实现深度自定义。
• 集成友好：与 EasyEngine 生态无缝对接，适配网站应用的邮件通知场景（如用户注册、密码重置邮件）。
• 日志可观测：默认支持日志输出，便于问题排查和邮件流量监控。

使用场景和适用范围

• EasyEngine 网站/应用邮件通知：用于发送用户注册确认、订单提醒、密码重置等事务性邮件。
• 服务器运维告警：对接监控工具（如 Prometheus、Nagios），发送服务器资源告警（如磁盘空间不足、服务异常）。
• 开发/测试环境：本地搭建轻量级 SMTP 服务，模拟邮件发送流程，避免依赖外部邮件服务。
• 中小规模邮件需求：适用于单服务器或小型集群的低流量邮件场景，不建议直接用于大规模邮件营销。

详细使用方法和配置说明

拉取镜像

从 DockerHub 拉取最新版本镜像：

docker pull easyengine/mail

基本运行示例（docker run）

通过 docker run 快速启动容器，以下为基础配置示例（根据实际需求调整参数）：

docker run -d \
  --name easyengine-mail \
  -p 25:25 \  # 暴露 SMTP 端口（默认 25）
  -e MYDOMAIN=example.com \  # 邮件域名（如无特殊需求可省略，默认 localhost）
  -e MYNETWORKS=172.17.0.0/16 \  # 允许发送邮件的客户端 IP 范围（Docker 桥接网络）
  -v /path/on/host/postfix/logs:/var/log/postfix \  # 挂载日志目录（可选，便于持久化日志）
  easyengine/mail

Docker Compose 配置示例

适用于多容器环境（如与 EasyEngine 其他组件联动），创建 docker-compose.yml：

version: '3'
services:
  mail:
    image: easyengine/mail
    container_name: easyengine-mail
    restart: unless-stopped  # 服务异常时自动重启
    ports:
      - "25:25"  # SMTP 端口映射
    environment:
      # 基础配置
      - MYDOMAIN=example.com  # 邮件发送域名（影响邮件头中的 "From" 域）
      - MYNETWORKS=172.17.0.0/16,192.168.1.0/24  # 允许发送的网络（多个网段用逗号分隔）
      # 中继配置（如需通过外部 SMTP 服务发送邮件，如 Gmail、企业邮箱）
      - RELAYHOST=[smtp.example.com]:587  # 中继主机地址（格式：[主机]:端口）
      - SMTP_USER=***  # 中继服务认证用户名
      - SMTP_PASSWORD=your-relay-password  # 中继服务认证密码
    volumes:
      - ./postfix/logs:/var/log/postfix  # 持久化邮件日志
      - ./postfix/ssl:/etc/postfix/ssl  # 挂载 TLS 证书（可选，启用加密时需配置）

启动服务：

docker-compose up -d

环境变量说明

通过环境变量可快速配置 Postfix 核心参数，常用变量如下（具体支持范围以镜像实际实现为准）：

数据卷挂载

为避免容器重启后配置或日志丢失，建议挂载以下目录：

自定义配置

如需调整 Postfix 高级参数（如邮件大小限制、超时设置），可通过以下方式实现：

1. 本地创建自定义 main.cf 文件，添加或覆盖配置（如 message_size_limit = 5242880 限制单封邮件大小为 5MB）。
2. 启动容器时挂载该文件：

docker run -d \
  --name easyengine-mail \
  -v /path/to/custom/main.cf:/etc/postfix/main.cf \  # 覆盖默认主配置
  easyengine/mail

构建状态