CloudMail 是一个面向 Cloudflare Temp Email / Cloudflare 临时邮箱 的 Android 管理端 App，基于 Expo / React Native 开发，主要适配 dreamhunter2333/cloudflare_temp_email 及其兼容 API。
上游项目提供 Cloudflare Worker 邮箱后端、Web 管理端和邮箱收发能力；CloudMail 则把这些能力整理成更适合手机使用的管理员客户端。它不是新的邮箱后端，也不是 Cloudflare 官方产品，而是围绕 cloudflare_temp_email 项目生态开发的移动端管理工具。
CloudMail 当前主流程是 管理员优先：首次启动进入管理员设置，配置并校验成功后直接进入管理员后台，普通用户欢迎页不再作为主入口。
V1.1.4 修复 #17 中部分中文邮件在 HTML 和纯文本模式下显示乱码的问题。
- 中文编码兼容：正确解析 GB2312、GBK、GB18030、Big5 等编码，覆盖邮件正文、主题、发件人名称和附件名称。
- 旧缓存自动修复：保留原文的邮箱缓存会重新解析，保留邮件标识和增量同步进度；无法恢复原文的管理员摘要会在联网刷新时重新获取。
- 回归验证：增加 Expo 原生解码环境下的多编码、附件和缓存迁移测试，防止同类乱码再次出现。
- Cloudflare Temp Email 移动管理员端：连接你的
cloudflare_temp_email兼容 Worker/API，在手机上管理临时邮箱系统。 - 多 Cloudflare 账号 / 多 Worker：本地保存多个 Worker 配置档案，适合账号 A 管
1.com / 2.com / 3.com、账号 B 管4.com / 5.com / 6.com这类部署。 - 域名自动路由：创建邮箱时按所选域名自动调用对应 Worker，减少手动切换和误操作。
- 管理员后台：统计、地址、收件、发件、未知收件和发送邮件集中管理。
- 用户维度管理：读取管理员用户列表，并查看某个用户名下绑定的邮箱地址。
- 邮箱地址管理：创建自定义邮箱、子域名邮箱、随机子域名邮箱，查看凭证、复制一键登录链接、清空收件箱、删除地址。
- 批量操作：可按当前筛选结果批量处理地址和地址下邮件，危险操作前提供预览与确认。
- 本地分组：给邮箱地址分组，并在地址和邮件列表中按分组筛选。
- 收件 / 垃圾信箱：在收件页内切换普通收件箱和垃圾信箱，通过长按邮件拒收或取消拒收发件人。
- 收件 / 发件 / 未知地址：查看系统收件、发件记录，以及发往未创建地址的邮件；未知地址可一键创建为正式邮箱。
- 验证码快捷处理：自动识别常见验证码，一键复制并显示成功提示。
- 新邮件提醒：本地记录新邮件/已读状态，历史邮件默认不打扰，新刷新出的邮件会显示轻量小圆点。
- HTML 邮件阅读：支持富文本 HTML、纯文本、源文本和邮件详情查看。
- 主题与夜间阅读：支持浅色、普通深色、OLED 黑和跟随系统；深色快捷切换会记住你偏好的黑色类型。
- 自托管友好：邮箱服务由你自己部署和控制，移动端只连接你的 Worker/API。
点击缩略图可以打开原图查看。
| 预览 | 说明 |
|---|---|
 |
管理员统计面板：集中展示可管理地址、收件、发件和未知地址收件数量，支持刷新和顶部标签切换。 |
 |
发送邮件：选择发件身份，填写收件人、主题和正文。 |
 |
管理员设置：配置 Worker 地址、Admin 密码、站点密码和自动刷新间隔。 |
 |
