TimeAmber
剪藏#几乎满级#剪藏

一套完全托管在 Cloudflare Workers + D1 之上的开源临时邮箱/域名邮箱解决方案

2025 年 8 月 30 日 约 1 分钟
分享Twitter / XTelegram微博

**声明：**该公众号分享的工具和项目均来源于网络，仅供安全研究与学习之用，下载试用后请24小时内删除，不得用于任何商业用途。如用于其他用途，由使用者承担全部法律及连带责任，与工具作者和本公众号无关。

临时邮箱

freemail 一个基于 Cloudflare Workers 和 D1 数据库的开源临时邮箱服务，支持现代化界面、多用户管理和权限系统、实时邮件接收与发送（via Resend），并提供随机邮箱生成、历史记录、智能验证码提取和批量批量发信、定时/取消 等功能；无需服务器、无需备案，域名解析 + 5 个环境变量即可上线。

Notion image

Notion image

Notion image

诞生背景

痛点

  • • 公共临时邮箱常被滥用、广告轰炸；传统临时邮箱服务（如 10 Minute Mail）依赖中心化服务器，存在隐私泄露风险、访问延迟和域名限制，无法自定义域名或持久化历史记录；

  • • 自建 Postfix/Dovecot 配置复杂、成本高。

目标

  • • 构建一个零配置、低成本的临时邮箱系统，100 % Serverless，只依赖 Cloudflare，全球加速；

  • • 三分钟完成部署，十分钟完成域名级邮箱；

  • • 同时支持 临时收件 + 域名发件 + 权限隔离。

功能速览

  • • 现代化界面

  • • 毛玻璃效果（Glassmorphism）设计，浅色背景与动态渐变，视觉美观；• 响应式布局，完美适配桌面和移动端；• 平滑动画和微交互反馈，提升用户体验。

  • • 邮箱管理

  • • 随机生成临时邮箱地址，支持自定义长度和域名（多域名逗号分隔）；• 自动保存历史记录，便于重复使用；• 支持删除单个邮箱或批量管理；• 一键切换邮箱，置顶功能（V2 起）。

  • • 用户管理

  • • 三层权限模型：严格管理员（全权）、高级用户（部分管理）、普通用户（基本使用）；• 用户列表查看：用户名、角色、邮箱上限/已用、发件权限、创建时间；• 查看/分配邮箱：批量分配（多行粘贴，格式校验），一键复制；• 创建/编辑/删除用户：改名、重置密码、角色切换、权限调整；• 前端防护：快速鉴权、二次确认弹窗、Toast 反馈。

  • • 邮件功能

  • • 实时接收邮件，支持 HTML/纯文本渲染；• 自动刷新：选中邮箱后每 8 秒检查新邮件；• 智能预览：提取并高亮验证码，一键复制；• 详细查看：完整内容渲染；• 删除：单个邮件或清空邮箱；• 发件支持（Resend 集成）：自定义显示名（fromName），批量/定时/取消发送，查看发件记录（发件箱）。

安装 部署

    1. 二进制/部署推荐

  2. • 使用 Wrangler CLI：安装 npm i -g wrangler，登录 wrangler login；• 创建 D1：wrangler d1 create temp-mail-db，绑定 wrangler.toml；• 设置变量：wrangler secret put ADMIN_PASSWORD 等（Secrets），[vars] 配置 MAIL_DOMAIN 等；• 本地开发：wrangler dev；• 线上部署：wrangler deploy，或 Cloudflare Dashboard 连接 GitHub 仓库（Variables 配置变量）；• 初始化 D1：wrangler d1 execute TEMP_MAIL_DB --file=./d1-init-basic.sql（若未自动创建）。• 邮件路由：Cloudflare Email Routing 添加 Catch-all 规则，目标 Worker。• 自定义域名：Worker 设置中添加，或用 workers.dev。

    1. 源码构建

  4. • 克隆 git clone https://github.com/idinging/freemail.git；• 编辑 wrangler.toml 和变量；• 运行 wrangler dev/deploy。

    1. 更新

  6. • Git pull 拉取最新；重新 deploy；静态缓存需 Purge Everything。

使用流程

    1. 部署后访问 Worker URL 或自定义域名；
    1. 登录：输入用户名（默认 admin）和密码（ADMIN_PASSWORD），获取 JWT；
    1. 生成邮箱：点击随机生成，支持自定义；历史记录自动保存；
    1. 接收邮件：选中邮箱，每 8 秒刷新，查看列表/详情，复制验证码；
    1. 管理用户：严格管理员进入“用户管理”，创建/编辑用户，分配邮箱；
    1. 发件：配置 RESEND_API_KEY 后，输入内容发送，支持批量/定时；查看发件箱；
    1. 删除/清空：单个或批量操作邮件/邮箱。

典型场景

  • • 临时注册：生成邮箱接收验证码，避免隐私泄露；

  • • 域名营销：批量发信 + 定时取消，配合 Resend 统计 ；

  • • 团队协作：管理员创建用户，分配权限/邮箱；

  • • 内容分享：发件推广，查看记录。

项目信息速览

Notion image

Notion image

Notion image

Notion image

freemail 以 Cloudflare 为基石，提供模块化临时邮箱服务，结合高颜值界面和多用户管理，实现安全高效的邮件接收/发送，零服务器、零维护、开源部署简单。

原文地址: https://mp.weixin.qq.com/s?__biz=MzkwODQzNzk1OQ==&mid=2247489926&idx=1&sn=c2450244e1b3c19a0d6ccfcd435389f2&chksm=c101bdbf195dd13963cbedf9cee27e51ef460dfc5c13d4662eb0db88ef4e50cf8cc97f71b0ff&mpshare=1&scene=1&srcid=0830YaqmzZcFrgD2Atp6GMnm&sharer_shareinfo=1e97b987f9abcfa6a6c3314a0e014d29&sharer_shareinfo_first=1e97b987f9abcfa6a6c3314a0e014d29#rd

相关文章