📌 项目地址:dreamhunter2333/cloudflare_temp_email | ⭐ 10,754 颗星 | 🔧 TypeScript | 📜 未标注
这个项目能解决什么问题?
无论是注册临时服务、调试邮件发送功能,还是保护真实邮箱不被骚扰,临时邮箱都是刚需。但市面上大多数临时邮箱要么有广告、要么限制收发、要么域名被频繁拉黑,而且数据安全掌握在别人手里。
dreamhunter2333/cloudflare_temp_email 是一个基于 Cloudflare 免费服务(Workers + D1 + R2 等)构建的完整临时邮件系统。你能自己搭建、自己管理域名,邮件全部存在你自己的 Cloudflare 账户里,成本几乎为零(免费额度足够个人使用)。它支持收发附件、SMTP/IMAP 协议、Telegram Bot 通知,甚至内置了 AI 自动提取验证码和认证链接。
项目当前在 GitHub 上已有 10754 个 Star,主要语言为 TypeScript,后端邮件解析使用 Rust WASM(WebAssembly),性能远超 Node.js 纯解析方案。
实际用法:快速体验与自部署
在线体验:官方提供了演示站点 https://mail.awsl.uk/,你可以直接打开页面,生成一个随机邮箱地址并接收测试邮件。体验不需要任何注册,完全匿名。
自部署:项目提供了两种主要方式:
- GitHub Action 一键部署:fork 仓库后,配置 Cloudflare 账户的 API Token,在 Actions 中触发 workflow 即可自动构建前后端并部署到 Workers。具体步骤见 GitHub Action 部署文档。
- 手动部署:需要自己准备 Cloudflare Workers + D1 数据库 + R2 对象存储(附件),然后按照官方部署文档配置。完整指引参考 部署文档。
使用方式:部署完成后,你可以生成任意 yourname@yourdomain.com 格式的邮箱地址。前端界面支持:
- 查看收件列表、阅读邮件内容、下载附件
- 设置邮箱地址独立密码,增强安全性(防止他人登录你的临时邮箱)
- 使用 SMTP/IMAP 协议通过标准邮件客户端管理邮箱(需要配置,见项目文档)
- 集成 Telegram Bot 接收新邮件通知
对于 AI Agent 的扩展:项目内置了邮箱 skill 描述文件 skills/cf-temp-mail-agent-mail/SKILL.md,方便 AI agent 调用邮箱 API 收发邮件。开发者可以直接将临时邮箱能力嵌入自己的 AI 应用。
和同类临时邮箱工具的区别
大多数临时邮箱方案(如 10分钟邮箱、Guerrilla Mail 等)存在以下局限:
- 域名受限:域名被广泛封禁,很多网站拒绝注册。
- 功能单一:仅支持网页收件,不支持发送、不支持 SMTP/IMAP。
- 隐私风险:邮件数据存储在第三方服务器,服务方可能查看或滥用。
- 性能和兼容性:部分邮件(含复杂 HTML、特殊附件)解析失败。
而这个项目的独特优势:
- 完全自建,域名自主:你用自己的域名(Cloudflare 托管),可以随时更换,不被通用黑名单影响。
- Rust WASM 解析邮件:实测兼容性极高,即使 Node.js 解析模块失败的邮件也能处理。
- AI 邮件识别:利用 Cloudflare Workers AI 自动从邮件正文中提取验证码、认证链接、服务链接,方便自动化处理。
- 地址密码:每个邮箱可设独立密码,适合多人共用一个域名时隔离访问。
- 零成本入门:Cloudflare Workers 免费计划每天 10 万请求,D1 免费 5GB 存储,R2 免费 10GB 存储,个人完全够用。
需要注意的事项
- 仅限学习与个人用途:项目 README 明确声明“请勿将其用于任何违法行为,否则后果自负”。自建临时邮箱依然要遵守当地法律,尤其注意不要用于批量注册虚假账号等违规操作。
- 依赖 Cloudflare 生态:部署前你需要有一个 Cloudflare 账号,并且域名托管在 Cloudflare。如果你不熟悉 Workers、D1 等概念,学习成本会稍高,但官方文档写得比较清楚。
- 免费额度有上限:虽然大部分个人用例不会被收费,但如果产生高频率邮件收发(尤其是附件存储),可能超出 R2 或 Workers 免费额度。建议监控使用量。
- SMTP/IMAP 需要额外配置:项目支持 SMTP 与 IMAP 协议,但需要你自行配置邮件发送路由(例如使用 Cloudflare Email Routing 或第三方 SMTP 服务)。详细配置请参考项目文档。
- 客户端支持:社区开发了 Android 客户端 CloudMail,但 iOS 和桌面端暂无官方客户端,需要通过网页或标准邮件客户端(如 Thunderbird)使用。
总的来说,这个项目是追求自主可控、希望低成本搭建临时邮件服务的不错选择。如果你对 Cloudflare Workers 有一定了解,并且需要一个功能完整、可定制、高性能的临时邮箱系统,值得尝试。