Cloud Mail 是一套部署在 Cloudflare 上的自建域名邮箱:你可以用自己的域名开设多个邮箱,在网页里收发邮件、处理附件,再由管理员管理用户和使用权限。它把邮箱界面、账户管理和邮件处理放进一个项目,适合已经有域名、愿意自己维护服务的个人站长或小团队。收信、外发和附件存储需要分别配置、核算费用;尤其使用 Cloudflare 原生发信,需要 Workers Paid。

一个域名,多种邮箱用途
假设你持有 example.com,可以按用途创建不同地址,把项目通知、测试邮件和日常联系分开。Cloud Mail 提供收件箱、已发送、草稿和垃圾箱等网页邮箱界面,也支持发送邮件、抄送和密送。管理端能够管理用户、邮件、角色和资源限制,因此它不只是把来信转寄到另一个邮箱的路由规则。

对开发者更有用的是开放 API:可以批量创建用户、按条件查询邮件。它适合接入自己项目的测试或管理流程。收到邮件后,还能推送到 Telegram 机器人、通过 Webhook 通知其他服务,或者转发到其他邮箱;用到哪条链路,就配置哪条,不必把所有集成都打开。
收信、发信和附件怎么分工
Cloud Mail 的后端是 Workers 上的 Hono 服务,前端使用 Vue 3 和 Element Plus。日常看到的是网页邮箱,背后需要几种 Cloudflare 资源配合:
| 环节 | 由谁负责 | 部署时要核对什么 |
|---|---|---|
| 域名收信 | Cloudflare 邮件路由把邮件交给 Worker | 域名、邮件 DNS 与路由目标配置正确 |
| 网页与接口 | Workers 处理网站、API 和邮件逻辑 | 项目目录、自定义域名与环境变量 |
| 应用数据与缓存 | D1 数据库、KV | 分别绑定为 db、kv |
| 对外发信 | Cloudflare Email 或 Resend | 发送域名、服务权限及项目内的发送设置 |
| 邮件附件 | 默认 KV,可改用 R2 或其他 S3 协议存储 | 选择存储后配置相应绑定与容量 |
附件并非必须先开 R2。当前存储文档明确写的是默认使用 KV,改用 R2 时才创建桶并添加 r2 绑定。邮件量和附件变大后,存储方案会影响容量、操作次数和费用,应该一起考虑。

需要识别邮件中的验证码时,还可以调用 Workers AI。这个可选功能使用独立的 AI 服务额度,费用也要另算。
部署先准备这几样
官方提供控制台、GitHub Actions 和命令行三条部署路线。第一次接触这套项目,可以先看控制台路线:准备 Cloudflare 账号,将自己的域名接入 Cloudflare,把仓库 Fork 到自己的 GitHub 账号,再创建 Worker 并导入仓库。项目目录填写 mail-worker,前端由项目的构建配置打包。
导入并部署仓库后,继续添加自定义域名、环境变量和资源绑定。三个必填变量是:
domain:邮箱使用的域名,例如["example.com"],也可以配置多个域名。admin:管理员邮箱,例如admin@example.com。jwt_secret:JWT 签名密钥,使用独立的随机字符串并妥善保存。
D1 和 KV 的绑定名固定为 db、kv,不能只创建资源却漏掉绑定。接着按官方说明设置邮件路由、初始化数据库,并注册管理员账号。部署页面中的截图包含各个控制台入口,完整步骤在这里:https://docs.skymail.ink/deployment/dashboard.html 。如果还不熟悉 Workers、D1 和 R2 的区别,可以先看站内的 Cloudflare 资源介绍。
两条发信路线怎么选
Cloudflare Email:这条原生发信路线要求 Workers Paid。需要添加发送域名,再把电子邮件服务绑定到 Worker,绑定名称固定为 email;完成配置后,系统设置会开启 Cloudflare Email。已有付费 Workers 环境的人可以优先评估这条路线。
Resend:先在 Resend 添加发送域名并完成 DNS 验证,创建 API Key,再按文档配置发送状态回调,地址为自己 Worker 域名下的 /api/webhooks,最后填写 Cloud Mail 的系统设置。这里需要分别管理 Cloud Mail 本身和 Resend 的发送服务,Resend 的额度、费用及投递规则也要单独看。
收信成功不能证明发信也已经配好。部署完成后,至少检查下面三组结果:
- 从外部邮箱向自建地址发一封测试邮件,确认收件箱能看到正文;再发一封带附件的,检查能否下载。
- 从 Cloud Mail 向外部邮箱发信,核对对方实际收到的发件地址、正文和附件,并检查是否进入垃圾邮件。
- 分别使用管理员和普通用户账号,确认角色权限及发送、存储等使用限制符合自己的配置。
这些是部署后的验收项目。本文整理的是官方文档与仓库信息,未搭建实例,也未验证实际投递表现。
费用和维护别漏算
MIT 许可允许使用、修改和分发项目代码,但运行服务仍有成本:域名、Workers、D1、KV、附件存储,以及选用的发信和 AI 服务,都可能产生费用。是否落在免费额度内,要按实际用量和所选服务计算,不能把“开源邮箱”理解成“所有功能永久免费”。
如果使用 Workers 花费上限,也要知道触顶会暂停服务,而且它不覆盖 KV、R2 等产品。对邮箱来说,账单限制和服务可用性需要一起安排,相关设置见 Workers 花费上限的设置与触顶影响。
邮箱还会持续接触外部 HTML 内容,版本更新值得跟进。2026 年 11 月 12 日发布的 v3.5.0 新增抄送、密送和全局邮件搜索,同时修复了邮件 XSS 安全过滤漏洞。已有部署除了看新增功能,也应检查这类安全修复;自己的数据库、附件和配置则需要另行安排备份。
项目与使用入口
- 仓库:maillab/cloud-mail,MIT 许可,主要使用 JavaScript。
- 版本:本文于 2026-11-15 核对的最新正式版为 v3.5.0,发布于 2026-11-12。
- 发布记录:Cloud Mail Releases。
- 在线演示:https://skymail.ink ;部署文档:https://docs.skymail.ink/guide/quick-start.html 。
- 发信说明:https://docs.skymail.ink/sending/cloudflare.html 、https://docs.skymail.ink/sending/resend.html 。
- 附件存储说明:https://docs.skymail.ink/system/object-storage.html 。