mirror of https://github.com/dreamhunter2333/cloudflare_temp_email.git synced 2026-05-06 20:32:55 +08:00

Files

dreamhunter2333 2e32cf472b feat: add cf-temp-mail-usage skill and parsed mail API for AI agents

- feat: new /api/parsed_mails and /api/parsed_mail/:id endpoints returning
  server-parsed subject/text/html/attachments metadata (reuses commonParseMail)
- feat: add .claude/skills/cf-temp-mail-usage read-only skill so AI agents
  (OpenClaw / Codex / Cursor) can consume a mailbox with a user-supplied JWT,
  bypassing the Turnstile challenge required for mailbox creation
- refactor: split mails_api/index.ts and admin_api/index.ts into thin route
  shells; move business logic into dedicated *_api.ts files
- docs: update README / README_EN / CHANGELOG with agent-email feature and
  npx degit install instructions for the skill

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

2026-04-21 13:36:15 +08:00

11 KiB

Raw Blame History

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

中文文档 | English Document

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

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

完全免费 - 基于 Cloudflare 免费服务构建，零成本运行
高性能 - Rust WASM 邮件解析，响应速度极快
现代化界面 - 响应式设计，支持多语言，操作简便
地址密码 - 支持为邮箱地址设置独立密码，增强安全性 (通过 ENABLE_ADDRESS_PASSWORD 启用)

部署文档 - 快速开始

部署文档 | Github Action 部署文档

更新日志

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

在线体验

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

服务状态监控（点击收缩/展开）


Backend
Frontend

Star History（点击收缩/展开）

目录（点击收缩/展开）

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

核心功能

核心功能详情（点击收缩/展开）

邮件处理

使用 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 友好：提供服务端解析的 /api/parsed_mails / /api/parsed_mail/:id，配合仓库内的 cf-temp-mail-usage skill，OpenClaw / Codex / Cursor 等 AI agent 可直接使用用户提供的 JWT 读取验证码 / 链接，无需在客户端引入 MIME 解析器

给 AI Agent 使用：`cf-temp-mail-usage` skill

仓库内置一个只读 skill：.claude/skills/cf-temp-mail-usage/，让 AI agent 用用户提供的 Address JWT + API 地址直接消费邮箱（列出邮件 / 取单封 / 轮询验证码），规避前端创建邮箱时的 Turnstile 人机验证。

安装到当前项目的 Claude Code：

# 方式 1：degit 拷贝子目录
npx degit dreamhunter2333/cloudflare_temp_email/.claude/skills/cf-temp-mail-usage .claude/skills/cf-temp-mail-usage

# 方式 2：安装到全局
npx degit dreamhunter2333/cloudflare_temp_email/.claude/skills/cf-temp-mail-usage ~/.claude/skills/cf-temp-mail-usage

细节见 .claude/skills/cf-temp-mail-usage/SKILL.md。

技术架构

技术架构详情（点击收缩/展开）

系统架构

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

提醒

在Resend添加域名记录时，如果您域名解析服务商正在托管您的3级域名a.b.com，请删除Resend生成的默认name中二级域名前缀b，否则将会添加a.b.b.com，导致验证失败。添加记录后，可通过

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

进行验证。

11 KiB Raw Blame History Unescape Escape