Skip to content

xkongbuwuyu/Go-Email

 
 

Repository files navigation

GoMail 🚀

现代化临时邮箱服务 - 基于 Cloudflare 全栈解决方案

一个完全免费、开源的临时邮箱服务,基于 Cloudflare Workers + D1 数据库 + R2 存储构建,采用 React Router v7 开发,提供企业级的性能和稳定性。

🌐 在线体验

官方网站: http://184772.xyz/

立即访问体验完整功能,无需注册即可使用!

💬 交流群组

QQ交流群: 1017212982

欢迎加入讨论技术问题、功能建议和使用心得!

🎯 项目简介

GoMail 是一个专为隐私保护和便捷使用而设计的临时邮箱服务:

🚀 核心特性

  • 即时生成:无需注册,一键生成临时邮箱
  • 📧 实时接收:自动接收邮件,实时显示内容
  • 📎 附件支持:完整支持邮件附件查看和下载
  • 🔒 隐私保护:24小时自动过期,保护用户隐私
  • 🌐 全球可用:基于Cloudflare全球网络,访问速度快
  • 📱 响应式设计:完美支持手机、平板、电脑访问

🛠️ 技术架构

  • 前端: React Router v7 + TypeScript + Tailwind CSS
  • 后端: Cloudflare Workers (Serverless)
  • 数据库: Cloudflare D1 (SQLite)
  • 存储: Cloudflare R2 (附件存储)
  • 邮件: Cloudflare Email Routing
  • 部署: 一键部署到 Cloudflare

🎯 使用场景

👥 适用人群

  • 🛡️ 隐私保护者:不想暴露真实邮箱地址
  • 🧪 开发测试:需要大量邮箱进行功能测试
  • 📝 临时注册:注册一次性账号或服务
  • 🚫 避免垃圾邮件:防止营销邮件骚扰
  • 🔍 匿名验证:匿名接收验证码和激活邮件

💼 应用场景

  • 📱 APP注册验证
  • 🌐 网站账号激活
  • 🎮 游戏账号注册
  • 💳 优惠券和促销信息接收
  • 🧪 API接口测试
  • 📊 邮件营销测试

✨ 功能特性

🚀 核心功能

  • 秒级生成:点击即可生成可用邮箱
  • 📧 实时接收:邮件到达立即显示,无需刷新
  • 📎 附件下载:支持各种格式附件查看和下载
  • 🔄 自动刷新:智能轮询,及时获取新邮件
  • 自动过期:24小时后自动清理,保护隐私
  • 📱 移动优化:完美适配手机和平板设备

🛠️ 管理功能

  • 🔐 管理后台:完整的邮件和用户管理系统
  • 🔑 API接口:RESTful API支持第三方集成
  • 📊 使用统计:详细的访问和使用数据分析
  • 🛡️ 安全防护:防刷机制和访问频率限制

💰 商业化功能

  • 📊 Google AdSense:完整的广告系统集成
  • 📈 百度统计:用户行为数据分析
  • 🎨 响应式广告:自适应不同设备的广告展示
  • 💡 条件显示:可配置的广告开关控制

🛡️ 安全与性能

  • 🔒 隐私保护:军用级加密和零日志策略
  • 极速访问:基于 Cloudflare 全球网络
  • 📱 PWA 支持:渐进式 Web 应用体验
  • 🌐 SEO 优化:完整的搜索引擎优化

🛠️ 技术栈

前端技术

  • 框架:React Router v7
  • 样式:Tailwind CSS + 自定义组件库
  • 构建:Vite 6.x
  • 类型:TypeScript

后端服务

  • 运行时:Cloudflare Workers
  • 数据库:Cloudflare D1 (SQLite)
  • 存储:Cloudflare R2 (附件存储)
  • 缓存:Cloudflare KV
  • 邮件:Cloudflare Email Workers

开发工具

  • ORM:Drizzle ORM
  • 包管理:pnpm
  • 代码质量:Biome
  • 部署:Wrangler CLI

🚀 快速部署

📋 部署步骤

# 1. 克隆项目
git clone https://github.com/xn030523/Go-Email.git
cd Go-Email

# 2. 安装依赖
npm install

# 3. 配置域名
# 编辑 config.cjs 文件,修改域名配置
cp config.example.cjs config.cjs
# 修改 config.cjs 中的域名设置

# 4. 生成配置并部署
npm run generate-configs  # 生成配置文件
npm run build             # 构建项目
npx wrangler deploy       # 部署到 Cloudflare

🌐 域名配置选项

🔹 单域名配置(简单)

domain: {
  primary: "your-domain.com",        // 🔥 改成你的域名
  website: "your-domain.com",
  strategy: "smart",
},

