cloudflare_temp_email
CloudFlare free temp domain email 免费收发 临时域名邮箱 支持附件 IMAP SMTP TelegramBot
dreamhunter2333
vv1.8.0 Cross-platform 9,664 stars
Free
Open Source
Safe Download
MIT License
Recently Updated
Latest Version
About cloudflare_temp_email
CloudFlare free temp domain email 免费收发 临时域名邮箱 支持附件 IMAP SMTP TelegramBot
What's New in vv1.8.0
What's Changed
Features
- feat: |Frontend| 前端新增 6 国语言支持(
zh/en/es/pt-BR/ja/de),默认语言保持为zh;无 locale 前缀路由(如/、/user)默认使用中文渲染,同时会记录浏览器语言作为语言偏好。用户手动切换后会持久化语言偏好,并保持当前页面路径、查询参数与 canonical locale URL 一致 - feat: |API| 新增服务端解析邮件接口
/api/parsed_mails与/api/parsed_mail/:id,直接返回sender/subject/text/html/attachments元信息(复用commonParseMail),AI agent 侧不再需要引入 MIME 解析器 - feat: |Skill| 新增仓库内置只读 skill
cf-temp-mail-agent-mail(skills/cf-temp-mail-agent-mail/),让 OpenClaw / Codex / Cursor 等 AI agent 凭用户提供的 Address JWT + API 地址读取邮箱、轮询验证码,绕开创建邮箱时的 Turnstile 人机验证;可通过npx degit dreamhunter2333/cloudflare_temp_email/skills/cf-temp-mail-agent-mail安装 - docs: |文档| 新增"AI Agent 使用邮箱"文档(
guide/feature/agent-email),说明parsed_mailAPI 用法,并在 parsed API 不可用时给出对齐前端的mail-parser-wasm+postal-mime本地解析回退方案 - docs: |文档| 在
quick-start/worker-vars/email-routing三个入口文档(中英文)显式补充"域名是部署前提条件"提示,强调需先在 Cloudflare 启用 Email Routing 并下发邮件 DNS 记录、Worker 部署后再绑定 Catch-all,子域名需单独启用,避免用户在没有可用域名时直接开始部署却收不到邮件(issue #1004) - docs: |部署排障| 优化近期 issue 暴露的 UI 部署与升级排障文档:补充
nodejs_compat、D1 绑定名必须为DB、/open_api/settings校验、后端 API 地址填写、Cloudflare 安全挑战导致Network Error、D1 容量上限与 Cron Trigger 自动清理、GitHub OAuth 公开邮箱、admin 管理口令与用户账号区别、随机二级域名 API 需传enableRandomSubdomain等说明;同时将帮助/FAQ 菜单移动到核心配置之后,提升可见性 - docs: |文档| 补充重新创建旧邮箱提示地址已存在时的处理方式,并完善 GitHub Actions 自动更新配合 Page Functions 转发后端请求的 workflow 说明(issues #947 #654)
- docs: |OAuth2| 补充 GitHub 私密邮箱登录配置,说明可使用
https://api.github.com/user/emails、JSONPath 邮箱字段和user:emailscope 获取主邮箱(issue #655)
Bug Fixes
- fix: |Frontend| 收窄地址管理相关弹窗宽度,并让地址表格在弹窗内部横向滚动,避免多地址场景撑宽弹窗
- fix: |Frontend| 修复
/open_api/settings未返回domains数组时前端设置初始化直接调用map()报undefined错误的问题,统一按空数组兜底处理 - fix: |Frontend| 修复前端在
jwt/auth/adminAuth等 localStorage 凭据为空字符串、字面量"undefined"或包含换行/控制符时,请求构造的Authorization等头部抛出Invalid character in header content导致前端所有接口报错的问题(issue #1000)。新增safeHeaderValue/safeBearerHeader工具,对全部认证头做 RFC 7230 校验,不安全的值直接跳过该头部,让 worker 走标准 401 而不是请求级崩溃 - fix: |Frontend| 修复多语言菜单在移动端顶部显示语言与版本按钮导致 Header 横向拥挤或溢出的问题,移动端仅保留菜单按钮并将语言/版本入口放入抽屉
Improvements
- refactor: |Worker| 拆分
mails_api/index.ts与admin_api/index.ts,入口只负责挂路由,业务拆到各自的*_api.ts文件(mails_crud.ts/new_address.ts/parsed_mail_api.ts/address_api.ts/address_sender_api.ts/sendbox_api.ts/statistics_api.ts/account_settings_api.ts),保持路径与行为不变
更新或者部署网页不生效请如图勾选清理缓存
English
What's Changed
Features
- feat: |Frontend| Add six-language frontend support (
zh/en/es/pt-BR/ja/de), keepzhas the default locale; locale-unprefixed routes (for example/and/user) render in Chinese by default while still recording browser language as the stored preference. Explicit locale switches are persisted, and the current route, query string, and canonical locale URL stay in sync during switching - feat: |API| Add server-side parsed-mail endpoints
/api/parsed_mailsand/api/parsed_mail/:idthat returnsender/subject/text/html/attachmentsmetadata directly (reusescommonParseMail), so AI agents no longer need a client-side MIME parser - feat: |Skill| Bundle a read-only skill
cf-temp-mail-agent-mail(skills/cf-temp-mail-agent-mail/) so AI agents like OpenClaw / Codex / Cursor can consume a mailbox with a user-supplied Address JWT + API base URL — list mails, poll verification codes, etc. — sidestepping the Turnstile challenge required to create a mailbox. Install vianpx degit dreamhunter2333/cloudflare_temp_email/skills/cf-temp-mail-agent-mail - docs: |Docs| Add "AI Agent Mailbox Usage" doc (
guide/feature/agent-email) covering theparsed_mailAPI and a local-parse fallback usingmail-parser-wasm+postal-mime(mirrors the frontend) when parsed endpoints are unavailable - docs: |Docs| Make "a domain is a hard prerequisite" explicit at the top of
quick-start,worker-vars, andemail-routing(zh + en), spelling out that Cloudflare Email Routing must be enabled with email DNS records provisioned before deployment, the Catch-all rule must be bound after the Worker is deployed, and subdomains do not inherit the parent domain's Email Routing — so users no longer start deploying without a usable domain and end up unable to receive mail (issue #1004) - docs: |Deployment troubleshooting| Improve docs for recent UI-deployment and upgrade issues: document
nodejs_compat, the required uppercaseDBD1 binding,/open_api/settingsverification, backend API URL entry, Cloudflare security challenges causingNetwork Error, D1 size limits and Cron Trigger cleanup, GitHub OAuth public email requirements, the difference between admin passwords and user accounts, and theenableRandomSubdomainAPI flag; move the Help/FAQ menu directly after Core Configuration so it is easier to find - docs: |Docs| Document how to handle the "address already exists" case when recreating an old mailbox, and clarify the GitHub Actions workflow for automatic updates with Page Functions forwarding backend requests (issues #947 #654)
- docs: |OAuth2| Document GitHub private-email login configuration using
https://api.github.com/user/emails, a JSONPath email field, and theuser:emailscope to read the primary email (issue #655)
Bug Fixes
- fix: |Frontend| Narrow address-management modal widths and keep address tables horizontally scrollable inside the modal to prevent multi-address lists from stretching the dialog
- fix: |Frontend| Fix the frontend settings bootstrap throwing an
undefinederror when/open_api/settingsdoes not return adomainsarray by normalizing the field to an empty array before mapping it - fix: |Frontend| Fix every API call crashing client-side with
Invalid character in header content ["Authorization"]when stale localStorage credentials (jwt/auth/adminAuth/userJwt/access_token) are empty, the literal string"undefined", or contain a stray newline or other control character (issue #1000). AddssafeHeaderValue/safeBearerHeaderhelpers that validate every auth header against RFC 7230 and omit the header entirely when unsafe, so the worker returns a clean 401 instead of the request being rejected by axios/undici - fix: |Frontend| Fix the multilingual header on mobile by keeping only the menu button in the top bar and moving language/version actions into the drawer to avoid horizontal crowding or overflow
Improvements
- refactor: |Worker| Split
mails_api/index.tsandadmin_api/index.tsso the index files only wire routes. Business logic moved into dedicated*_api.tsfiles (mails_crud.ts/new_address.ts/parsed_mail_api.ts/address_api.ts/address_sender_api.ts/sendbox_api.ts/statistics_api.ts/account_settings_api.ts). Paths and behavior unchanged
PRs
- chore: bump v1.8.0, add release-notify skill, optimize docs deploy by @dreamhunter2333 in https://github.com/dreamhunter2333/cloudflare_temp_email/pull/992
- feat: add agent-mail skill, parsed mail API and docs by @dreamhunter2333 in https://github.com/dreamhunter2333/cloudflare_temp_email/pull/993
- Refactor delete setting helper and link skills by @dreamhunter2333 in https://github.com/dreamhunter2333/cloudflare_temp_email/pull/994
- feat(i18n): enhance locale handling and routing by @lxw15337674 in https://github.com/dreamhunter2333/cloudflare_temp_email/pull/996
- fix: 修复前端设置初始化时未返回 domains 数组导致的 undefined 错误 by @lxw15337674 in https://github.com/dreamhunter2333/cloudflare_temp_email/pull/997
- fix: constrain address management modal width by @dreamhunter2333 in https://github.com/dreamhunter2333/cloudflare_temp_email/pull/1002
- fix(frontend): drop empty/control-char auth headers (#1000) by @voidborne-d in https://github.com/dreamhunter2333/cloudflare_temp_email/pull/1003
- docs: highlight that a domain is a prerequisite for deployment by @cloverstd in https://github.com/dreamhunter2333/cloudflare_temp_email/pull/1005
- docs: clarify Email Routing setup order by @dreamhunter2333 in https://github.com/dreamhunter2333/cloudflare_temp_email/pull/1006
- docs: 添加 CloudMail 移动端管理客户端 by @Lur1N77777 in https://github.com/dreamhunter2333/cloudflare_temp_email/pull/1007
- docs: improve deployment troubleshooting by @dreamhunter2333 in https://github.com/dreamhunter2333/cloudflare_temp_email/pull/1011
- docs: clarify mailbox rebinding and page function actions by @dreamhunter2333 in https://github.com/dreamhunter2333/cloudflare_temp_email/pull/1012
- docs: clarify GitHub OAuth email setup by @dreamhunter2333 in https://github.com/dreamhunter2333/cloudflare_temp_email/pull/1013
- chore: update PR Agent model by @dreamhunter2333 in https://github.com/dreamhunter2333/cloudflare_temp_email/pull/1014
- docs: update README feature overview by @dreamhunter2333 in https://github.com/dreamhunter2333/cloudflare_temp_email/pull/1015
- fix: improve mobile header menu by @dreamhunter2333 in https://github.com/dreamhunter2333/cloudflare_temp_email/pull/1016
Full Changelog: https://github.com/dreamhunter2333/cloudflare_temp_email/compare/v1.7.0...v1.8.0
Legal Notice
This software is provided by its original developers. We only index and provide links to official download sources. All downloads are from the original publishers and are completely legal and safe.
Download Information
File Type: zip
File Size: 974.17 KB
Category: Communication
Source: GitHub
Updated: May 27, 2026
Related Apps
LKY_OfficeTools
GitHub一键自动化 下载、安装、激活 Office 的利器。
Cross-platform
vv1.3.0 11,905
Free
Safe
GNU General Public License v3.0
alertmanager
GitHubPrometheus Alertmanager
Cross-platform
vv0.32.1 8,485
Free
Safe
Apache License 2.0
rustmailer
GitHubA self-hosted Email Middleware for IMAP, SMTP, Gmail API, Graph API — built for developers
Cross-platform
v1.6.0 458
Free
Safe
Other
ESP-Mail-Client
GitHub⚠️ DEPRECATED ⚠️ The comprehensive Arduino Email Client Library.
Cross-platform
vv3.4.24 217
Free
Safe
MIT License