Mailhub OSS 开源了：从下载到跑起来

Mailhub OSS 已经开源了，仓库地址是 github.com/moneychen003/mailhub-oss。这篇不是宣传稿，而是给想自己部署的人留一份从下载到跑起来的说明。

它是什么

Mailhub 是一个可自托管的 AI 邮件工作流系统。它不是普通网页邮箱，而是把 IMAP、自有域名收信、Postgres、AI 分类摘要、回复、定时发送、规则、模板、Telegram 提醒和诊断面板串成一个工作台。

• 适合多邮箱、多域名、catch-all 地址统一管理。
• 适合把订单、账单、客户邮件、风控提醒自动分类。
• AI Provider 可以自己配置，支持 OpenAI / Anthropic 兼容端点。
• 数据放在自己的 Postgres，原始邮件和附件也归自己管。

去哪里下载

最直接的方式是打开 GitHub 仓库，点 Code 下载 ZIP；如果你熟悉命令行，直接 clone：

1. 打开 https://github.com/moneychen003/mailhub-oss
2. 点击 Code，可以 Download ZIP，也可以复制 git 地址。
3. 服务器上执行：git clone https://github.com/moneychen003/mailhub-oss.git
4. 进入目录：cd mailhub-oss

最快跑起来

项目里准备了一键 bootstrap，适合先在本机或测试服务器跑通。默认公开地址可以先用本地地址，后面再换成你的域名：

1. 确认机器装好 Docker 和 Docker Compose。
2. 执行：bash scripts/bootstrap.sh http://localhost:3024
3. 打开 http://localhost:3024
4. 如果脚本生成了管理员密码，它会打印并写入 .env；如果没有，就打开 /setup 创建第一个管理员。

正式部署前读这几个文件

如果你准备用 AI 工具帮你部署，先让它读 README.md、SELF_HOSTING.md、.env.example、docker-compose.yml 和 DEPLOY.md。不要把真实邮箱密码、AI Key、Telegram Bot Token 直接丢给公共聊天窗口。

• README.md：项目定位、功能和快速开始。
• SELF_HOSTING.md：生产环境、域名、SMTP、IMAP、AI、Telegram 和备份。
• .env.example：需要准备哪些环境变量。
• docker-compose.yml：服务组成、端口、数据卷和启动顺序。
• DEPLOY.md：部署后的检查步骤。

怎么用

跑起来以后，先完成初始化管理员，然后进 Settings。你可以先配置 IMAP 拉取一个已有邮箱，这样不需要马上折腾域名 MX；等系统确认好用，再配置自有域名收信、SMTP 发信、AI Provider 和 Telegram 推送。

1. Settings -> Domains：配置公开访问地址和收信域名。
2. Settings -> IMAP：先接一个已有邮箱做测试。
3. Settings -> AI Provider：填自己的模型端点和 Key，用来摘要、分类和提取行动项。
4. Settings -> Telegram：可选，用来推高优先级提醒。
5. Settings -> Diagnostics：最后看数据库、目录、SMTP、IMAP、AI 队列是否正常。

开源版和我自用版的边界

公开仓库是可自托管版本，重点是把通用能力整理干净；我自己线上还有一些个人域名、历史邮件、业务规则和私有数据，这些不会放进仓库。公开体验也只放安全 Demo，不暴露真实生产邮箱。

这也是我做这个项目的原因：传统邮箱只解决收发，Mailhub 想解决的是“邮件如何变成业务流”。订单、账单、物流、客户消息、安全提醒，本质上都不是孤立邮件，而是一件件需要被理解和处理的事情。