🔹 多域名配置(推荐)

domain: {
  primary: "main-domain.com",        // 🔥 主域名
  website: "main-domain.com",
  additional: [                      // 🌟 备用域名
    "backup-domain.com",
    "mail.example.org",
  ],
  strategy: "smart",                 // 智能选择策略
},

域名策略说明

  • smart - 智能选择(推荐):80%使用备用域名,保护主域名
  • random - 随机选择:平均分配所有域名负载
  • manual - 手动选择:用户界面手动选择域名

详细配置说明请查看 SETUP.md

🎯 配置说明

只需要修改 config.cjs 一个文件即可完成所有配置:

module.exports = {
  //  域名配置
  domain: {
    primary: "your-domain.com",       // 主域名
    additional: [                     // 备用域名(可选)
      "backup-domain.com",
    ],
    strategy: "smart",                // 域名选择策略
  },

  // ☁️ Cloudflare 配置
  cloudflare: {
    database: { name: "gomail-database" },
    kv: { name: "gomail-kv" },
    r2: { name: "gomail-attachments" },
  },
};

🌟 特色功能

📊 Google AdSense 集成

  • 🎯 动态配置:无需修改代码,配置文件控制
  • 📱 响应式广告:自适应不同设备尺寸
  • 💡 条件显示:可随时启用/禁用广告
  • 🔧 多广告位:支持顶部横幅、侧边栏、内容广告

📈 数据统计分析

  • 📊 百度统计:完整的用户行为分析
  • 🎛️ 配置化管理:统计功能可配置开关
  • 📱 移动端优化:完美支持移动设备统计

🔐 安全与隐私

  • 🛡️ ads.txt 自动配置:Google AdSense 验证文件
  • 🔒 Session 加密:安全的用户会话管理
  • 🚫 零日志策略:不记录用户隐私数据
  • 自动过期:24小时后自动清理数据

📚 文档与指南

🎯 部署状态

🤝 贡献指南

  1. Fork 项目
  2. 创建功能分支 (git checkout -b feature/AmazingFeature)
  3. 提交更改 (git commit -m 'Add some AmazingFeature')
  4. 推送到分支 (git push origin feature/AmazingFeature)
  5. 发起 Pull Request

📄 许可证

本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情

🙏 致谢

  • Cloudflare - 提供强大的边缘计算平台
  • React Router - 现代化的路由解决方案
  • Tailwind CSS - 优秀的 CSS 框架
  • Drizzle ORM - 类型安全的 ORM

🎯 最方便的部署方式

🚀 推荐:使用Cloudflare一键部署

  1. Fork项目到你的GitHub
  2. 在Cloudflare Pages中连接GitHub仓库
  3. 配置环境变量和资源绑定
  4. 自动部署完成

这种方式支持:

  • 自动部署:代码推送自动更新
  • 零配置:Cloudflare自动处理构建
  • 免费使用:Cloudflare免费计划足够使用
  • 全球CDN:自动享受全球加速

💡 部署小贴士

  • 🔧 首次部署:建议使用详细步骤,确保理解每个环节
  • 快速体验:使用一键部署脚本,5分钟即可上线
  • 🌐 生产环境:推荐使用付费计划,获得更好的性能
  • 📊 监控运维:配置Cloudflare Analytics监控服务状态

💬 交流与支持

🎯 官方资源

🤝 获取帮助

  • 📖 部署指南: SETUP.md - 完整的配置和部署教程
  • 🐛 Bug报告: GitHub Issues
  • 💡 功能建议: GitHub Discussions
  • 💬 技术交流: 加入QQ群 1017212982 讨论
  • 📧 邮件联系: 使用我们的临时邮箱服务发送反馈

🎉 社区贡献

欢迎提交PR、报告Bug、提出建议!我们重视每一个反馈。

📄 开源协议

本项目采用 MIT License 开源协议,你可以:

  • ✅ 商业使用
  • ✅ 修改代码
  • ✅ 分发代码
  • ✅ 私人使用

🙏 致谢

感谢以下技术和平台:

  • Cloudflare - 强大的边缘计算平台
  • React Router v7 - 现代化路由框架
  • Tailwind CSS - 优秀的CSS框架
  • Drizzle ORM - 类型安全的数据库ORM

🌟 GoMail - 让临时邮箱更简单 🌟

⭐ 如果这个项目对您有帮助,请给我们一个 Star!⭐

🚀 立即体验:http://184772.xyz/ 🚀

💬 加入交流群:1017212982 💬

About

Go-email

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • TypeScript 90.3%
  • JavaScript 8.6%
  • CSS 1.1%