Mail-in-a-Box v77 介绍与选型指南

目标：面向准备自托管邮件服务的读者，讲清 Mail-in-a-Box 是什么、由哪些组件构成、能做什么、不能做什么，并在与 Mailcow、docker-mailserver、Stalwart、Postal、Maddy、iRedMail 等同类自托管邮件组件的量化对比中给出选型建议。本文为认知与选型篇，全部事实性信息均溯源至官方渠道，查询日期为 2026-10-21，本地未做任何运行验证。

一、环境信息

本文是纯联网溯源的认知篇，不涉及本地运行验证。文中所有版本号、星数、发布日期、官方立场均来自下列来源，统一于 2026-10-21 查询：

• 官方网站与安装指南：https://mailinabox.email 、https://mailinabox.email/guide.html
• 官方代码仓库：https://github.com/mail-in-a-box/mailinabox （含 README.md、LICENSE、setup/ 安装脚本、api/mailinabox.yml OpenAPI 规范）
• 版本发布记录：https://github.com/mail-in-a-box/mailinabox/releases.atom （GitHub Releases Atom 订阅源）
• 社区热度数据：shields.io 提供的 GitHub 星标徽章（img.shields.io/github/stars/...）
• 站内同类组件专栏：Mailcow、docker-mailserver、Stalwart、Postal、Maddy、iRedMail（详见第七节对比表，均为已发布专栏，数据以各专栏成文时的实测版本为准）

二、软件概述

Mail-in-a-Box 的官方定义（摘自仓库 README，2026-10-21 查询）：

Mail-in-a-Box helps individuals take back control of their email by defining a one-click, easy-to-deploy SMTP+everything else server: a mail server in a box.

即：一个"开机即用"的邮件服务器整机方案——在一台全新的 Ubuntu 22.04 LTS 64 位机器上执行一条命令，脚本就会把 Postfix、Dovecot、Webmail、DNS、管理面板等一整套组件安装并配置完毕，产出一台可以直接收发邮件、拥有 Web 管理界面的邮件服务器。官方在 README 中强调它的两个鲜明特征：

• 一键装置（appliance）："It is a one-click email appliance. There are no user-configurable setup options."——没有面向用户的可配置安装选项，安装过程只询问邮箱地址、主机名、公网 IP 三个问题，其余全部自动决策。
• 明确不做的事：README 的目标清单里写明 "Not make a totally unhackable, NSA-proof server"、"Not make something customizable by power users"——它追求"简单、可靠、开箱即用"，而不是极致安全或极致可定制。

项目基本信息一览（来源见括号内标注，均为 2026-10-21 查询值）：

💡 说明：官方安装脚本 bootstrap.sh 里硬编码了版本映射——Ubuntu 22.04 机器安装 TAG=v77，Ubuntu 18.04 机器则回落到 v57a 并提示"支持即将结束，请尽快迁移到 22.04"。也就是说组件版本与操作系统版本是绑定的，这是整机式方案的典型做法。

三、核心架构

Mail-in-a-Box 的架构可以用一句话概括：用一份幂等的 Bash 脚本集，把十几个成熟开源组件装配到一台机器上，并用一个自研的 Python 管理守护进程统一驱动它们。以下架构事实均来自仓库源码目录结构（setup/、management/、tools/）与 README（2026-10-21 查询）。

3.1 安装流水线

安装入口是官方托管的一行命令（详见第五节），其背后是一条固定顺序的配置流水线，按 setup/start.sh 的调度依次执行（目录名为仓库 setup/ 下的实际脚本）：

3.2 组件矩阵

数据根目录固定为 STORAGE_ROOT=/home/user-data（默认值，安装问题阶段可沿用），邮件账号存于其中的 SQLite 数据库，证书、DKIM 密钥、DNSSEC 密钥、备份加密密钥、Nextcloud 数据等全部收敛在该目录下——这个设计让整机迁移简化为"备份/恢复一个目录"。

3.3 管理面：面板、API 与 CLI 三位一体

管理守护进程是整个方案的中枢，提供三种等价的管理入口（源码 management/daemon.py、management/cli.py、api/mailinabox.yml，2026-10-21 查询）：

1. Web 控制面板：https://<主机名>/admin，nginx 反代到本地守护进程，用管理员邮箱账号登录；
2. HTTP API：仓库随附 OpenAPI 3.0 规范（api/mailinabox.yml），40 个端点覆盖邮件用户、别名、DNS 记录、TLS 证书、系统状态、备份配置、MFA 等，Basic 认证；
3. 命令行：management/cli.py，本质是 API 的命令行薄封装，提供 user/alias 两族子命令。

此外守护进程每日凌晨执行 management/daily_tasks.sh：跑备份、跑全量状态检查（DNS/TLS/端口/黑名单/磁盘），有异常就发邮件给管理员——这是官方宣称 "comprehensive health monitoring" 的落地。

四、功能特性

以下特性清单摘自 README 与官方安装指南（2026-10-21 查询）：

