README.zh-CN.md

🚀 ZMAIL - 24小时匿名邮箱服务

English | 中文

💌 安全、简单、即用即走的临时邮箱服务

🌐 在线体验 • ✨ 功能特点 • 🚀 快速部署 • 💻 本地开发 • 🔧 技术栈

---

✨ 功能特点

✨ 即时创建

无需注册，立即获得一个临时邮箱地址

🔒 隐私保护

保护您的真实邮箱，避免垃圾邮件和信息泄露

⚡ 高速接收

实时接收邮件，无需刷新页面

🌐 全球可用

基于Cloudflare构建，全球边缘网络加速

🔄 自动刷新

自动检查新邮件，确保不错过任何重要信息

📱 响应式设计

完美适配各种设备，从手机到桌面

---

🚀 快速部署

ZMAIL 由前端和后端两部分组成，需要分别部署：

🖥️ 前端部署步骤

1️⃣ 部署前端到 Cloudflare Pages

1. 点击"部署前端到 Cloudflare Pages"按钮
2. 连接您的GitHub账户并选择导入此仓库
3. 设置构建配置:
   • 构建命令: yarn build
   • 构建输出目录: dist
   • 根目录（高级）-> 路径: frontend
4. 配置环境变量:
   • VITE_API_BASE_URL: 您的Worker API基础URL (例如: https://api.mdzz.uk)
   • VITE_EMAIL_DOMAIN: 您的域名 (例如: mdzz.uk)
5. 点击"保存并部署"

⚙️ 后端部署步骤

2️⃣ 部署后端到 Cloudflare Workers

1. 点击"部署后端到 Cloudflare Workers"按钮
2. 连接您的GitHub账户并选择导入此仓库
3. 设置构建配置:
   • 部署命令: yarn deploy
   • 高级设置 -> 根目录: /worker
4. 配置D1数据库:
   • 创建一个D1数据库 (例如: mail_db)
   • 将其绑定到您的Worker (绑定名称: DB)
5. 配置Email路由:
   • 在Cloudflare控制面板中设置Email路由，将邮件转发到您的Worker
6. 点击"部署"

---

💻 本地开发

🎨 前端开发

# 进入前端目录
cd frontend

# 安装依赖
yarn install

# 启动开发服务器
yarn dev

⚙️ Worker开发

# 进入worker目录
cd worker

# 安装依赖
yarn install

# 构建预览
yarn build

# 部署到 cloudflare
yarn deploy

---

🔧 技术栈

🎨 前端

• React - 用户界面库
• TypeScript - 类型安全的JavaScript超集
• Tailwind CSS - 实用优先的CSS框架
• Vite - 现代前端构建工具

⚙️ 后端

• Cloudflare Workers - 边缘计算平台
• Cloudflare D1 - 边缘SQL数据库
• Cloudflare Email Workers - 邮件处理服务

---

👥 贡献指南

欢迎提交Pull Request或Issue来改进这个项目！

📄 许可证

MIT License