如何在独立服务器上部署Mailcow邮件服务并验证收发信?

发布人:A5数据发布时间:2026-11-11 10:06阅读量:74

要在独立服务器上完成 Mailcow 的首次部署,关键不只是让容器启动,还要让域名正确指向服务器、取得可信证书,并用外部邮箱分别验证发信和收信。下面以一台新装的 Ubuntu 24.04 独立服务器、一个可管理 DNS 的域名为例;文中的 example.com、mail.example.com 和 203.0.113.10 都是示例,执行前必须替换为自己的域名和公网 IP。

实施顺序是:先确认服务器和邮件端口可用,再安装 Docker 与 Mailcow;随后配置 DNS、创建邮箱,最后做双向收发测试。若域名已有邮件业务,不要在测试成功前直接切换原有 MX 记录,否则新旧服务器之间可能出现邮件分流。

准备条件:先排除无法收发的基础障碍

Mailcow 是包含邮件传输、邮箱存储、Web 界面等组件的容器化邮件系统,不适合按单一 SMTP 服务的资源需求估算。其文档给出的默认配置最低资源为 6 GiB 内存加 1 GiB swap、20 GiB 不含邮件的磁盘空间;本文选择 Ubuntu 24.04,并要求 Docker Engine 不低于 24.0.0、Docker Compose 不低于 2.0。独立服务器应提供可持续使用的公网 IP,且具备修改该 IP 反向解析记录的途径。(docs.mailcow.email)

准备阶段逐项确认:

  • 主机与权限:能够以具有 sudo 权限的账号登录,保存好服务器快照或现有配置备份;下文安装软件、启动 Docker 均会改变主机状态。若机器已有网站或邮件服务,先确认是否允许它们与 Mailcow 共存。
  • 网络:公网入站 TCP 25 用于接收其他邮件服务器投递,80 用于默认证书申请,443 用于 Web 界面,587 用于客户端提交邮件,993 用于加密 IMAP。若使用 465,也需相应开放。出站至少要核实 TCP 25 能连接外部邮件服务器,同时保证镜像下载、证书申请和 DNS 查询所需网络可用。不要因为开放了 587,就误以为服务器能够向外部域名直投:两者用途不同。(docs.mailcow.email)
  • 端口与时间:在服务器上运行以下检查。ss 若显示 25、80、443 等端口已被其他程序监听,应先确定程序归属;不要为了安装 Mailcow 直接停掉生产服务。timedatectl 应显示时间同步正常。(docs.mailcow.email)
cat /etc/os-release
free -h
df -h /
timedatectl status
sudo ss -lntp

防火墙应同时核对服务商控制台的入站规则和主机规则。Docker 发布容器端口时,不能只凭主机防火墙的普通 INPUT 规则判断容器是否被限制;如需限制访问,应按 Docker 转发流量的方式设计规则,并从另一条公网网络实测。修改防火墙前保留现有规则和管理连接的恢复办法,避免把 SSH 一并切断。(docs.mailcow.email)

对于 Mailcow 这类同时运行邮件传输、邮箱存储和 Web 管理组件的服务,A5idc数据提供中国香港、美国、日本、新加坡等地区的物理服务器租用。不同系列配有相应的 CPU、内存及 SSD 或 NVMe 存储资源,为容器化邮件系统提供硬件基础;多地区的带宽与线路选择,也能配合面向不同地区团队或客户的邮件业务部署。

安装 Docker 与 Mailcow

1. 安装 Docker Engine 和 Compose

如果服务器已安装 Docker,先运行 docker version 和 docker compose version 核对版本;满足要求即可跳过安装,不必覆盖现有环境。新装 Ubuntu 24.04 可按 Docker 的 Ubuntu 软件仓库方式安装。以下命令会新增软件仓库、安装软件包并启动 Docker,应在确认主机没有冲突安装后执行;如安装失败,先检查 APT 输出,不要反复混用不同来源的 Docker 软件包。

sudo apt update
sudo apt install -y ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg \
  -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

sudo tee /etc/apt/sources.list.d/docker.sources >/dev/null <<EOF
Types: deb
URIs: https://download.docker.com/linux/ubuntu
Suites: $(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}")
Components: stable
Architectures: $(dpkg --print-architecture)
Signed-By: /etc/apt/keyrings/docker.asc
EOF

sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io \
  docker-buildx-plugin docker-compose-plugin
sudo systemctl enable --now docker
sudo docker version
sudo docker compose version

验证重点是客户端和服务端均能显示版本、docker compose version 能正常返回。若 docker version 只有客户端信息,先检查 sudo systemctl status docker,不要进入下一步。

2. 获取项目并生成配置