外观设置：选择浅色、深色、OLED 黑或跟随系统。 |
从 GitHub Releases 下载最新版 APK。
APK 不直接提交到源码仓库，构建产物通过 GitHub Releases 分发，以保持 Git 历史干净。
V1.1.2 及更早版本升级提示：旧 APK 使用调试证书签名，V1.1.3 起改用生产证书，无法直接覆盖旧版安装。升级前请记录 Worker 配置，并逐个复制仍需保留的邮箱凭证；随后卸载旧版、安装 V1.1.4，再重新配置或导入。不要在未备份凭据时卸载旧版。
CloudMail 需要连接到一个或多个已经部署好的 cloudflare_temp_email 兼容服务，也就是你的 Cloudflare 临时邮箱 Worker/API。你需要准备：
- Worker 地址：例如
https://worker-a.example.com、https://worker-b.example.com。 - Admin 密码：每个 Worker 对应自己的管理员密码。
- 站点密码：如果某个 Worker 配置了
PASSWORDS，需要填写。 - 域名归属：例如账号 A 的 Worker 管理
1.com / 2.com / 3.com，账号 B 的 Worker 管理4.com / 5.com / 6.com。
如果还没有部署后端，请先参考上游项目 cloudflare_temp_email。
- 安装并打开 CloudMail。
- 首次启动会直接进入 管理员设置。
- 在 Workers 配置 中添加一个或多个 Worker 档案，填写名称、Worker 地址、Admin 密码和站点密码。
- 点击 测试连接 / 刷新域名，确认每个 Worker 可用并缓存域名列表。
- 选择当前默认 Worker，并设置自动刷新时间。
- 可在 外观 中选择浅色、深色、OLED 黑或跟随系统。
- 保存配置后，CloudMail 会校验当前 Worker 的管理员密码；成功后自动进入 管理员后台。
- 再次打开应用时，如果配置仍有效，会直接进入管理员后台。
- 在管理员后台右上角点击 设置 可随时回到管理员设置页。
- Worker 档案里的 前端地址 用于生成一键登录链接；配置后可在地址列表或地址详情中直接复制登录链接。
- 管理员顶部的 Worker 名称可快速切换当前管理范围。
- 顶部标签支持点击切换。
- 主题快捷按钮会记住你偏好的深色类型：如果你选择过 OLED 黑，浅色切回深色时会回到 OLED 黑，而不是普通深色。
- 增量刷新出现的新邮件会显示小圆点；打开详情、复制验证码或全部已读后，小圆点会自动消失。
- 在收件页点击标题处的下拉入口，可切换收件箱和垃圾信箱。
- 长按邮件可打开操作菜单；长按地址可进入批量选择模式。
- 创建邮箱时，域名选择器会标注来源 Worker；选择某个域名后会自动路由到对应 Worker。
- 统计：查看当前 Worker 的地址数、收件数、发件数和未知地址收件数。
- 地址：搜索、创建、分组、按用户筛选、查看凭证、清空收件箱、删除邮箱地址和批量管理。
- 收件：查看全部收件，支持搜索、验证码复制、新邮件标识、垃圾信箱和分组筛选。
- 发件：查看系统发件记录。
- 未知：查看发往未创建邮箱地址的邮件，并可一键创建对应邮箱。
- 发送：在当前 Worker 范围内选择发件身份并发送邮件。
- Expo 54 / React Native 0.81
- React 19 / TypeScript 5.9
- Expo Router
- React Native Reanimated / Gesture Handler
- AsyncStorage / SecureStore
- WebView 邮件预览
- Vitest
- 可选 Drizzle 后端工具
安装依赖：
pnpm install启动完整开发环境：
pnpm dev只启动 Expo：
pnpm dev:metro提交前建议运行：
pnpm check
pnpm test
pnpm lint完整说明见 BUILD.md。常用本地构建流程：
pnpm install
EXPO_NO_DOTENV=1 NODE_ENV=production npx expo prebuild -p android --clean
cd android
NODE_ENV=production ./gradlew assembleRelease本地 assembleRelease 只用于编译验证，默认仍可能使用调试证书。公开发布必须使用 EAS 中保存的生产密钥，详见 BUILD.md。
复制示例配置：
cp .env.example .env.local大多数邮箱连接配置都在应用内完成。环境变量主要用于本地开发、可选 OAuth / 服务端能力、数据库工具、Forge 集成和 AI 相关工具。
不要提交真实密码、管理员 token、邮箱凭证、API key 或数据库连接串。
CloudMail 基于 dreamhunter2333/cloudflare_temp_email 的 Cloudflare 临时邮箱项目生态开发。感谢 dreamhunter2333 和上游项目贡献者提供邮箱后端、Web 管理能力和相关 API 行为。
更多致谢信息见 NOTICE。
CloudMail 使用 MIT License 开源。请同时查看上游仓库的许可证和使用条款。
- LinuxDo 社区：认可并感谢 LinuxDo 社区对开源交流、开发者互助和中文技术社区建设的支持。
- LinuxDo Community: recognized with appreciation for its support of open-source discussion, developer collaboration, and the Chinese tech community.