8.1 KiB
8.1 KiB
🚀 ZMAIL - 24小时临时邮箱服务
📹 视频教程
- 项目介绍与功能演示
- 一体化 Worker 部署到 Cloudflare 的详细步骤
- Fork 项目并自定义配置的方法
- 配置 Cloudflare Email 路由
- 设置环境变量与 D1 数据库
💡 提示： 视频教程可能基于旧版本录制，最新部署方式请参考下方文档说明。
✨ 功能特点
✨ 即时创建
无需注册，立即获得一个临时邮箱地址
🔒 隐私保护
保护您的真实邮箱，避免垃圾邮件和信息泄露
⚡ 高速接收
实时接收邮件，无需刷新页面
🌐 全球可用
基于Cloudflare构建，全球边缘网络加速
🔄 自动刷新
自动检查新邮件，确保不错过任何重要信息
📱 响应式设计
完美适配各种设备，从手机到桌面
🚀 快速部署
ZMAIL 现在采用全新的一体化部署方式，前端和后端整合为一个 Cloudflare Worker，部署更加简单！
🎯 部署方式选择
我们提供两种部署方式，您可以根据需求选择：
方式一：一键部署（推荐新手）
✅ 优点：
- 部署简单，一键完成
- 无需修改配置文件
- 适合快速体验
❌ 缺点：
- 无法获得后续代码更新
- 需要手动绑定自定义域名
📋 部署步骤：
- 点击上方 "Deploy to Cloudflare" 按钮
- 按照页面提示连接您的 GitHub 账户
- 填写应用名称和数据库名称
- 在高级设置 -> 构建变量中设置：
VITE_EMAIL_DOMAIN: 您的域名列表，使用 ',' 分割 (例如: mdzz.uk,zaunist.com)
- 点击"创建和部署"
- 部署完成后，在 Cloudflare Workers 控制面板中绑定自定义域名
- 配置 Cloudflare Email 路由，将邮件转发到您的 Worker
方式二：Fork 后自定义部署（推荐进阶用户）
✅ 优点：
- 可以获得后续代码更新
- 完全自定义配置
- 更好的版本控制
❌ 缺点：
- 需要手动修改配置文件
- 需要一定的技术基础
- 需要手动创建数据库
📋 部署步骤：
- Fork 本项目到您的 GitHub 账户
- 在 Cloudflare Dashboard 中创建一个 D1 数据库，记住数据库的 name 和 id
- 修改根目录下的
wrangler.toml文件：- 修改
name为您的应用名称。（可选） - 修改
routes中的自定义域名。（必须！默认的worker.dev域名在中国大陆无法访问） - 修改
database_name和database_id为您的 D1 数据库信息。（必须！） - 修改
VITE_EMAIL_DOMAIN为您的域名列表。（可选，只是方便网页上复制粘贴邮件地址使用，不设置也不影响接收邮件）
- 修改
- 在 Cloudflare Dashboard 中选择 "Workers & Pages"
- 点击 "Create application" -> "Pages" -> "Connect to Git"
- 选择您 Fork 的仓库
- 配置构建设置（通常会自动检测）
- 点击 "Save and Deploy"
- 配置 Cloudflare Email 路由，将邮件转发到您的 Worker
📧 配置邮件路由
无论选择哪种部署方式，都需要配置 Cloudflare Email 路由：
- 在 Cloudflare 控制面板中找到您的域名
- 进入 "Email" -> "Email Routing"
- 启用 Email Routing
- 添加路由规则：
- 匹配类型："Catch-all address"
- 操作："Send to a Worker"
- 选择您部署的 Worker
- 如果有多个域名，请为每个域名重复上述步骤
💻 本地开发
🚀 开发
# 安装依赖
pnpm install
# 启动前端开发服务器
pnpm dev:frontend
# 启动后端开发服务器
pnpm dev:backend
⚙️ 部署
# 部署
pnpm run deploy
🔧 技术栈
🎨 前端
- React - 用户界面库
- TypeScript - 类型安全的JavaScript超集
- Tailwind CSS - 实用优先的CSS框架
- Vite - 现代前端构建工具
⚙️ 后端
- Cloudflare Workers - 边缘计算平台
- Cloudflare D1 - 边缘SQL数据库
- Cloudflare Email Workers - 邮件处理服务
👥 贡献指南
欢迎提交Pull Request或Issue来改进这个项目！
⭐ 支持项目
如果您觉得这个项目对您有所帮助，或者您喜欢这个项目，请给它一个 Star ⭐️
您的支持是我持续改进的动力！
