mailcow/phpfpm

mailcow: dockerized - 容器化邮件服务器解决方案

镜像概述和主要用途

mailcow: dockerized 是一个基于 Docker 容器化技术构建的开源邮件服务器套件，集成了邮件服务所需的核心组件（如 SMTP、POP3、IMAP、Webmail、反垃圾邮件、防病毒等），旨在提供开箱即用、易部署、易维护的邮件服务解决方案。其主要用途是帮助企业、组织或个人快速搭建功能完整、安全可靠的自建邮件系统，支持自定义域名、邮件收发、日历协作、地址簿管理等核心邮件服务场景。

核心功能和特性

• 完整邮件协议支持：兼容 SMTP、POP3、IMAP 协议，支持邮件收发、存储与检索。
• Webmail 与协作工具：集成 Roundcube 作为 Webmail 界面，支持邮件、日历、地址簿、任务管理等协作功能。
• 安全防护机制：内置 ClamAV 防病毒引擎、SpamAssassin 反垃圾邮件系统，支持 DKIM、SPF、DMARC 邮件验证协议，默认启用 TLS 加密。
• 多域名与多用户管理：支持配置多个域名、创建多级别用户账户，支持邮件列表与别名设置。
• 自动化运维支持：自动配置 SSL/TLS 证书（Let's Encrypt 集成），支持容器健康检查与自动恢复。
• 可扩展性与兼容性：支持自定义插件、API 集成，兼容主流邮件客户端（如 Outlook、Thunderbird）。
• 监控与日志：提供详细的邮件日志记录，支持集成外部监控工具（如 Prometheus）。

使用场景和适用范围

适用场景

• 企业或组织需要自建邮件系统，满足数据隐私与合规性要求。
• 中小企业需要低成本、易维护的邮件服务器解决方案。
• 开发者搭建测试或演示环境，验证邮件功能。
• 教育机构、非营利组织搭建内部邮件沟通平台。

适用范围

• 支持单服务器部署，也可通过负载均衡扩展至多节点架构。
• 适用于邮件用户规模从几十人到数千人的场景（需根据硬件资源调整）。
• 兼容 x86_64 和 ARM64 架构（部分组件可能需额外配置）。

使用方法和配置说明

环境要求

• Docker Engine 20.10+
• Docker Compose 2.10+
• 至少 4GB 内存（推荐 8GB+）
• 20GB+ 磁盘空间（SSD 优先）
• 公网 IP 与已解析的域名（需配置 MX、A/AAAA 记录）

安装步骤

1. 准备环境

确保 Docker 和 Docker Compose 已安装并运行：

bash
# 验证 Docker 状态
docker --version
docker compose version
systemctl status docker

2. 获取配置文件

mailcow 通过 Git 仓库提供完整的 Docker Compose 配置与脚本，需先克隆仓库：

bash
# 克隆官方仓库
git clone https://github.com/mailcow/mailcow-dockerized.git
cd mailcow-dockerized

3. 初始化配置

运行配置脚本生成基础配置（如域名、网络参数等）：

bash
./generate_config.sh

根据提示输入邮件服务器域名（如 mail.example.com）、时区等信息，脚本会自动生成 mailcow.conf 配置文件。

4. 启动服务

通过 Docker Compose 启动所有组件：

bash
docker compose up -d

首次启动需拉取镜像（约 10-30 分钟，取决于网络），启动后可通过 docker compose ps 查看服务状态。

配置说明

核心配置文件

• mailcow.conf：主配置文件，存储域名、端口、TLS 等核心参数（由 generate_config.sh 生成，可手动修改后重启服务）。
• data/conf/：各组件详细配置目录（如 Postfix、Dovecot、Nginx 等），修改后需重启对应服务。

关键环境变量（mailcow.conf）

启动与停止服务

bash
# 启动服务
docker compose up -d

# 停止服务（保留数据）
docker compose down

# 停止并删除数据（谨慎使用）
docker compose down -v

管理与维护

Web 管理界面

服务启动后，通过 https://<MAILCOW_HOSTNAME> 访问管理界面，默认管理员账户：

• 用户名：admin
• 密码：首次启动后在 data/conf/soapbox/credentials.secret 文件中查看

日志查看

bash
# 查看所有服务日志
docker compose logs -f

# 查看特定服务日志（如 postfix）
docker compose logs -f postfix-mailcow

部署方案示例

Docker Compose 配置（核心服务片段）

mailcow 包含多个组件（如 Postfix、Dovecot、MySQL、Redis 等），完整配置通过 docker-compose.yml 管理，无需手动编写。以下为核心服务结构示例：

yaml
# 来自 mailcow-dockerized/docker-compose.yml
version: '2.1'
services:
  postfix-mailcow:
    image: mailcow/postfix:latest
    depends_on:
      - mysql-mailcow
      - redis-mailcow
    environment:
      - MAILCOW_HOSTNAME=${MAILCOW_HOSTNAME}
      - TLS_TYPE=${TLS_TYPE}
    volumes:
      - ./data/conf/postfix:/etc/postfix
    restart: always

  dovecot-mailcow:
    image: mailcow/dovecot:latest
    depends_on:
      - mysql-mailcow
      - redis-mailcow
    environment:
      - MAILCOW_HOSTNAME=${MAILCOW_HOSTNAME}
    volumes:
      - ./data/conf/dovecot:/etc/dovecot
      - ./data/vmail:/var/vmail
    restart: always

  # 其他服务：nginx、roundcube、clamav、spamassassin 等...

常见问题与参考

• 证书更新：Let's Encrypt 证书会自动续期，无需手动操作。
• 数据备份：核心数据位于 ./data/ 目录，建议定期备份该目录。
• 版本升级：通过 git pull 更新仓库后，执行 docker compose pull && docker compose up -d 升级。

完整文档请参考 https://mailcow.github.io/mailcow-dockerized-docs/%E3%80%82