# random_email_gen **Repository Path**: ngmuma/random_email_gen ## Basic Information - **Project Name**: random_email_gen - **Description**: 随机email生成 - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2025-10-29 - **Last Updated**: 2025-10-29 ## Categories & Tags **Categories**: Uncategorized **Tags**: Java, sprintboot, React ## README # 随机邮箱生成器 一个基于 React + Spring Boot 的临时邮箱生成和邮件内容获取应用。 ## 功能特性 - 🚀 一键生成临时邮箱地址 - 📧 实时获取邮件内容 - 🔄 自动刷新邮件列表 - 📱 响应式设计，支持移动端 - 🎨 现代化 UI 界面 - 🔒 保护隐私，无需注册 ## 技术栈 ### 后端 - Spring Boot 3.2.0 - Spring WebFlux (响应式编程) - Maven - Java 17 ### 前端 - React 18 - Ant Design 5 - Axios - Modern CSS ## 项目结构 ``` email_random/ ├── backend/ # Spring Boot 后端 │ ├── src/main/java/ │ │ └── com/example/emailrandom/ │ │ ├── EmailRandomApplication.java │ │ ├── config/ │ │ │ └── CorsConfig.java │ │ ├── controller/ │ │ │ └── EmailController.java │ │ ├── model/ │ │ │ ├── Email.java │ │ │ ├── EmailInbox.java │ │ │ └── EmailResponse.java │ │ └── service/ │ │ └── EmailService.java │ ├── src/main/resources/ │ │ └── application.yml │ └── pom.xml ├── frontend/ # React 前端 │ ├── public/ │ │ └── index.html │ ├── src/ │ │ ├── components/ │ │ │ ├── EmailGenerator.js │ │ │ └── EmailList.js │ │ ├── services/ │ │ │ └── emailService.js │ │ ├── App.js │ │ ├── index.js │ │ └── index.css │ └── package.json └── README.md ``` ## 快速开始 ### 环境要求 - Java 17+ - Node.js 16+ - Maven 3.6+ ### 启动后端服务 1. 进入后端目录： ```bash cd backend ``` 2. 安装依赖并启动： ```bash mvn clean install mvn spring-boot:run ``` 后端服务将在 `http://localhost:8080` 启动 ### 启动前端服务 1. 进入前端目录： ```bash cd frontend ``` 2. 安装依赖： ```bash npm install ``` 3. 启动开发服务器： ```bash npm start ``` 前端应用将在 `http://localhost:3000` 启动 ## API 接口 ### 创建邮箱 - **POST** `/api/email/create-inbox` - **响应**: ```json { "address": "example@domain.com", "token": "access_token" } ``` ### 获取邮件 - **GET** `/api/email/inbox/{token}` - **响应**: ```json { "emails": [ { "from": "sender@example.com", "to": "receiver@domain.com", "subject": "邮件主题", "body": "邮件正文", "html": "HTML内容", "date": 1640995200 } ], "expired": false } ``` ### 健康检查 - **GET** `/api/email/health` - **响应**: `"Email service is running"` ## 使用说明 1. 打开应用首页 2. 点击"生成随机邮箱"按钮 3. 复制生成的邮箱地址 4. 使用该邮箱地址接收邮件 5. 应用会自动每30秒刷新邮件列表 6. 也可以手动点击"刷新"按钮获取最新邮件 ## 注意事项 - 临时邮箱有效期为1小时 - 邮件内容会实时显示 - 支持纯文本和HTML格式邮件 - 应用会自动处理CORS跨域问题 ## 开发说明 ### 后端开发 - 使用 Spring WebFlux 实现响应式编程 - 通过 WebClient 调用 tempmail.lol API - 配置了完整的 CORS 支持 ### 前端开发 - 使用 Ant Design 组件库 - 实现了响应式设计 - 支持自动刷新和手动刷新 - 优雅的错误处理和用户提示 ## 许可证 MIT License