先安装 Mailcow 脚本所需工具,再从项目仓库获取部署文件。以下操作以 /opt/mailcow-dockerized 为工作目录;如果该目录已经存在,应先确认是否属于已有实例,不要对现有实例重新运行配置生成脚本,以免覆盖配置。(docs.mailcow.email)

sudo apt install -y git openssl curl gawk coreutils grep jq
cd /opt
sudo git clone https://github.com/mailcow/mailcow-dockerized
cd /opt/mailcow-dockerized
sudo ./generate_config.sh

脚本询问邮件服务器主机名时,填写 mail.example.com 这样的完整主机名,而不是单独填写邮箱域名 example.com;时区按实际所在地选择。脚本完成后检查生成结果,不要在文章示例之外猜测配置项名称:

cd /opt/mailcow-dockerized
sudo grep -E '^(MAILCOW_HOSTNAME|TZ|HTTP_PORT|HTTPS_PORT)=' mailcow.conf
sudo docker compose config --quiet

预期能看到正确的主机名和时区,且 docker compose config --quiet 不报告错误。mailcow.conf 含有服务凭据,应仅授权管理人员读取,不要把它贴到工单、公开代码仓库或聊天记录中。若主机名填错,先检查现有文件和备份,再按项目脚本提示处理;不要直接在已投入使用的实例上重新生成整份配置。

3. 拉取镜像并启动

在确认目标端口没有冲突后启动。首次拉取耗时取决于网络和镜像大小,不以命令返回速度判断部署是否成功。(docs.mailcow.email)

cd /opt/mailcow-dockerized
sudo docker compose pull
sudo docker compose up -d
sudo docker compose ps

docker compose ps 应显示主要服务已启动;部分服务可能还在初始化,稍后复查状态。如果出现端口绑定失败,先用 sudo ss -lntp 定位占用进程,再决定调整现有服务还是调整 Mailcow 的端口配置,不能仅靠重复运行 up -d 解决。

配置 DNS、证书和第一个邮箱

先在域名 DNS 管理处配置指向。下表仅表示只有这一台服务器负责该域名收发、且只使用所示 IPv4 发信的首次部署示例;如果原有业务还通过其他平台发信,SPF 必须先把那些合法发送来源一并纳入,不能照抄后直接覆盖。203.0.113.10 是文档示例地址,不能用于实际投递。Mailcow 主机名的 PTR 反向解析通常需在服务器或 IP 提供方处设置,不是在普通域名解析面板添加一条 PTR 即可完成。(docs.mailcow.email)

记录位置类型示例值首次部署的作用
mail.example.comA203.0.113.10将邮件主机名指向服务器
example.comMX优先级 10,目标 mail.example.com让外部服务器找到收信入口
服务器公网 IP 的反向解析PTRmail.example.com使反向名称与邮件主机名对应
example.comTXTv=spf1 ip4:203.0.113.10 -all在仅此 IPv4 发信的前提下声明授权来源
_dmarc.example.comTXTv=DMARC1; p=none初期观察认证结果,不立即按策略拒收
autodiscover.example.com、autoconfig.example.comCNAMEmail.example.com供支持的邮件客户端发现配置

如果服务器启用 IPv6,必须另外核对 IPv6 入站、出站及 PTR;不要在 IPv6 邮件链路尚未验证时贸然发布邮件主机的 AAAA 记录。DNS 生效后,在服务器和另一条网络上分别检查,避免只看到本地缓存:

dig +short A mail.example.com
dig +short MX example.com
dig +short -x 203.0.113.10
dig +short TXT example.com
dig +short TXT _dmarc.example.com

预期 A、MX 和 PTR 指向计划中的同一邮件主机。若 MX 仍指向旧服务器,外部来信可能继续投递到旧处;对正在使用的域名,应安排切换窗口,并保留旧系统到新系统的迁移或转投安排。

Mailcow 默认尝试为邮件主机名申请证书;添加邮件域后,还会检查可验证的 autodiscover、autoconfig 名称。确保相应 DNS 可解析、服务器 TCP 80 可从公网访问,再查看证书容器日志。浏览器仍提示不可信证书时,不要忽略警告并输入管理密码;先排查域名解析、80 端口和 ACME 日志。(docs.mailcow.email)

cd /opt/mailcow-dockerized
sudo docker compose logs --tail=100 acme-mailcow

通过可信 HTTPS 打开 https://mail.example.com/admin。Mailcow 安装文档列出的初始管理员账号为 admin、初始密码为 moohoo;首次登录后立即修改密码。随后在管理界面添加邮件域 example.com,创建测试邮箱,例如 test@example.com,并设置独立的强密码。接着在管理界面为该域生成 DKIM 记录,将界面给出的完整选择器名称与 TXT 值填入 DNS;不要将文章中的占位公钥当成真实密钥。(docs.mailcow.email)

