从零部署 mailcow Docker 邮件服务器完整指南：4 条命令搭建企业级邮件系统

从零部署 mailcow Docker 邮件服务器完整指南：4 条命令搭建企业级邮件系统

【免费下载链接】mailcow-dockerizedmailcow: dockerized - 🐮 + 🐋 = 💕项目地址: https://gitcode.com/GitHub_Trending/ma/mailcow-dockerized

还在为自建邮件服务器头疼吗？Postfix 的配置写了一屏、Dovecot 的认证调了三天、垃圾邮件过滤器换了两个都不顺手——最后发现光是让邮件"发得出去"就耗掉了整个周末。mailcow: dockerized 就是来解决这个问题的：它把 Postfix、Dovecot、Rspamd、ClamAV、MariaDB 等十几个组件打包进 Docker 容器，一条docker compose up -d全部拉起。这篇文章带你走一遍 mailcow Docker 部署的完整流程，4 条命令、30 分钟左右，你的企业级邮件服务器就能跑起来。

🧰 动手前的 3 项准备

先花 2 分钟确认环境，能省掉后面 80% 的排查时间：

为什么用 mailcow 而不是自己装？对比一下就清楚了：传统方式要手动协调 10+ 组件的版本兼容性，升级时牵一发动全身；而 mailcow 用容器隔离每个服务，版本由官方统一锁定，安全更新一条./update.sh搞定，备份恢复也内置了脚本。对新手来说，这是"直接拥有"和"慢慢调通"的区别。

🚀 四步从零到可收信

第一步：把代码拿到服务器上

git clone https://gitcode.com/GitHub_Trending/ma/mailcow-dockerized cd mailcow-dockerized

第二步：生成 mailcow.conf 配置文件

mailcow 用mailcow.conf这一个文件承载所有关键配置（主机名、数据库密码、时区、功能开关），由 generate_config.sh 交互式生成。注意脚本要求当前目录存在指向它的软链接：

ln -s mailcow.conf .env ./generate_config.sh

脚本会依次问你 4 件事，逐个来：

1. 邮件服务器主机名（FQDN）：填mail.yourdomain.com。注意这是服务器的主机名，不是你将来收发的邮件域名；必须带子域名，裸域名官方提示"未充分测试"。
2. 时区：直接回车接受系统检测到的值，如Asia/Shanghai。
3. ClamAV 病毒扫描开关：内存不足 2.5GB 时脚本会建议你选y关闭，之后随时可在mailcow.conf里把SKIP_CLAMD=n重新打开。
4. 分支选择：选master（稳定版，推荐生产使用）；nightly是测试分支，legacy仅收安全更新。

生成的文件里已自动填好随机数据库密码、管理员默认账号（admin/moohoo）等信息，无需手填。

第三步：启动并验证

docker compose up -d

首次启动需要拉取并初始化一批镜像，耐心等几分钟。然后确认所有容器都是Up状态：

docker compose ps

如果某个容器在反复重启，用docker compose logs <容器名>看日志，十有八九是端口冲突或 DNS 解析问题。

第四步：打开 Web 界面，建第一个域名和邮箱

浏览器访问https://mail.yourdomain.com，用admin/moohoo登录。第一件事就是改掉默认密码，这是唯一不能偷懒的步骤。

登录后在 Web 界面里：

1. 进入"电子邮件 → 域名"，添加yourdomain.com；
2. 界面会生成该域名需要的 DNS 记录清单（MX、SPF、DKIM 等），照着去 DNS 服务商处配置；
3. 域名验证通过后，新建第一个邮箱，设置密码与配额，发一封测试邮件验证收发。

到这一步，你的 mailcow 邮件服务器已经真正"活着"了。

🧩 容器都在跑什么？1 分钟看懂架构

mailcow 本质是一组职责单一的容器，通过内部网络互相通信，全部由 docker-compose.yml 编排。你不需要背下每一个，知道"谁管什么"即可：

邮件的流转路径是这样的：发件时 Postfix 把邮件先交给 Rspamd 评分（Rspamd 再调用 ClamAV 扫附件），通过才投递；收件时外部邮件同样先过 Rspamd，被判为垃圾的进隔离区而不是直接丢进用户收件箱——这一点在管理界面的"隔离区"里可以随时复查。

