GitHub热门项目!Cloud Mail,用Cloudflare免费搭建个人邮件服务

前言
嘿,小伙伴们!最近是不是经常遇到这样的困扰:想拥有一个专属的个人邮箱服务,但是传统的邮箱方案要么太贵,要么配置太复杂?作为一个爱折腾的开发者,我太懂这种感受了!曾经为了搭建一个简单的邮件服务,我研究了各种方案,最后要么因为成本太高放弃,要么因为配置繁琐半途而废。
直到最近发现了一个宝藏项目——Cloud Mail!这是一个专门为 Cloudflare Workers 设计的轻量级邮件服务,让我们可以用几乎零成本搭建自己的邮件系统。不用买服务器,不用配置复杂的环境,只要一个域名和 Cloudflare 账号,就能拥有属于自己的邮件服务。
这两天这个项目在开发者圈子里特别火,今天我就来手把手教大家怎么用 Cloudflare 部署这个项目,体验一下免费搭建邮件服务的快乐!

项目介绍
✨ 核心特性
- 🚀 零成本部署: 基于 Cloudflare Workers,免费额度完全够用,个人使用几乎零成本
- 🎯 多域名支持: 支持多个域名创建不同的邮箱地址,一套系统满足多种需求
- 💰 无限邮箱: 理论上可以创建无限个邮箱账号,告别邮箱数量限制
- 🔧 简单配置: 通过环境变量和 Web 界面即可完成配置,无需复杂命令
- 📦 开源免费: 完全开源,代码透明,社区活跃,更新频繁
🎯 应用场景
- 个人邮箱: 搭建专属的个人邮箱服务,告别商业邮箱的广告和限制
- 团队协作: 为小团队创建统一的邮箱系统,提升专业形象
- 项目邮箱: 为开源项目或个人项目创建专门的联系邮箱
- 隐私保护: 避免使用第三方邮箱泄露个人信息
部署实战
环境准备
首先,我们需要准备一个 Cloudflare 账号和一个已经接入 Cloudflare 的域名。如果你还没有域名,可以在 Cloudflare Registrar 购买一个,非常便宜。
登录 Cloudflare 后台,确认你的域名已经正确接入:

项目下载
首先,咱们去 GitHub 把项目克隆到自己的账号:

创建 Worker 项目
现在我们来创建 Cloudflare Worker 项目:
- 登录 Cloudflare 控制台,进入 Workers & Pages

- 点击 创建应用 → Pages → 连接到 Git

- 选择刚才 fork 的仓库,并设置目录为
mail-worker
设置环境变量
部署成功后,进入项目设置页面,添加以下环境变量:
| 变量名 | 必填 | 用途 | 示例 |
|---|---|---|---|
domain | ✅ | 邮箱域名,多个域名用数组 | ["example.com"] |
admin | ✅ | 管理员邮箱地址 | [email protected] |
jwt_secret | ✅ | JWT 密钥,随机字符串 | your-secret-key-123 |
project_link | ❌ | 是否显示项目链接 | true 或 false |
添加环境变量的界面:

绑定数据库
接下来需要创建并绑定数据库:
创建 KV 命名空间
- 进入 Workers & Pages → KV → 创建命名空间
- 命名为
cloud-mail-kv
创建 D1 数据库
- 进入 Workers & Pages → D1 → 创建数据库
- 命名为
cloud-mail-db
绑定到 Worker
- 进入项目设置 → 环境变量 → 绑定
- 添加 KV 绑定:
- 变量名:
kv(必须是这个名字) - 选择刚才创建的 KV 命名空间
- 变量名:
- 添加 D1 绑定:
- 变量名:
db(必须是这个名字) - 选择刚才创建的 D1 数据库
- 变量名:

设置自定义域名
为了让邮箱服务可以通过自定义域名访问,我们需要添加自定义域名:
- 进入项目设置 → 自定义域 → 添加自定义域
- 输入你的域名,比如
mail.example.com - 按照提示添加 DNS 记录

设置转发
- 进入域管理

- 设置电子邮件路由

初始化数据库
现在我们需要初始化数据库,在浏览器中访问:
https://你的自定义域名/api/init/你的jwt_secret替换成你自己的域名和 jwt_secret,访问后会看到成功提示:

注册管理员账号
打开浏览器访问你的自定义域名,会看到注册页面:
- 输入管理员邮箱(必须和环境变量中的 admin 一致)
- 设置密码
- 点击注册

登录系统
注册成功后,使用管理员账号登录:

添加邮箱用户
登录后,可以在管理界面添加邮箱用户:
- 点击左侧菜单的 用户管理
- 点击 添加用户
- 输入邮箱地址和密码(密码可不填,会自动生成)

测试发送邮件
添加用户后,我们可以测试发送邮件功能:
- 登录用户邮箱
- 点击 写邮件
- 输入收件人、主题和内容
- 点击发送

总结
今天主要带大家了解并实现了 Cloud Mail 的完整部署流程,该邮件服务以 “Cloudflare Workers + Hono” 为核心优势,结合个人邮箱需求,通过 Cloudflare 平台与 D1/KV 数据库,形成了一套从域名准备到邮件收发的全链路解决方案。通过这套实践方案,个人开发者能够高效突破传统邮箱服务的成本瓶颈——借助环境配置、数据库绑定、自定义域设置等操作(包括创建 Worker、配置环境变量、绑定 KV/D1、初始化数据库、注册账号),无需购买服务器或配置复杂环境,就能快速搭建专属邮件服务(如本次演示的 “个人邮箱系统”)。无论是多域名支持、无限邮箱创建,还是邮件收发、用户管理,都能通过简单的 Web 界面完成,极大降低了个人邮件服务的搭建门槛。在实际应用中,该服务不仅零成本运行,还具备良好的扩展性,适配性远优于传统的自建邮件服务器方案;特别是通过 Cloudflare 的全球 CDN 加速,有效解决了邮件传输延迟的难题。同时,方案具备良好的扩展性——小伙伴们可以基于此扩展更多应用场景,如团队协作邮箱、项目联系邮箱、隐私保护邮箱等,进一步发挥 Cloud Mail 在个人服务、团队协作、开源项目等领域的应用价值。感兴趣的小伙伴可以按照文中提供的步骤进行实践,根据实际需求类型调整域名配置和用户权限。今天的分享就到这里结束了,我们下一篇文章见。
项目资源
GitHub地址: https://github.com/maillab/cloud-mail
觉得项目不错的话,记得给作者点个 star 支持一下!
项目特色: 基于 Cloudflare Workers 的轻量级邮件服务,支持多域名、无限邮箱账号,零成本搭建个人邮件系统。
互动时间
你是不是已经跃跃欲试了?赶紧去 GitHub fork 这个项目,试试用 Cloudflare 免费搭建自己的邮件服务吧!
如果你在部署过程中遇到什么问题,或者有什么有趣的体验,欢迎在评论区和我交流。我会定期分享更多好用的开发工具和技术教程,记得关注我哦!
(注:文章部分信息来源于 cloud-mail 官网)
支持与分享
如果这篇文章对你有帮助,欢迎分享给更多人或打赏支持!
小王的博客














