Cloudflare 临时邮箱 — 零成本自建临时邮件服务

场景切入：当注册平台需要「用完即弃」的邮箱

在互联网注册账号、领取优惠券、参加限时活动时，你是否曾经纠结：留下真实邮箱怕骚扰，不留又无法验证？传统的临时邮箱工具虽然能解决问题，但你是否担心过平台封禁、数据泄露，或者服务突然关停？

Cloudflare 临时邮箱（cloudflare_temp_email）让这一切变得不同——它是一个完全开源、功能完整、可自主部署的临时邮件服务解决方案。用户只需一个 Cloudflare 账号，即可在其全球 CDN 边缘网络上，零成本运行一个属于自己的临时邮箱服务。

背景故事：从个人工具到万人追捧的开源项目

这个项目由开发者 dreamhunter2333 创建，最初是为了解决自己在使用各类网站时的隐私保护需求。项目基于 Cloudflare Workers 和 Cloudflare Pages 构建，利用 Cloudflare 提供的免费额度和全球分布式网络，实现了无需购买服务器即可运行的临时邮件服务。

截至目前，该项目已在 GitHub 上获得 9700+ Stars，被 HelloGitHub 收录推荐，社区开发了 Android 客户端 CloudMail，形成了完整的开发生态。

类比理解：把 Cloudflare 打造成「私人邮件中转站」

如果把互联网邮箱比作「收件箱」，那么这个项目就是在 Cloudflare 的基础设施上，搭建了一个可以随时创建、随时销毁的「临时信箱」。

整套架构完全运行在 Cloudflare 的全球边缘网络上，无需自建服务器，成本为零：

• Cloudflare Workers = 后端处理逻辑（接收邮件、存储数据）
• Cloudflare D1 = 数据库（存放邮件记录、用户信息）
• Cloudflare Pages = 用户界面（网页前端）
• Cloudflare Email Routing = 邮件路由（接收发往临时域名的邮件）
• Cloudflare KV / R2 = 文件存储（邮件附件）
• Rust WASM 邮件解析 = 邮件解析引擎（快速准确地提取邮件内容）

核心功能详解

邮件收发：不止于「收到就行」

项目支持完整的邮件接收和发送功能。邮件接收端通过 Cloudflare Email Routing 自动接收发往临时域名的邮件，存入 D1 数据库；邮件发送则支持 SMTP 和 Resend 两种方式，并支持 DKIM 验证，发出的邮件送达率更高。

项目使用 Rust WASM 编译的 mail-parser-wasm 模块解析邮件，这是整个项目最具技术含量的部分之一。相比 Node.js 原生方案，Rust WASM 在邮件解析速度和成功率上都有显著提升，作者在文档中明确提到「几乎所有邮件都能解析，Node 解析失败的邮件，Rust WASM 也能解析成功」。

AI 加持：让临时邮箱更聪明

项目深度集成了 Cloudflare Workers AI，能够自动识别邮件中的验证码、认证链接、服务链接等关键信息。用户无需逐字阅读邮件内容，AI 直接帮你提炼出最重要的信息，大幅提升使用效率。

认证体系：完整的用户管理系统

这不仅是「一个生成临时地址的网页工具」，项目提供了完整的用户认证体系：

• JWT 凭证：登录后自动保存邮箱地址，下次直接恢复
• OAuth2 第三方登录：支持 GitHub、Authentik 等平台一键登录
• Passkey 无密码登录：使用 WebAuthn 标准，安全便捷
• 用户角色管理：支持多角色域名和前缀配置（如 VIP 用户、普通用户）
• 访问密码保护：可设置站点密码，将服务设为私人使用

Telegram Bot：消息推送与移动管理

项目内置 Telegram Bot 功能，支持实时邮件通知。当新邮件到达时，Bot 自动推送消息到用户的 Telegram，还支持 Telegram MiniApp（小程序），用户可以在 Telegram 内完成所有邮箱操作，无需打开网页。

SMTP/IMAP 代理：传统邮件客户端也能用

smtp_proxy_server 模块提供了完整的 SMTP 发送 和 IMAP 查看 能力。用户可以使用任意邮件客户端连接这个代理服务收发临时邮箱邮件。该模块提供 Dockerfile 和 docker-compose.yaml，支持一键容器化部署。

Agent 友好：AI Agent 的邮件工具箱

项目内置了专门为 AI Agent 设计的 cf-temp-mail-agent-mail skill，AI Agent 可以直接调用邮箱功能：在注册平台时让 Agent 自动生成临时邮箱、收取验证码、自动填写——整个注册流程可以由 Agent 自动完成，无需人工介入。

上手门槛评估

基础部署（适合普通用户）

项目提供了 GitHub Actions 自动化部署方案，用户只需配置好 Cloudflare 账号和必要的 API 密钥（通过 GitHub Secrets），推送代码后自动完成 Workers 和 Pages 的部署。文档详细，步骤清晰，有动手能力的用户 30-60 分钟可以完成。

SMTP Proxy 单独部署（简单，推荐尝鲜）

如果只需要 SMTP/IMAP 功能，无需部署整套 Cloudflare 栈，使用项目提供的 docker-compose.yaml 即可一键启动 Python SMTP 代理服务，技术门槛最低。

全功能部署（适合开发者）

涉及 Cloudflare D1 数据库初始化、KV/R2 存储配置、Email Routing 域名验证、Workers 环境变量配置等，需要对 Cloudflare 产品有一定了解，部署复杂度较高。

技术架构解析

前端：Vue 3 + Vite + TypeScript

前端使用 Vue 3 搭配 Vite 构建工具，采用 TypeScript 开发。UI 框架使用 Naive UI（Vue 3 组件库），编辑器使用 WangEditor（富文本邮件内容展示），国际化方案使用 vue-i18n，支持中英文切换。项目还引入了 FingerprintJS 做浏览器指纹识别、WebAuthn 浏览器扩展做 Passkey 登录、PWA 支持离线访问。

后端：Cloudflare Workers + TypeScript

Worker 是整个系统的核心，处理所有 API 请求、邮件存储、用户认证等逻辑。采用 TypeScript 开发，模块化组织（admin_api、mails_api、user_api、telegram_api 等子模块）。

邮件解析：Rust WASM

mail-parser-wasm 是独立维护的子模块，使用 Rust 编写邮件解析逻辑，通过 wasm-pack 编译为 WebAssembly，供 Worker 和前端共同使用。

数据库：Cloudflare D1

数据库 Schema 包含 users、addresses、mails、blacklist、settings 等核心表，并通过持续的 migration 脚本管理 Schema 演进。

争议与局限

1. Cloudflare 平台依赖：整个服务深度绑定 Cloudflare 生态，若 Cloudflare 服务条款变更或免费额度调整，项目可用性将受影响。

2. 临时域名合规性：使用 Cloudflare 临时域名提供邮件服务，需确保符合各大邮件服务商的反垃圾邮件政策，否则发出的邮件可能被标记。

3. 数据持久性：D1 免费版有存储上限（25MB/数据库），用户量增长后需要升级付费计划或做数据清理策略。

4. 安全边界：临时邮箱的本质决定了其安全隔离程度有限，不应存储敏感信息。

行业意义

随着用户隐私意识提升和数据泄露事件频发，「可抛弃式邮箱」的需求持续增长。该项目将原本需要自建服务器的邮件服务，通过 Serverless 架构实现了零成本运营，降低了个人隐私保护工具的门槛。其「Agent 友好」的设计理念——让 AI Agent 直接调用邮箱功能——代表了 AI 时代工具设计的新趋势，即工具不仅要为人服务，更要为 AI Agent 服务。