cloudflare_temp_email README

The project's README from github.com/dreamhunter2333/cloudflare_temp_email. As one markdown file: README.md.

Cloudflare 临时邮箱 - 免费搭建临时邮件服务

docs MIT License GitHub contributors GitHub top language

Featured|HelloGitHub

中文文档 | English Document | 日本語ドキュメント

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

一个功能完整的临时邮箱服务!

部署文档 - 快速开始

部署文档 | Github Action 部署文档

Deploy to Cloudflare Workers

更新日志

查看 CHANGELOG 了解最新更新内容。

在线体验

立即体验 → https://mail.awsl.uk/

服务状态监控(点击收缩/展开)
Backend Deploy Backend Production
Frontend Deploy Frontend
Star History(点击收缩/展开) Star History Chart
目录(点击收缩/展开)

核心功能

核心功能详情(点击收缩/展开)

邮件处理

  • 使用 rust wasm 解析邮件,解析速度快,几乎所有邮件都能解析,node 的解析模块解析邮件失败的邮件,rust wasm 也能解析成功
  • AI 邮件识别 - 使用 Cloudflare Workers AI 自动提取邮件中的验证码、认证链接、服务链接等重要信息
  • 支持为指定基础域名创建随机二级域名邮箱地址,更适合收件隔离场景
  • 支持发送邮件,支持 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 人机验证
  • 限流配置,防止滥用
  • Agent 友好:内置 cf-temp-mail-agent-mail skill,AI agent 可直接消费邮箱,详见 文档
  • 社区移动端管理客户端:CloudMail 基于 Expo / React Native,面向本项目兼容 API,提供 Android 管理员后台、地址管理、收件/发件/未知邮件、验证码快捷复制、OLED 黑主题和本地分组。

技术架构

技术架构详情(点击收缩/展开)

系统架构

  • 数据库: 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 文档站点

提醒

nslookup -qt="mx" a.b.com 1.1.1.1

进行验证。

加入社区

cloudflare_temp_email (dreamhunter2333/cloudflare_temp_email)

Searching Database…

What is this?A self-hosted temporary email service built on Cloudflare's free tier: create disposable email addresses on your own domain, receive mail (with attachments), send mail via SMTP/Resend, and manage everything through a modern web UI, Telegram bot, or admin console.
Is this a hosted service I just sign up for, or do I deploy my own instance?You deploy your own instance on your own Cloudflare account (Workers, Pages, D1, R2) — it runs at zero cost on Cloudflare's free services rather than being a third-party hosted product.
How do I get it running?Follow the project's 'Quick Start' deployment doc, which walks through deploying the Worker backend, the Vue frontend to Cloudflare Pages, and the D1 database to your own Cloudflare account (a GitHub Actions deployment guide is also provided).
What do I need before deploying this?A Cloudflare account to host the Pages frontend, Workers backend, D1 database, KV/R2 storage, and Email Routing — plus your own domain for the temp-mail addresses.
Any deployment pitfalls to watch out for?When adding DNS records through Resend for a 3-level domain (a.b.com), you must delete the extra subdomain prefix Resend auto-generates, or verification will fail because it ends up creating a.b.b.com instead.
Is there a mobile app for managing my inbox?There's a community-built companion app called 'CloudMail' (Expo/React Native) for Android that provides an admin backend, address management, inbox/sent views, and one-tap verification-code copying, compatible with this project's API.
Where does my email data actually live?Everything is stored in your own Cloudflare account: Cloudflare D1 (SQLite) is the main database, with KV and R2 (or S3) used for attachment storage — nothing is sent to the project maintainers' infrastructure.
How does the automatic verification code detection work?Cloudflare Workers AI is used to automatically scan incoming emails and extract verification codes, confirmation links, and service links without manual searching.
Can AI agents use this mailbox directly?Yes — the project ships a built-in 'cf-temp-mail-agent-mail' skill so AI agents can read and manage the temp mailbox programmatically.
Does it integrate with Telegram?It has full Telegram Bot support, including push notifications for new mail and a Telegram mini-app for managing the mailbox directly in chat.
Why is the email parsing so reliable?Mail parsing is done with a Rust-compiled WASM module, which the project says can successfully parse emails that Node.js-based parsers fail on, while staying very fast.
Size
11.5 MB
Stars
12K
Age
3y
Commits · 90 Days