cloudflare_temp_email

Name: cloudflare_temp_email
Availability: InStock
Rating: 5.0 (9664 reviews)
Author: dreamhunter2333

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_mail API 用法，并在 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:email scope 获取主邮箱（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), keep zh as 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_mails and /api/parsed_mail/:id that return sender / subject / text / html / attachments metadata directly (reuses commonParseMail), 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 via npx degit dreamhunter2333/cloudflare_temp_email/skills/cf-temp-mail-agent-mail
docs: |Docs| Add "AI Agent Mailbox Usage" doc (guide/feature/agent-email) covering the parsed_mail API and a local-parse fallback using mail-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, and email-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 uppercase DB D1 binding, /open_api/settings verification, backend API URL entry, Cloudflare security challenges causing Network Error, D1 size limits and Cron Trigger cleanup, GitHub OAuth public email requirements, the difference between admin passwords and user accounts, and the enableRandomSubdomain API 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 the user:email scope 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 undefined error when /open_api/settings does not return a domains array 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). Adds safeHeaderValue / safeBearerHeader helpers 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.ts and admin_api/index.ts so the index files only wire routes. Business logic moved into dedicated *_api.ts files (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.