mailcow: dockerized 中文技术文档

镜像概述和主要用途

mailcow: dockerized 是一个开源、全功能的邮件服务器解决方案，基于 Docker 容器化技术构建。它集成了邮件传输（SMTP）、接收（IMAP/POP3）、Web 管理界面及相关辅助服务，提供开箱即用的邮件系统部署能力。主要用途包括搭建个人或企业级邮件服务器，支持邮件发送、接收、存储、管理及安全防护等全流程需求。

核心功能和特性

• 完整邮件协议支持：兼容 SMTP、IMAP、POP3 协议，支持邮件客户端（如 Outlook、Thunderbird）和移动设备接入。
• Web 管理界面：提供直观的管理面板（mailcow UI）和邮件客户端（SOGo），支持邮件收发、通讯录管理、日历同步。
• 安全防护：内置 SSL/TLS 加密（Let's Encrypt 自动证书申请）、SPF/DKIM/DMARC 反伪造机制、SpamAssassin 反垃圾邮件、ClamAV 防病毒扫描。
• 灵活扩展性：模块化容器架构，支持按需扩展组件（如增加反垃圾邮件规则、自定义存储策略）。
• 数据持久化：所有配置和邮件数据通过 Docker 卷（Volumes）持久化，支持备份与迁移。
• 多域名支持：可配置多个域名，管理不同域名下的***账户。

使用场景和适用范围

• 个人/家庭用户：搭建私有邮件服务器，实现邮件数据自主管理。
• 小型企业/组织：部署内部邮件系统，满足团队协作与外部沟通需求。
• 开发/测试环境：快速搭建邮件服务用于应用测试（如邮件发送功能验证）。
• 隐私敏感场景：需控制邮件数据存储位置，避免第三方服务依赖的场景。

使用方法和配置说明

环境准备

• 系统要求：Linux 服务器（推荐 Ubuntu/Debian/CentOS），2GB+ 内存，20GB+ 磁盘空间。
• 软件依赖：Docker Engine 20.10+、Docker Compose v2+、Git。

安装步骤

1. 安装依赖工具

# Ubuntu/Debian 示例
apt update && apt install -y docker.io docker-compose git
systemctl enable --now docker

2. 克隆代码仓库

git clone [***]
cd mailcow-dockerized

3. 生成配置文件

运行配置生成脚本，根据提示输入域名（如 mail.example.com）、时区等基础信息：

./generate_config.sh

脚本会自动创建 .env 配置文件（核心配置）和 docker-compose.yml。

4. 启动服务

docker-compose up -d

首次启动需拉取镜像（约 5-10 分钟，取决于网络），完成后服务自动运行。

基本配置

访问 Web 界面

• 管理面板：https://<你的域名>/（默认账户：admin，密码：.env 文件中的 MAILCOW_ADMIN_PASSWORD）。
• 邮件客户端：https://<你的域名>/SOGo（使用***账户登录）。

添加***账户

1. 登录管理面板，进入 E-mail > Mailboxes。
2. 点击 Add mailbox，输入用户名（如 ***）、密码，保存即可。

启动与停止服务

# 启动服务
docker-compose up -d

# 停止服务
docker-compose down

# 重启服务
docker-compose restart

# 查看日志
docker-compose logs -f

配置参数与环境变量

核心配置文件

所有配置通过 mailcow-dockerized/.env 文件管理，修改后需重启服务生效：

nano .env  # 编辑配置
docker-compose down && docker-compose up -d  # 应用修改

常用环境变量说明

部署示例：Docker Compose 配置片段

mailcow 通过自带的 docker-compose.yml 管理容器，核心组件包括：

• postfix：SMTP 服务器
• dovecot：IMAP/POP3 服务器
• nginx：Web 反向代理
• sogo：Web 邮件客户端
• mariadb：数据库服务

无需手动修改 docker-compose.yml，所有自定义配置通过 .env 文件实现。

数据备份与迁移

备份数据

# 进入 mailcow 目录
cd mailcow-dockerized

# 运行***备份脚本（默认备份至 ./backup 目录）
./backup_and_restore.sh backup all

迁移步骤

1. 在新服务器重复「安装步骤 1-3」（克隆仓库、生成配置）。
2. 复制旧服务器的 .env 文件和 backup/ 目录到新服务器。
3. 恢复数据：

./backup_and_restore.sh restore all ./backup/<备份文件名>

常见问题

• 无法访问 Web 界面：检查防火墙是否开放 80/443 端口，或 .env 中 HTTPS_PORT 是否冲突。
• 邮件发送失败：检查域名 DNS 记录（需配置 A 记录指向服务器 IP，MX 记录指向 mail.example.com）。
• 证书申请失败：确保服务器能访问 Let's Encrypt 服务器（80 端口需对公网开放）。

更多问题参见 ***文档。