双向验证收信和发信

容器正常、Web 页面可打开,只能证明部分服务可用。首次验收至少用一个由其他邮件服务提供的外部邮箱完成两次独立测试,并保留邮件主题、时间和发件人,方便对应日志。

双向验证收信和发信配图

  1. 验证收信:从外部邮箱发邮件到 test@example.com,登录 Mailcow Web 邮箱检查收件箱及垃圾邮件文件夹。收到邮件说明本次外部投递路径可用;若未收到,先从外部网络检查域名 MX 和服务器 TCP 25,再检查邮箱地址是否创建正确,最后看 Postfix 日志。
  2. 验证发信:从 test@example.com 发邮件到外部邮箱,确认对方收件箱或垃圾邮件文件夹实际收到。客户端如需单独配置,收件可使用 mail.example.com:993 的加密 IMAP,发件可使用 mail.example.com:587 并启用 STARTTLS、邮箱账号认证。587 是客户端向 Mailcow 提交邮件的端口,不替代服务器对外投递所需的出站连接。
  3. 验证身份认证:查看外部收到邮件的原始邮件头,核对 SPF、DKIM、DMARC 的结果,并确认其对应的是本域发信。单次邮件进入垃圾邮件箱,不等于 SMTP 投递失败;相反,日志显示对端接受,也不保证邮件一定进入对方收件箱。

可用以下命令辅助定位,但示例状态词只用于说明如何阅读结果,并非本次执行记录:

cd /opt/mailcow-dockerized
sudo docker compose ps
sudo docker compose logs --tail=150 postfix-mailcow dovecot-mailcow
dig +short TXT <管理界面显示的DKIM选择器>._domainkey.example.com

若 DKIM 查询为空,检查选择器名称是否与管理界面一致,以及 DNS 是否仍在传播。Postfix 日志中的 status=sent 通常表示远端服务器已接受该次 SMTP 投递,不能据此宣称对方用户已经读到邮件。

失败时按外到内排查

外部来信不到:先从外部网络查 MX、A 和 TCP 25 的可达性。MX 错误意味着来信可能根本没到这台服务器;MX 正确但 25 不通,应检查服务商入站策略、防火墙与端口监听;连接已到达而邮箱无信,再查 Postfix 日志中的拒收原因和邮箱配置。不要在未定位路径前反复重建容器。

失败时按外到内排查配图

可以收信但发不出去:先区分客户端提交失败和服务器外投失败。前者检查 587、TLS 设置及邮箱凭据;后者检查出站 TCP 25 是否受服务商限制、DNS 查询是否可用,再根据 Postfix 日志判断是连接超时、对方拒收还是进入队列。出站 25 被限制时,应向网络服务方确认政策,或评估合规的邮件中继方案;不要把放开本机入站规则当成解决办法。(docs.mailcow.email)

证书申请失败或服务未启动:分别查看 acme-mailcow 日志和 docker compose ps。证书问题优先检查主机名解析、公网 80 端口及网络规则;服务未启动则针对异常容器查看日志,并检查内存、磁盘和端口占用。不要通过长期跳过证书验证掩盖网络配置问题。(docs.mailcow.email)

验收与回滚检查项

  • 验收:DNS 的 A、MX、PTR 与计划一致;HTTPS 证书可信;管理员初始密码已修改;测试邮箱能登录;外部邮箱到本域、从本域到外部的两封邮件均实际收到;外发邮件头中的 SPF、DKIM、DMARC 结果已核对。只有容器显示运行,不算完成收发信验收。
  • 保留恢复点:在承载正式邮件前,保存 mailcow.conf、DNS 变更前的记录和服务器快照。开始产生真实邮件后,使用项目自带备份脚本备份数据,并将备份放在与邮件数据分离的位置;邮件数据及加密相关数据不能只靠复制部署目录保存。
cd /opt/mailcow-dockerized
sudo ./helper-scripts/backup_and_restore.sh backup all
  • 回滚:若只是首次测试失败、且尚未切换生产 MX,可停止本次实例,修正配置后再启动;docker compose down 会停止并移除本项目容器和网络,造成邮件服务中断,不要加 -v 删除数据卷。若已切换生产 MX,先确认新服务器上是否收到需保留的邮件并完成备份,再按变更前记录恢复 DNS、检查旧服务器能够接收邮件,并持续观察 DNS 缓存过渡期两边的收件情况。需要恢复 Mailcow 数据时,使用项目恢复脚本选择正确备份点,不要用空实例覆盖仍有邮件的卷。(docs.mailcow.email)

本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/8717.html

相关推荐

automatic widget is off in this experiment; direct consultation links above remain available. -->