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…

这是什么?这是一个基于 Cloudflare 免费套餐的自托管临时邮箱服务:你可以在自己的域名上创建一次性邮箱地址,接收邮件(包括附件),通过 SMTP/Resend 发送邮件,并通过现代化的网页界面、Telegram 机器人或管理后台管理全部内容。
这是注册就能用的托管服务,还是要部署自己的实例?你需要在自己的 Cloudflare 账户(Workers、Pages、D1、R2)上部署自己的实例。它利用 Cloudflare 的免费服务零成本运行,而不是第三方托管的产品。
怎么让它运行起来?按照项目的 'Quick Start' 部署文档操作。文档会逐步指导你部署 Worker 后端、将 Vue 前端部署到 Cloudflare Pages,以及把 D1 数据库部署到你自己的 Cloudflare 账户中(同时也提供了 GitHub Actions 部署指南)。
部署前我需要准备什么?需要一个 Cloudflare 账户,用来托管 Pages 前端、Workers 后端、D1 数据库、KV/R2 存储和 Email Routing;另外还需要你自己的域名,用于创建临时邮箱地址。
部署时有哪些需要注意的坑?通过 Resend 为三级域名(a.b.com)添加 DNS 记录时,必须删除 Resend 自动生成的多余子域名前缀,否则验证会失败,因为最终会生成 a.b.b.com。
有用来管理收件箱的手机应用吗?有一个社区开发的配套应用 'CloudMail'(基于 Expo/React Native),目前支持 Android,提供管理后台、地址管理、收件箱和已发送视图,以及一键复制验证码功能,并且兼容本项目的 API。
我的邮件数据究竟存放在哪里?所有数据都存放在你自己的 Cloudflare 账户中:Cloudflare D1(SQLite)是主数据库,附件存储使用 KV 和 R2(或 S3),不会发送到项目维护者的基础设施。
自动识别验证码的功能是如何工作的?借助 Cloudflare Workers AI 自动扫描收到的邮件,提取验证码、确认链接和服务链接,无需手动查找。
AI 智能体能直接使用这个邮箱吗?可以。项目内置了 'cf-temp-mail-agent-mail' 技能,AI 智能体可以通过程序读取和管理临时邮箱。
它能和 Telegram 集成吗?完整支持 Telegram 机器人,包括新邮件推送通知,还有可以直接在聊天中管理邮箱的 Telegram 小程序。
为什么邮件解析这么可靠?邮件解析使用 Rust 编译的 WASM 模块完成。项目称它能成功解析基于 Node.js 的解析器无法处理的邮件,同时速度非常快。
Size
11.4 MB
Stars
12K
Age
3y
Commits · 90 Days