hieunc229/mailflare

项目介绍

Mailflare 是一套自托管的协作套件，核心是自有域名邮箱，同时提供日历、预约（Booking）和文件存储（Drive）。目标用户是需要自己掌控邮箱和基础设施的专业人士和小团队，可以把它当作 Google Workspace 的替代品。应用可以运行在 Cloudflare Worker 上，也可以打包成单个 Docker 容器；邮件通过 Cloudflare Email、Resend 或 Amazon SES 收发，文件放在 R2、Backblaze B2 或 S3，数据库可选 Cloudflare D1、PostgreSQL、MySQL、Turso/libSQL 或本地 SQLite 文件（项目说明、技术说明）。

功能包括：个人或共享邮箱、路由规则（存储、转发、拒收、分类）、带时区和邮件邀请的重复日历事件、可公开分享的预约链接、文件存储与分享，以及用户、API Key、Webhook、审计日志和备份等管理能力；支持从 IMAP、Gmail Takeout、.eml 和 .mbox 导入邮件。内置 AI 代理可以搜索邮件、起草回复、管理日程，并可通过 MCP 接入其他 AI 工具。界面支持 34 种语言，包括从右到左书写的语言（功能列表）。

快速使用

README 给出的主路径是 Cloudflare 一键部署：

1. 点击 Deploy to Cloudflare，应用名保持 mailflare，README 明确说明改名会导致部署失败（部署入口）。
2. 创建限定权限的 Cloudflare API Token，并作为 Worker secret CF_TOKEN 配置。账户级需要 Email Sending:Edit、DNS Settings:Edit、Email Routing Addresses:Edit，区域级需要 DNS Settings:Edit、Email Routing Rules:Edit、Zone Settings:Edit、DNS:Edit（Token 权限讨论）。
3. 打开应用的 /setup 页面，创建管理员账户。
4. 从同一个 Cloudflare 账户接入域名，然后创建第一个邮箱。

如果用自己的服务器，Docker 方式是先 cp .env.docker.example .env.docker，再执行 docker compose up -d --build，得到使用 SQLite 和本地文件存储的单容器部署（Docker 说明）。本地开发则复制 .dev.vars.example 为 .dev.vars，依次运行 npm install、npm run db:migrate:local、npm run dev，打开 localhost:3000；npm run db:seed 可载入示例数据（本地开发）。更多细节见部署指南和自托管指南。

使用约束

• Cloudflare 部署需要 Cloudflare 账户，且域名要托管在该账户下，同时需要上文所述限定权限的 CF_TOKEN。
• 接收邮件使用 Cloudflare Email Routing 免费；发送使用 Resend 免费额度每月 3,000 封，或者 Amazon SES；Cloudflare 自带发送需要每月 5 美元的付费 Worker 计划；新 Amazon SES 账户处于沙箱状态，需申请生产权限（费用说明）。价格可能变动。
• 数据库通过 DATABASE_URL 选择；修改 schema 时需要为每种数据库类型分别编写迁移（迁移说明）。
• Docker 方式是轻量路径：单容器、SQLite 和本地文件，而不是一整套 Cloudflare 托管服务。
• 许可证为 AGPL-3.0（许可证）。

HotRepo 点评

2026-11-02，该项目进入 TypeScript 日榜第 12 名，当天新增 185 Star；仓库累计 5,465 Star、800 Fork。更早在 2026 年 5 月底，它以两次 Show HN 帖露面，其中一次标题为“self-hosted email, custom domain with Cloudflare”，讨论量不大。该帖里维护者回应“能否从论坛发邮件”的提问时表示可以增加发信 API，并反问对方希望怎样发送（讨论帖、回复）——这说明对外发信 API 目前被描述为一种可能的扩展，而不是已有文档化的功能。项目覆盖面很广（邮件、日历、预约、网盘、AI 代理），对采用者来说，真正需要确认的是在自己选定的后端上哪些部分能端到端跑通，而不是功能列表有多长。

定位与边界

项目明确对标 Google Workspace，比较对象自然是其他自托管邮件套件和托管版 Workspace。它不是给已有邮箱账号用的客户端，而是服务端、邮箱存储和 Web 应用的整体，收发信服务商需要自己接入。AI 代理是在邮件数据之上的一层便利功能，不是独立产品。