cloudflare_temp_email/README.md

使用 cloudflare 免费服务，搭建临时邮箱

🇨🇳 中文 | 🇺🇸 English

本项目仅供学习和个人用途，请勿将其用于任何违法行为，否则后果自负。

一个功能完整的临时邮箱服务，基于 Cloudflare 免费服务构建，支持邮件收发、用户管理、多语言界面等丰富功能。

查看部署文档

Github Action 部署文档

CHANGELOG

在线体验

Backend
Frontend

• 使用 cloudflare 免费服务，搭建临时邮箱
  • 查看部署文档
  • CHANGELOG
  • 在线体验
  • 功能
    • 📧 邮件处理
    • 👥 用户管理
    • 🔧 管理功能
    • 🌐 多语言与界面
    • 🤖 集成与扩展
  • Reference
    • 🏗️ 架构设计
    • 🛠️ 技术栈
    • 📦 主要组件
  • Join Community

功能

📧 邮件处理

• 使用 rust wasm 解析邮件，解析速度快，几乎所有邮件都能解析，node 的解析模块解析邮件失败的邮件，rust wasm 也能解析成功
• 支持发送邮件，支持 DKIM 验证
• 支持 SMTP 和 Resend 等多种发送方式
• 增加查看 附件 功能，支持附件图片显示
• 支持 S3 附件存储和删除功能
• 垃圾邮件检测和黑白名单配置
• 邮件转发功能，支持全局转发地址

👥 用户管理

• 使用 凭证 重新登录之前的邮箱
• 添加完整的用户注册登录功能，可绑定邮箱地址，绑定后可自动获取邮箱JWT凭证切换不同邮箱
• 支持 OAuth2 第三方登录（Github、Authentik 等）
• 支持 Passkey 无密码登录
• 用户角色管理，支持多角色域名和前缀配置
• 用户收件箱查看，支持地址和关键词过滤

🔧 管理功能

• 完整的 admin 控制台
• admin 后台创建无前缀邮箱
• admin 用户管理页面，增加用户地址查看功能
• 定时清理功能，支持多种清理策略
• 获取自定义名字的邮箱，admin 可配置黑名单
• 增加访问密码，可作为私人站点

🌐 多语言与界面

• 前后台均支持多语言
• 现代化 UI 设计，支持响应式布局
• 支持 Google Ads 集成
• 使用 shadow DOM 防止样式污染
• 支持 URL JWT 参数自动登录

🤖 集成与扩展

• 完整的 Telegram Bot 支持，以及 Telegram 推送，Telegram Bot 小程序
• 添加 SMTP proxy server，支持 SMTP 发送邮件，IMAP 查看邮件
• Webhook 支持，消息推送集成
• 支持 CF Turnstile 人机验证
• 限流配置，防止滥用

Reference

🏗️ 架构设计

• 数据库: Cloudflare D1 作为主数据库
• 前端部署: 使用 Cloudflare Pages 部署前端
• 后端部署: 使用 Cloudflare Workers 部署后端
• 邮件转发: 使用 Cloudflare Email Routing

🛠️ 技术栈

• 前端: Vue 3 + Vite + TypeScript
• 后端: TypeScript + Cloudflare Workers
• 邮件解析: Rust WASM (mail-parser-wasm)
• 数据库: Cloudflare D1 (SQLite)
• 存储: Cloudflare KV + R2 (可选 S3)
• 代理服务: Python SMTP/IMAP Proxy Server

📦 主要组件

• Worker: 核心后端服务
• Frontend: Vue 3 用户界面
• Mail Parser WASM: Rust 邮件解析模块
• SMTP Proxy Server: Python 邮件代理服务
• Pages Functions: Cloudflare Pages 中间件
• Documentation: VitePress 文档站点

Join Community

• Telegram