• 完整邮件栈：SMTP 收发、IMAP 邮箱、Sieve 过滤规则、邮件客户端自动配置（autoconfig/autodiscover 记录由 nginx 提供）；
• 自动 DNS 安全记录：SPF、DKIM、DMARC、DNSSEC、DANE TLSA、MTA-STS、SSHFP 全部自动生成——这是它最突出的差异化能力，手工维护这些记录是自托管邮件最繁琐的部分；
• 全自动 TLS：Let's Encrypt 签发的证书覆盖 HTTPS、SMTP、IMAP 等全部服务；
• 反垃圾闭环：SpamAssassin 内容过滤 + postgrey 灰名单 + SPF/DKIM/DMARC 校验；
• 协作套件：Nextcloud 提供 WebDAV 文件、CalDAV/CardDAV 日历联系人，Z-Push 提供 Exchange ActiveSync 移动端推送；
• 运维自动化：每日健康检查（服务/端口/证书/DNS 记录/黑名单）、duplicity 加密增量备份、ufw 防火墙、fail2ban 爆破防护、munin 图形监控；
• 多域名与多账号：面板中可添加多个托管域名与不限量邮箱账号、别名，支持邮箱配额（quota）；
• 账号安全：支持 TOTP 双因素认证（MFA），API/面板登录均可启用；
• 国际化域名：支持 IDN 域名的简易配置（README 注明 SMTPUTF8 暂不支持）。

五、快速开始（最小可用示例）

官方推荐的安装方式只有一条命令（摘自官方安装指南 guide.html，2026-10-21 查询）：

curl -s https://mailinabox.email/setup.sh | sudo bash

执行后脚本依次询问三个问题：要管理的邮箱地址（如 me@example.com）、主机名（官方建议 box.example.com 风格，即"box."前缀 + 邮箱域名）、公网 IP（脚本会自动探测，NAT 环境下需手动确认）。安装完成后：

• 管理面板：https://box.example.com/admin（DNS 未生效前可用 https://<公网IP>/admin 访问，浏览器提示证书告警属正常）；
• 首个管理员账号即安装时填写的邮箱地址。

💡 说明：官方前提是"一台 100% 全新、独占的 Ubuntu 22.04 LTS 机器"。安装脚本会移除 apache2 等冲突服务、接管系统 DNS 与主机名，不适合与已有业务混装。完整的分步安装实录（含每一步真实命令回显与排障过程）见本专栏部署篇 《Ubuntu 22.04 安装 Mail-in-a-Box 指南》。

六、适用场景与限制

6.1 适合的场景

1. 个人或小团队的自有邮箱：想要 自己@自己的域名 的邮箱，且希望数据完全在自己手里——这正是项目 README 的第一句承诺；
2. 一台云主机跑齐全套：官网安装指南明确按"一台 24/7 在线的云虚拟机"设计，估算成本约 $12/月（2026-10-21 查询自 guide.html），家人朋友可共用分摊；
3. 讨厌手工调 DNS 记录：SPF/DKIM/DMARC/DNSSEC 全自动生成，对"照着文档逐条加 DNS 记录"深恶痛绝的用户收益最大；
4. 愿意把 DNS 托管交给盒子：官方指南建议让盒子接管域名 DNS（也可手工保持外部 DNS 并同步记录，但维护成本自担）。

6.2 明确的限制（官方立场）

七、同类选型对比

自托管邮件组件按形态可分四类：整机一键脚本（Mail-in-a-Box、iRedMail）、容器编排全家桶（Mailcow、docker-mailserver）、现代单二进制（Stalwart、Maddy）、专用投递 MTA（Postal）。下表为量化对比（星数为 shields.io 2026-10-21 查询值；版本为各组件本站专栏实测成文版本；形态与能力描述以各专栏实测为准）：

关键差异与选型建议：

• 要"最省心的一台机全家桶"：Mail-in-a-Box 与 iRedMail 同属整机脚本路线。Mail-in-a-Box 的自动化 DNS 安全记录与每日健康检查更彻底，但系统锁定 Ubuntu 22.04 且无组件可换；iRedMail 支持 Ubuntu/Rocky 双系、组件（SOGo/Roundcube/ClamAV 等）可选，灵活度更高。二者都要求独占整机。
• 要容器化、可与其他业务共存：选 Mailcow（面板精致、全家桶完整）或 docker-mailserver（无面板、轻量可控、社区星标最高）。本站两篇专栏均有从零部署实录。
• 要现代协议与低占用：Stalwart 单二进制内置 JMAP，是四类中架构最新的；Maddy 更轻但功能面窄。两者都没有 Nextcloud 式的协作套件。
• 要给应用发邮件（注册信/通知/营销）：这不是 Mail-in-a-Box 的赛道，选 Postal 这类专用投递平台。
• 公网 IP 信誉提醒（对所有自托管邮件组件一视同仁）：部署前先到 Spamhaus 等黑名单自查候选 IP，住宅宽带基本不可行；Mail-in-a-Box 会在安装阶段就替你把这道关。

八、参考链接

1. 官方网站：https://mailinabox.email
2. 官方安装指南：https://mailinabox.email/guide.html
3. 官方代码仓库：https://github.com/mail-in-a-box/mailinabox
4. 版本发布记录：https://github.com/mail-in-a-box/mailinabox/releases.atom
5. 官方 API 规范（OpenAPI 3.0）：https://raw.githubusercontent.com/mail-in-a-box/mailinabox/api-spec/api/mailinabox.yml
6. 官方讨论论坛：https://discourse.mailinabox.email/
7. 站内同族专栏：《Mailcow 2026-09a 介绍与选型指南》、《docker-mailserver 16.0.1 介绍与选型指南》、《Stalwart v0.16.26 介绍与选型指南》、《Postal 3.3.7 介绍与选型指南》、《Maddy 0.9.6 介绍与选型指南》、《iRedMail 1.8.8 介绍与选型指南》