在尝鲜各种 AI 新工具、体验各类新产品功能,或是运行自动化测试脚本时,如果你既想痛快体验完整功能,又想保护个人隐私、防止主力邮箱被骚扰和泄露,那么最离不开的基础设施之一就是临时邮箱。
过去很长一段时间,技术圈里最主流的自建临时邮箱方案是基于 Cloudflare 的开源项目 cloudflare_temp_email。它确实好用,但有一个避不开的门槛:你必须自备一个专属域名。不仅每年要掏域名续费的真金白银,还要在 Cloudflare 控制台折腾复杂的 DNS 记录、Email Routing 路由转发以及 Workers/D1 数据库绑定。
现在,连买域名的钱都可以省了!
基于网易推出的 claw.163.com 邮箱服务,开源了一个邮箱管理利器 ------
项目的核心优势在于:它原生提供了与 cloudflare_temp_email 完全兼容的 API 接口,无需任何自有域名,即可无缝平替 cloudflare_temp_email 作为临时邮箱使用!

核心亮点:完美平替 cloudflare_temp_email
很多开发者在日常开发中已经习惯了使用各种基于 cloudflare_temp_email 规范构建的自动化插件和脚本。
以往你得:
- 去注册一个独立域名(哪怕便宜的顶级后缀每年也得几十块);
- 托管到 Cloudflare 并配置复杂的 MX、SPF 邮件解析;
- 部署 Worker 和前端。
而使用 ClawEmail,这一切得到了极大简化:
- 零域名成本 :直接利用网易官方提供的
claw.163.com免费二级邮箱前缀体系,无限派生子邮箱(形如yourname.1@claw.163.com); - 无缝接口兼容 :底层 100% 兼容
cloudflare_temp_email的 REST API 交互规范; - 即插即用平替 :所有原本依赖
cloudflare_temp_email的第三方插件、自动化脚本、CI/CD 流程,只需将接口地址(Base URL)和 API 鉴权密码替换为本项目地址,即可直接跑通,下游客服端完全无感知!
你只需要在 doudou-ClawEmail 中登录你的邮箱,开放外部通信即可。

而且后台提供了非常直观的 Web UI:
- 验证码一键安全登录网易 Claw,无需泄露任何密码;
- 支持自由创建任意后缀的子邮箱(如
prefix.1、prefix.user2); - 实时查看监听状态、一键差量同步收件箱。
不止于临时邮箱:强大的子邮箱一体化管理矩阵
除了作为 cloudflare_temp_email 的完美临时邮箱替代品,本项目本身还是一个生产级的子邮箱全生命周期管理系统:
| 核心能力 | 详细特性 |
|---|---|
| 安全无感绑定 | 仅需邮箱 + 验证码即可完成 Claw 绑定,自动派生 Workspace Cookie 与 API Key,凭据安全存入本地 SQLite / D1,不接触网易账户密码。 |
| 毫秒级实时收信 | 后端为每个活跃子邮箱维持专属 WebSocket 长连接,新邮件秒级入库,并通过 SSE(Server-Sent Events)实时推送到 Web 前端。 |
| 完整收发信能力 | 支持以任意子邮箱身份在线发信、带引用快速回信、流式下载大附件,并且删除邮件时支持"远端 + 本地"双向彻底删除。 |
| 通讯规则精细化 | 可单独为每个子邮箱配置内部/外部通信权限及黑白名单规则,防骚扰防封禁。 |
| 双模部署形态 | 既支持本地/私有服务器(Docker/Node.js)长连接全功能部署,也支持 Cloudflare Workers + D1 无服务器极简部署。 |

极速部署指南
本项目支持两种主流部署方式,丰俭由人:
方式一:Docker Compose 一键启动(推荐私有服务器)
如果你有一台吃灰的轻量服务器或 NAS,推荐使用 Docker 方式部署,享受毫秒级 WebSocket 常驻长连接:
bash
# 1. 克隆项目
git clone https://github.com/undsky/doudou-ClawEmail.git
cd doudou-ClawEmail
# 2. 配置环境
cp .env.example .env
# 修改 .env 中的 ADMIN_PASSWORD 作为你的管理员访问密码
# 3. 一键拉起
docker compose up -d
启动后直接浏览器访问 http://你的服务器IP:3000 即可进入管理面板。
方式二:Cloudflare Workers 零成本无服务器部署
如果你完全没有云服务器,项目贴心内置了 Cloudflare Worker + D1 数据库版本:
- Fork 本仓库到个人 GitHub 账号;
- 登录 Cloudflare 控制台,进入
Workers & Pages->Create application->Import a repository导入仓库; - 在 Cloudflare 中创建免费的 D1 数据库
clawemail并绑定; - 设置环境变量
ADMIN_PASSWORD即可完成上线!

真正的0 域名费 + 0 服务器费,打造全天候可用的临时邮箱中枢。