🛡️ 反垃圾不是玄学：三层防线怎么分工

mailcow 的防垃圾能力来自 data/conf/rspamd/ 下的配置，三层防线各司其职：

• 第一层 · 信誉查询：基于 RBL/黑名单实时查询发信 IP 与域名的信誉，拦截绝大多数裸奔的垃圾源；
• 第二层 · 内容评分：Rspamd 对邮件头、正文做规则匹配与贝叶斯学习，分数超过阈值判为垃圾；
• 第三层 · 附件杀毒：ClamAV 扫描所有附件，防病毒也防带毒的"正常"邮件。

日常你几乎不用碰它的配置。Web 界面的 Rspamd 面板里可以查看实时评分、白/黑名单，还有基于正则的自定义规则——够用了。真遇到误判，优先把对方加入白名单，而不是盲目调阈值。

📧 收信的三种姿势

装好之后，客户端接入比想象中简单：

• 浏览器直接用：https://mail.yourdomain.com/SOGo，SOGo Webmail 开箱即用，日历和通讯录也一起给你了；
• IMAP/SMTP 客户端：Outlook、Thunderbird 等主流客户端都支持自动发现，填邮箱和密码就能连上（IMAP:993，SMTP:587）；
• 手机/Exchange 协议：SOGo 提供 ActiveSync 接口，手机当 Outlook 用。

🩺 常见坑位与排查路径

收不到外部邮件？十有八九在 DNS，按顺序检查：MX 记录是否指向mail.yourdomain.com、SPF 是否声明了发信 IP、DKIM 公钥是否已发布。Web 界面的域名详情页有 DNS 检测按钮，先让它告诉你缺哪条。

Web 界面打不开？三步定位：

docker compose ps docker compose logs --tail=50 nginx-mailcow

再看服务器防火墙是否放行 443/80。绝大多数"打不开"是容器没起来或端口没放行，而不是程序本身的问题。

忘了管理员密码？项目内置了重置脚本，一行命令搞定：

./helper-scripts/mailcow-reset-admin.sh

内存被 ClamAV 吃光？2.5GB 以下的机器记得在mailcow.conf里设SKIP_CLAMD=y后重启容器，杀毒扫描是内存大户。

📅 备份与升级：两个脚本管全年

邮件服务器的长期风险不在部署，而在"出事能不能恢复"和"版本能不能跟上"。mailcow 把这两件事都收敛到了 helper-scripts/ 目录：

备份：

./helper-scripts/backup_and_restore.sh backup all /backup/dir

建议写进 crontab 每天凌晨跑一次，备份物包含数据库、所有配置和mailcow.conf。恢复时把backup换成restore即可——先恢复到一个临时目录验证，再上生产，这是官方文档反复强调的做法。

升级：拉取新版后执行./update.sh，脚本会自动拉取镜像、重启容器并迁移配置。升级前养成"先备份"的肌肉记忆。社区的新代码在合并进稳定版之前，会先被切到 staging 分支做验证，这就是配置里让你选master而非nightly的原因——你日常用的是经过筛选的稳定代码：

每周 10 分钟例行清单：

• ✅docker compose ps确认全部容器健康
• ✅df -h看磁盘，Rspamd 与日志会缓慢增长
• ✅docker exec -it postfix-mailcow postqueue -p查看邮件队列，积压的邮件通常意味着某个域名 DNS 出了问题
• ✅ 确认当天备份任务成功生成

🏁 下一步做什么

到这里，你手上已经有一套能收发的邮件系统。建议接下来三周按这个节奏走：第一周把所有用户邮箱建齐、客户端连好；第二周过一遍隔离区里被判成垃圾的邮件，调教白名单，给重要发件人加 DKIM 验证；第三周演练一次"备份 → 恢复"，真的把恢复流程跑通一遍，而不是只相信备份文件存在。

记住：部署只是开始，mailcow.conf和定期备份才是你的保命符——改完默认密码的这一刻，你的邮件服务器才算真正上岗。

【免费下载链接】mailcow-dockerizedmailcow: dockerized - 🐮 + 🐋 = 💕项目地址: https://gitcode.com/GitHub_Trending/ma/mailcow-dockerized