热门标签
热门文章
- 1RabbitMQ技术问答系列-NO2_rabbitmq 重复投递重复消费
- 2【风电功率预测】多元宇宙算法优化卷积神经网络结合注意力机制的长短记忆网络MVO-CNN-LSTM-Attention风电功率时间序列预测【含Matlab源码 5207期】
- 3vue + element ui 实现侧边栏导航栏折叠收起_element ui 侧边栏菜单
- 4Tarjan 算法（超详细！！）_tarjan算法
- 5LeetCode第378题 有序矩阵中第K小的元素_有序矩阵寻找第k小
- 6Set 命令集学习
- 7单调栈与队列的概念与练习！【建议收藏】_队列面积
- 8springboot基于java的邮件收发管理系统毕业设计源码101025_邮件管理系统
- 9luci开发小插件_OpenWRT编译LUCI插件说明2018.11
- 10【已解决】“Content-Security-Policy”头缺失
当前位置: article > 正文
使用Docker部署mailcow开源邮件系统详细过程
作者：寸_铁 | 2024-08-17 03:16:29
赞
踩
mailcow
1. 项目介绍
项目网站：mailcow: dockerized – Blog
根据官方介绍，这个项目名称是mailcow，名称都是小写的。下面内容是通过AI翻译自官方文档：mailcow: dockerized documentation
mailcow: dockerized 是一个基于 Docker 的开源组件/电子邮件套件。mailcow 依赖于许多广为人知且长期使用的组件，这些组件结合起来构成了一个全方位的无忧电子邮件服务器。每个容器代表一个单一的应用程序，它们通过桥接网络连接在一起。
涉及的开源组件如下：
| 名称 | 说明 |
| ACME | 自动生成Let’s Encrypt SSL证书 |
| ClamAV | 反病毒引擎（可选） |
| Dovecot | IMAP/POP 服务器，用于通过集成的全文搜索引擎“Flatcurve”检索电子邮件 |
| MariaDB | 用于存储用户信息的数据库 |
| Memcached | 用于缓存SOgo webmail相关数据 |
| Netfilter | 类似Fail2ban的工具，由 @mkuron 提供 |
| Nginx | 提供web服务 |
| Olefy | 对Office文档进行病毒、宏等分析，主要和Rspamd搭配使用。 |
| PHP | 提供WEB相关运行环境 |
| Postfix | 提供MTA服务 |
| Redis | 用于存储反垃圾、DKIM key相关信息。 |
| Rspamd | 带有垃圾邮件自动学习功能的垃圾邮件过滤器 |
| SOGo | 一组提供CalDAV、CardDAV、ActiveSync服务的套件。 |
| Solr | （已弃用）（可选）为IMAP连接提供全文搜索功能，以便快速搜索电子邮件 |
| Unbound | 集成的DNS服务器，用于验证DNSSEC等 |
| Watchdog | 用于mailcow内容器状态的基本监控 |
但是，mailcow的核心是其图形化Web界面，即mailcow UI。它几乎提供了所有设置的地方，并允许用户通过几次点击轻松创建新的域名和电子邮件地址。
它也可以轻松完成其他或更复杂的任务：
- DKIM和ARC的支持/生成。
- 按域名和用户设置黑白名单。
- 按用户管理垃圾邮件评分（拒绝垃圾邮件、标记垃圾邮件、灰名单）。
- 允许邮箱用户创建临时垃圾邮件别名。
- 向主题添加电子邮件标签或将电子邮件移动到子文件夹（按用户）。
- 允许邮箱用户为入站和出站消息切换TLS强制执行。
- 用户可以在SOGo ActiveSync设备上重置缓存。
- 使用imapsync定期迁移或检索远程邮箱。
- 双因素认证（TFA）：Yubikey OTP、WebAuthn USB（仅限Google Chrome及其衍生产品）、TOTP。
- 添加白名单主机以将邮件转发到mailcow。
- 类似Fail2ban的集成。
- 隔离系统。
- 包括Office文档中的宏扫描在内的反病毒扫描。
- 集成的基本监控。
- 等等……
mailcow的数据（如邮件数据、用户数据等）存储在Docker的卷中，需要注意备份。涉及的卷名称如下：
- clamd-db-vol-1
- crypt-vol-1
- mysql-socket-vol-1
- mysql-vol-1
- postfix-vol-1
- redis-vol-1
- rspamd-vol-1
- sogo-userdata-backup-vol-1
- sogo-web-vol-1
- solr-vol-1
- vmail-index-vol-1
- vmail-vol-1
2.安装准备工作
参考：Prepare your system – mailcow: dockerized documentation
官方文档说的很详细，这里仅作概要说明。
2.1 最低配置要求
| 资源项 | 配置要求 |
| CPU | 1GHz |
| 内存 | 最小6GB + 1GB swap |
| 磁盘 | 最小20GB，邮件数据存储空间另算 |
| CPU架构 | x86_64, ARM64 |
仅支持运行在全虚拟化（如KVM、ESX,、Hyper-V 等）的服务器上，不支持半虚拟化环境（如OpenVZ、LXC等）。
2.2 操作系统要求
注：建议查询官方文档获取最新的兼容测试情况。
| 操作系统版本 | 兼容情况 |
| Debian 11, 12 | 完全兼容 |
| Ubuntu 20.04 – 24.04 | 完全兼容 |
| Alma Linux 8 | 完全兼容 |
| Rocky Linux 9 | 完全兼容 |
| Alpine since 3.17 | 兼容，但需要做一些手动调整 |
本文采用Rocky Linux 9作为安装演示。
2.3 网络端口要求
请参考官方文档：Prepare your system – mailcow: dockerized documentation
3.安装mailcow
3.1 安装docker
需要安装 Docker（版本要求 >= 20.10.2）和 Docker Compose（版本要求 >= 2.0）。
（1）安装yum源
cd /etc/yum.repos.d/# 采用阿里云的yum源
wget http://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo（2）安装docker
yum -y install docker-ce docker-ce-cli containerd.io（3）查看docker版本
- [root@mail ~]# docker -v
-
- Docker version 27.0.3, build 7d4bcd8
（4）设置docker开机自启动
systemctl enable --now docker（5）配置docker镜像加速站点
注意：目前国内的镜像加速站点在2024年之后基本上不好使了，这里给几个目前（2024年7月初）可用的加速站点。国内大概率会卡在这一步。
vim /etc/docker/daemon.json加入如下内容：
- {
- "registry-mirrors": [
- "https://dockerhub.icu",
- "https://docker.anyhub.us.kg",
- "https://hub.uuuadc.top",
- "https://dockerhub.jobcher.com",
- "https://docker.ckyl.me",
- "https://docker.awsl9527.cn"
- ]
- }
重启docker生效：
- systemctl daemon-reload
- systemctl restart docker
3.2 下载mailcow安装程序
- $ su
-
- # umask
-
- 0022 # <- Verify it is 0022
-
- # cd /opt
-
- # git clone https://github.com/mailcow/mailcow-dockerized
-
- # cd mailcow-dockerized
注意：如果访问不到github，需要考虑使用梯子。mailcow-dockerized目录非常重要，这里有所有配置文件信息，一定要保存好。
3.3 安装mailcow
（1）生成配置文件
- [root@mail mailcow-dockerized]# ./generate_config.sh
- Found Docker Compose Plugin (native).
- Setting the DOCKER_COMPOSE_VERSION Variable to native
- Notice: You´ll have to update this Compose Version via your Package Manager manually!
- Press enter to confirm the detected value '[value]' where applicable or enter a custom value.
- Mail server hostname (FQDN) - this is not your mail domain, but your mail servers hostname: mail.mailabc.cn
- Timezone [Asia/Shanghai]:
- Which branch of mailcow do you want to use?
-
- Available Branches:
- - master branch (stable updates) | default, recommended [1]
- - nightly branch (unstable updates, testing) | not-production ready [2]
- Choose the Branch with it´s number [1/2] 1
- 已经位于 'master'
- 您的分支与上游分支 'origin/master' 一致。
- Generating snake-oil certificate...
- .........
- -----
- Copying snake-oil certificate...
- Detecting if your IP is listed on Spamhaus Bad ASN List...
- Check completed! Your IP is clean
注意：上述采用mail.mailabc.cn作为访问域名，需要根据实际情况修改。
脚本最终生成mailcow.conf、docker-compose.yml以及各模块的相关配置，一定要保存好。
（2）执行命令拉取镜像
注意：这里根据网络情况，可能会拉取很慢，也可能会不成功。如果拉取不成功，需要检查docker镜像站点是否可用。命令需要在mailcow-dockerized目录下执行（主要是用来找配置文件）。
docker compose pull拉取成功后，大概可以看到下面这些镜像：
- [root@mail mailcow-dockerized]# docker images
- REPOSITORY TAG IMAGE ID CREATED SIZE
- memcached alpine 936dbfa3fd1a 8 days ago 15.7MB
- mailcow/phpfpm 1.88 f9d025710983 9 days ago 301MB
- mailcow/dovecot 1.30 2aca708281e0 10 days ago 251MB
- mailcow/solr 1.8.3 a77fb6cd923e 10 days ago 454MB
- mailcow/postfix 1.75 d13755c00185 11 days ago 335MB
- mailcow/dockerapi 2.08 adc1446be9a4 13 days ago 166MB
- mailcow/olefy 1.13 6572de3dccbb 13 days ago 112MB
- mailcow/watchdog 2.03 c801c70f93a6 13 days ago 117MB
- mailcow/acme 1.88 a97424882d9c 13 days ago 146MB
- mailcow/netfilter 1.59 59b514e53b6d 13 days ago 110MB
- mailcow/rspamd 1.96 f3ddc7d4a34a 13 days ago 184MB
- nginx mainline-alpine 099a2d701db1 2 weeks ago 43.2MB
- mariadb 10.5 8d27db214bfa 3 weeks ago 394MB
- mailcow/clamd 1.66 5b6dfc3668d8 4 weeks ago 78.8MB
- mailcow/unbound 1.22 8ccf6655d8aa 4 weeks ago 27.7MB
- mcuadros/ofelia latest 05600fa3b007 5 weeks ago 23MB
- redis 7-alpine 38a44d796822 6 weeks ago 40.7MB
- mailcow/sogo 1.123 f41cfca2cd8b 4 months ago 336MB
- robbertkl/ipv6nat latest b789d3355d66 2 years ago 18MB
（3）通过docker compose 部署
注意：docker compose 采用生成的配置docker-compose.yml 来部署容器。命令需要在mailcow-dockerized目录下执行（主要是用来找配置文件）。
docker compose up -d如果一切顺利，则容器会自动启动完成，输出大致如下：
- [root@mail mailcow-dockerized]# docker compose up -d
- [+] Running 20/20
- ✔ Network mailcowdockerized_mailcow-network Created 0.1s
- ✔ Container mailcowdockerized-netfilter-mailcow-1 Started 0.4s
- ✔ Container mailcowdockerized-olefy-mailcow-1 Started 0.8s
- ✔ Container mailcowdockerized-sogo-mailcow-1 Started 0.9s
- ✔ Container mailcowdockerized-memcached-mailcow-1 Started 0.6s
- ✔ Container mailcowdockerized-dockerapi-mailcow-1 Started 0.8s
- ✔ Container mailcowdockerized-unbound-mailcow-1 Healthy 43.2s
- ✔ Container mailcowdockerized-clamd-mailcow-1 Started 43.4s
- ✔ Container mailcowdockerized-mysql-mailcow-1 Started 1.0s
- ✔ Container mailcowdockerized-solr-mailcow-1 Started 0.8s
- ✔ Container mailcowdockerized-redis-mailcow-1 Started 0.9s
- ✔ Container mailcowdockerized-dovecot-mailcow-1 Started 1.4s
- ✔ Container mailcowdockerized-postfix-mailcow-1 Started 43.8s
- ✔ Container mailcowdockerized-php-fpm-mailcow-1 Started 1.1s
- ✔ Container mailcowdockerized-rspamd-mailcow-1 Started 1.6s
- ✔ Container mailcowdockerized-ofelia-mailcow-1 Started 1.7s
- ✔ Container mailcowdockerized-nginx-mailcow-1 Started 1.4s
- ✔ Container mailcowdockerized-acme-mailcow-1 Started 43.7s
- ✔ Container mailcowdockerized-watchdog-mailcow-1 Started 44.0s
- ✔ Container mailcowdockerized-ipv6nat-mailcow-1 Started 44.0s
注意：在我安装过程中，经常卡在mailcowdockerized-unbound-mailcow-1这个容器，经过分析发现这里对”1.1.1.1″ “8.8.8.8” “9.9.9.9”三个dns做ping检查，并且通过本机的dns检查”mailcow.email” “github.com” “hub.docker.com”这三个域名的解析情况。如果监测不通过，这个容器的状态就会变为不健康状态，导致后续依赖的容器启动异常。如果判断是这种问题，可以考虑检查本地网络环境是否对上述三个dns做了禁ping，可以考虑更换网络环境或者禁止检查dns状态。
启动完成后，检查容器状态如下：
- [root@mail mailcow-dockerized]# docker ps -a
- CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
- 2ce2db0778fa robbertkl/ipv6nat "/docker-ipv6nat-com…" 6 minutes ago Up 5 minutes mailcowdockerized-ipv6nat-mailcow-1
- a19056491f2f mailcow/watchdog:2.03 "/bin/sh -c /watchdo…" 6 minutes ago Up 5 minutes mailcowdockerized-watchdog-mailcow-1
- 89fa369acc2d mailcow/acme:1.88 "/sbin/tini -g -- /s…" 6 minutes ago Up 5 minutes mailcowdockerized-acme-mailcow-1
- e4eb3960e7ba nginx:mainline-alpine "/docker-entrypoint.…" 6 minutes ago Up 6 minutes 0.0.0.0:80->80/tcp, :::80->80/tcp, 0.0.0.0:443->443/tcp, :::443->443/tcp mailcowdockerized-nginx-mailcow-1
- ffbb6b64e962 mcuadros/ofelia:latest "/usr/bin/ofelia dae…" 6 minutes ago Up 6 minutes mailcowdockerized-ofelia-mailcow-1
- b56c8483c4eb mailcow/rspamd:1.96 "/docker-entrypoint.…" 6 minutes ago Up 6 minutes mailcowdockerized-rspamd-mailcow-1
- 30ac2cb92b0e mailcow/phpfpm:1.88 "/docker-entrypoint.…" 6 minutes ago Up 6 minutes 9000/tcp mailcowdockerized-php-fpm-mailcow-1
- c3040b9328d0 mailcow/dovecot:1.30 "/docker-entrypoint.…" 6 minutes ago Up 6 minutes 0.0.0.0:110->110/tcp, :::110->110/tcp, 0.0.0.0:143->143/tcp, :::143->143/tcp, 0.0.0.0:993->993/tcp, :::993->993/tcp, 0.0.0.0:995->995/tcp, :::995->995/tcp, 0.0.0.0:4190->4190/tcp, :::4190->4190/tcp, 127.0.0.1:19991->12345/tcp mailcowdockerized-dovecot-mailcow-1
- 50202b3fa87b mailcow/postfix:1.75 "/docker-entrypoint.…" 6 minutes ago Up 5 minutes 0.0.0.0:25->25/tcp, :::25->25/tcp, 0.0.0.0:465->465/tcp, :::465->465/tcp, 0.0.0.0:587->587/tcp, :::587->587/tcp, 588/tcp mailcowdockerized-postfix-mailcow-1
- 696102aefc50 redis:7-alpine "docker-entrypoint.s…" 6 minutes ago Up 6 minutes 127.0.0.1:7654->6379/tcp mailcowdockerized-redis-mailcow-1
- aec5fe15f87a mariadb:10.5 "docker-entrypoint.s…" 6 minutes ago Up 6 minutes 127.0.0.1:13306->3306/tcp mailcowdockerized-mysql-mailcow-1
- b2de735b4c1a mailcow/solr:1.8.3 "docker-entrypoint.s…" 6 minutes ago Up 6 minutes 127.0.0.1:18983->8983/tcp mailcowdockerized-solr-mailcow-1
- 18e99d4aaaa0 mailcow/clamd:1.66 "/sbin/tini -g -- /c…" 6 minutes ago Up 5 minutes (healthy) mailcowdockerized-clamd-mailcow-1
- 48956f071997 mailcow/olefy:1.13 "python3 -u /app/ole…" 6 minutes ago Up 6 minutes mailcowdockerized-olefy-mailcow-1
- e97d663039ae mailcow/dockerapi:2.08 "/bin/sh /app/docker…" 6 minutes ago Up 6 minutes mailcowdockerized-dockerapi-mailcow-1
- 356663b16ba2 mailcow/netfilter:1.59 "/bin/sh -c /app/doc…" 6 minutes ago Up 5 minutes mailcowdockerized-netfilter-mailcow-1
- 552b90c2f6b6 mailcow/unbound:1.22 "/docker-entrypoint.…" 6 minutes ago Up 6 minutes (healthy) 53/tcp, 53/udp mailcowdockerized-unbound-mailcow-1
- b9b40462fc5b memcached:alpine "docker-entrypoint.s…" 6 minutes ago Up 6 minutes 11211/tcp mailcowdockerized-memcached-mailcow-1
- a11204b27fa6 mailcow/sogo:1.123 "/docker-entrypoint.…" 6 minutes ago Up 6 minutes mailcowdockerized-sogo-mailcow-1
- [root@mail mailcow-dockerized]#
至此，安装完成。
3.4 登录入口
可以通过IP或者域名（前提是做了dns解析）访问，正常显示界面如下：
使用默认的管理员账号和密码登录（账号：admin，密码：moohoo），登录之后需要立即修改密码：
在这里可以设置域名、账号等等参数。
为了便于测试，我创建了一个邮件账号admin@mailabc.cn，登录webmail界面（入口是：https://domain/SOGo/）做一下邮件发送测试：
webmail登录界面：
登录之后界面如图：
其他功能，后续我们再做测试和介绍。
文章来源：使用Docker部署mailcow开源邮件系统详细过程 | MailABC邮件知识百科
更多内容，可以关注mailabc公众号。
声明：本文内容由网友自发贡献，不代表【wpsshop博客】立场，版权归原作者所有，本站不承担相应法律责任。如您发现有侵权的内容，请联系我们。转载请注明出处：https://www.wpsshop.cn/w/寸_铁/article/detail/990980
推荐阅读
相关标签
