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 и не является сторонним хостируемым продуктом.
Как его запустить?Следуйте документу проекта «Быстрый старт» по развёртыванию: в нём описано, как развернуть бэкенд на Worker, фронтенд на Vue в Cloudflare Pages и базу данных D1 в вашем аккаунте Cloudflare (также есть руководство по развёртыванию через GitHub Actions).
Что нужно иметь перед развёртыванием?Аккаунт Cloudflare, на котором будут размещены фронтенд Pages, бэкенд Workers, база данных D1, хранилище KV/R2 и Email Routing, а также собственный домен для адресов временной почты.
Есть ли подводные камни при развёртывании, на которые стоит обратить внимание?При добавлении DNS-записей через Resend для домена третьего уровня (a.b.com) нужно удалить лишний префикс поддомена, который Resend создаёт автоматически. Иначе проверка не пройдёт, так как в итоге создастся запись a.b.b.com.
Есть ли мобильное приложение для управления моим почтовым ящиком?Есть приложение-компаньон «CloudMail» (Expo/React Native) для Android, созданное сообществом. Оно предоставляет панель администратора, управление адресами, просмотр входящих и отправленных писем и копирование кода подтверждения одним касанием. Совместимо с API этого проекта.
Где на самом деле хранятся мои письма?Всё хранится в вашем аккаунте Cloudflare: основная база данных — Cloudflare D1 (SQLite), а для вложений используются KV и R2 (или S3). Ничего не отправляется на инфраструктуру сопровождающих проекта.
Как работает автоматическое определение кода подтверждения?Для автоматического сканирования входящих писем и извлечения кодов подтверждения, ссылок для подтверждения и ссылок на сервисы без ручного поиска используется Cloudflare Workers AI.
Могут ли ИИ-агенты напрямую пользоваться этим почтовым ящиком?Да: в проекте есть встроенный навык «cf-temp-mail-agent-mail», с помощью которого ИИ-агенты могут программно читать и управлять временным почтовым ящиком.
Есть ли интеграция с Telegram?Да, есть полная поддержка Telegram-бота, включая push-уведомления о новых письмах, а также мини-приложение Telegram для управления почтовым ящиком прямо в чате.
Почему разбор писем так надёжен?Разбор писем выполняется модулем WASM, скомпилированным из Rust. По словам авторов проекта, он успешно разбирает письма, с которыми не справляются парсеры на базе Node.js, и при этом работает очень быстро.
Size
11.5 MB
Stars
12K
Age
3y
Commits · 90 Days