一个基于 Cloudflare Workers 和 D1 数据库的临时邮箱服务。

• 🌈 毛玻璃效果：采用现代化的毛玻璃（Glassmorphism）设计风格
• 🎯 简约美观：浅色背景，动态渐变，视觉效果出色
• 📱 响应式设计：完美适配桌面和移动设备
• ✨ 动画效果：平滑的过渡动画和微交互反馈

• 🎲 智能生成：随机生成临时邮箱地址，支持自定义长度和域名
• 📋 历史记录：自动保存历史生成的邮箱，方便重复使用
• 🗑️ 便捷删除：支持删除单个邮箱和批量管理
• 🔄 一键切换：快速在不同邮箱间切换

• 📧 实时接收：自动接收和显示邮件，支持HTML和纯文本
• 🔄 自动刷新：选中邮箱后每8秒自动检查新邮件
• 🔍 智能预览：自动提取和高亮显示验证码内容
• 📖 详细查看：优化的邮件详情显示，支持完整内容渲染
• 📋 一键复制：智能识别验证码并优先复制，或复制完整邮件内容
• 🗑️ 灵活删除：支持删除单个邮件或清空整个邮箱

• ⚡ 基于 Cloudflare：利用全球网络，访问速度快
• 💾 D1 数据库：可靠的数据存储，支持数据持久化
• 🔐 安全认证：内置登录系统，保护数据安全
• 🎯 API 完善：提供完整的 RESTful API 接口

##Cloudflare在线创建也可以

# 安装 Wrangler CLI
npm install -g wrangler

# 登录 Cloudflare
wrangler login

# 创建 D1 数据库
wrangler d1 create temp-mail-db

复制返回的数据库 ID，更新 wrangler.toml 文件：

main = "src/index.js"

[[d1_databases]]
binding = "TEMP_MAIL_DB"
database_name = "temp-mail-db"
database_id = "你的数据库ID"

[vars]
MAIL_DOMAIN = "你的域名.com，域名2.cn" #可以多个 以英文逗号分隔

1. 本地开发

npm i -g wrangler
wrangler login
# 可在 wrangler.toml 的 [vars] 中配置本地变量（仅用于 dev/deploy via wrangler）
wrangler dev

2. 线上部署

# 设置敏感变量（Secret）
wrangler secret put ADMIN_PASSWORD
wrangler secret put JWT_TOKEN
# 非敏感变量可放在 wrangler.toml 的 [vars] 或控制台 Variables 中
wrangler deploy

3. Cloudflare 连接github仓库部署

• 如果使用 Git 集成而非 wrangler deploy，请在 Dashboard → Workers → Settings → Variables 中手动配置上述变量
• [assets] 已指向 public/，静态页面由 Workers + Assets 提供

只要绑定了d1 默认可以自行创建，如果不能自动创建再手动创建

# 方式一：表结构
wrangler d1 execute TEMP_MAIL_DB --file=./d1-init-basic.sql

如果需要接收真实邮件，需要在 Cloudflare 控制台配置邮件路由：

1. 进入域名的 Email Routing 设置
2. 添加 Catch-all 规则
3. 目标设置为 Worker: temp-mail-worker

在 Worker 设置中添加自定义域名，或使用 workers.dev 子域名。

说明：规则按前缀匹配，命中第一个前缀即转发；* 为兜底规则。未配置或设置为空/disabled/none 时不进行任何转发。

• 逗号分隔（KV）：
  • FORWARD_RULES="vip=a@example.com,news=b@example.com,*=fallback@example.com"
• JSON 数组：
  • FORWARD_RULES='[{"prefix":"vip","email":"a@example.com"},{"prefix":"*","email":"fallback@example.com"}]'
• 仅指定某些前缀（无兜底）：
  • FORWARD_RULES="code=a@example.com,login=b@example.com"
• 禁用转发：
  • FORWARD_RULES="" 或 FORWARD_RULES="disabled" 或 FORWARD_RULES="none" 或 FORWARD_RULES="[]" 转发的目标地址需要在cloudfllare的电子邮件地址添加上

• GET /api/generate - 生成新的临时邮箱
  • 返回: { "email": "random@domain.com", "expires": timestamp }
• GET /api/mailboxes - 获取历史邮箱列表
  • 参数: limit（页面大小）, offset（偏移量）
  • 返回: 邮箱列表数组
• DELETE /api/mailbox/{address} - 删除指定邮箱
  • 返回: { "success": true }

• GET /api/emails?mailbox=email@domain.com - 获取邮件列表
  • 返回: 邮件列表数组，包含发件人、主题、时间等信息
• GET /api/email/{id} - 获取邮件详情
  • 返回: 完整的邮件内容，包括HTML和纯文本
• DELETE /api/email/{id} - 删除单个邮件
  • 返回: { "success": true, "deleted": true, "message": "邮件已删除" }
• DELETE /api/emails?mailbox=email@domain.com - 清空邮箱所有邮件
  • 返回: { "success": true, "deletedCount": 5, "previousCount": 5 }

• POST /api/session - 用户登录
  • 参数: { "password": "密码" }
  • 返回: JWT Token
• POST /api/logout - 用户退出
  • 返回: { "success": true }

• GET /api/domains - 获取可用域名列表
  • 返回: 域名数组

• 静态资源缓存：Workers + Assets 对静态文件可能有缓存。更新 index.html 后如未生效，请在 Cloudflare 控制台进行 Purge Everything，并在浏览器执行强制刷新（Ctrl/Cmd+F5）。
• 图标路径：favicon 建议使用相对路径（例如 favicon.svg），避免挂在子路径时 404。
• 邮件路由：若需接收真实邮件，请正确配置 Cloudflare Email Routing（MX 记录、Catch‑all → 绑定到 Worker）。
• 数据库与费用：D1 有免费额度限制；建议定期清理过期邮件以节省存储空间与额度。
• 安全：务必在生产环境修改 ADMIN_PASSWORD、JWT_TOKEN，并限制仓库/项目的敏感信息暴露。

可以通过修改 Worker 代码来自定义：

• 邮箱地址生成规则
• 邮件保存时间
• 界面样式（public/ 内的 HTML/CSS/JS）
• 功能扩展

1. 邮件接收不到

   • 检查 Cloudflare 邮件路由配置是否正确
   • 确认域名的 MX 记录设置
   • 验证 MAIL_DOMAIN 环境变量配置

2. 数据库连接错误

   • 确认 D1 数据库绑定名称为 TEMP_MAIL_DB
   • 检查 wrangler.toml 中的数据库 ID 是否正确
   • 运行 wrangler d1 list 确认数据库存在

3. 登录问题

   • 确认 ADMIN_PASSWORD 环境变量已设置
   • 检查 JWT_TOKEN 或 JWT_SECRET 配置
   • 尝试清除浏览器缓存和 Cookie

4. 界面显示异常

   • 确认静态资源路径配置正确
   • 检查浏览器控制台是否有 JavaScript 错误
   • 验证 CSS 文件加载是否正常

5. 自动刷新不工作

   • 确认已选中邮箱地址
   • 检查浏览器是否支持 Page Visibility API
   • 查看网络连接是否稳定

• 使用 wrangler dev 进行本地调试
• 查看 Worker 的实时日志：wrangler tail
• 使用浏览器开发者工具检查网络请求
• 检查 D1 数据库中的数据：wrangler d1 execute TEMP_MAIL_DB --command "SELECT * FROM mailboxes LIMIT 10"

• 微信：iYear1213

如果你觉得本项目对你有帮助，欢迎赞赏支持：

Apache-2.0 license