基于 React Router Framework Mode + Cloudflare Workers 的临时邮箱服务。

• 线上域名：https://smail.pw
• Worker 名称：smail-app
• 默认语言：en（同时支持 10 种语言）

• 上方按钮可让其他开发者将本项目一键部署到他们自己的 Cloudflare 账号。
• 部署流程会基于仓库中的 wrangler.jsonc 自动创建并绑定所需资源（D1 / R2）。
• 项目仓库需要保持公开（public）才能让他人正常使用该按钮。

这是一个面向低风险场景的临时邮箱网站，核心目标是：

• 一键生成临时邮箱地址
• 即时查看收件箱
• 用于注册验证、OTP、一次性下载等短期流程
• 避免暴露长期个人邮箱

项目同时包含多语言 SEO 页面（Markdown）和多语言博客。

• React 19 + React Router 7（Framework Mode，SSR）
• Cloudflare Workers（HTTP + Email Worker）
• Cloudflare D1（存储邮件元数据）
• Cloudflare R2（存储邮件原始内容）
• Signed Cookie Session（React Router 内置 Session）
• Tailwind CSS 4
• Markdoc（渲染 Markdown 页面与博客）

• 首页临时邮箱收件箱
• 邮件预览弹窗（解析 HTML/Text）
• 多语言路由（/:lang?）
• SEO 路由：/robots.txt、/sitemap.xml、/rss.xml
• 多语言 Markdown 页面（about/faq/privacy/terms + 长尾 SEO 落地页）
• 多语言博客列表、分页、文章页

1. 邮件进入 Worker 的 email 事件（workers/app.ts）
2. 解析原始邮件后：
   • 元数据写入 D1 emails 表（id/to_address/from/subject/time）
   • 原始邮件内容写入 R2（对象 key 为 id）
3. 首页按当前会话中的地址读取 D1 列表
4. 打开邮件详情时，通过 /api/email/:id：
   • 校验该邮件地址属于当前会话
   • 校验地址是否超过 24h
   • 从 R2 读取原始邮件并解析后返回

说明：当前“24 小时”主要体现在 Cookie Session 可访问窗口与前端展示逻辑；scheduled 清理入口已预留，但未实现数据库物理清理逻辑。

app/
  routes/              # 路由模块（home、md、blog、api、sitemap、robots 等）
  md/                  # 多语言 SEO Markdown 页面
  blog/                # 多语言博客内容与元数据
  i18n/                # 语言配置与文案
  .server/session.ts   # Signed Cookie Session
  utils/               # 公共工具（meta、theme、retention 等）
workers/
  app.ts               # Cloudflare Worker 入口（fetch + email）
migrations/
  *.sql                # D1 迁移
wrangler.jsonc         # Cloudflare 绑定配置

pnpm install

先创建本地 secret：

cp .env.example .env

pnpm run dev

默认访问：http://localhost:5173

pnpm run typecheck

pnpm run build
pnpm run preview

• pnpm run dev：本地开发
• pnpm run build：生产构建
• pnpm run preview：本地预览构建产物
• pnpm run typecheck：Cloudflare 类型生成 + 路由类型生成 + TS 检查
• pnpm run deploy：构建后部署到 Cloudflare Workers
• pnpm run migrate：对远端 D1（smail-v3）执行迁移

wrangler.jsonc 当前使用以下绑定：

• D1：邮件元数据（数据库名 smail-v3）
• R2：邮件内容对象存储（桶名 smailv3）
• triggers.crons：*/30 * * * *（30 分钟触发一次，当前 scheduled 未实现清理）

此外还需要配置一个 Worker Secret：

• SESSION_SECRETS：Cookie Session 的签名密钥。支持逗号分隔多个值用于轮换，最左侧为当前生效密钥。

本地开发可使用 .env，生产环境使用：

注意：.env 和 .dev.vars 二选一即可；如果存在 .dev.vars，Wrangler 本地开发时不会再加载 .env。

pnpm wrangler secret put SESSION_SECRETS

当前迁移文件：

• migrations/20260211_create_emails.sql
• migrations/20260212_email_indexes.sql

首次部署或表结构变更后，执行：

pnpm run migrate

• 支持语言：en/zh/es/fr/de/ja/ko/ru/pt/ar
• 默认语言为 en，默认语言不带前缀
• Markdown 页面与博客均支持多语言
• 自动生成 sitemap（包含首页、Markdown 页、博客列表/分页/文章）

pnpm run deploy

发布前建议至少执行：

pnpm run typecheck
pnpm run build

• 本项目面向临时收信与低风险验证场景。
• 不建议用于银行、工作、政务、法律与关键账号找回等高敏感场景。