2.0 KiB
2.0 KiB
🚀 快速启动指南
一键启动（推荐）
使用 Docker Compose 一键启动所有服务：
# 启动所有服务（MySQL、Redis、后端、前端）
docker-compose up -d
# 查看服务状态
docker-compose ps
# 查看日志
docker-compose logs -f backend
启动后访问：
- 前端界面: http://localhost:3000
- 后端 API: http://localhost:8000
- API 文档: http://localhost:8000/docs
分别启动
1. 后端服务
# 进入后端目录
cd backend
# 安装依赖
pip install -r requirements.txt
# 启动服务
python run.py
2. 前端服务
# 进入前端目录
cd frontend
# 安装依赖
npm install
# 启动开发服务器
npm run dev
📋 系统要求
- Docker: 20.10+
- Docker Compose: 2.0+
- Python: 3.10+
- Node.js: 16+
🔧 配置说明
环境变量
复制环境变量示例文件：
cp .env.example .env
主要配置项：
DATABASE_URL: MySQL 连接地址SECRET_KEY: JWT 密钥REDIS_HOST: Redis 主机地址
MySQL 连接信息
通过 Docker 启动时：
主机: localhost
端口: 3306
数据库: treasure_box_game
用户名: root
密码: treasure_box_2024
🐛 常见问题
Q: Docker 启动失败？
A: 检查端口占用情况：
# Windows
netstat -ano | findstr :3306
# Linux/Mac
lsof -i :3306
Q: 数据库连接失败？
A: 确保 MySQL 容器已启动并健康：
docker-compose ps
docker-compose logs mysql
Q: 前端无法连接后端？
A: 检查 Vite 代理配置和后端 CORS 设置
📚 更多文档
- 完整迁移指南:
MYSQL_迁移指南.md - 项目完成报告:
项目完成报告.md - 前端开发文档:
frontend/README.md - 后端 API 文档: http://localhost:8000/docs
🎯 下一步
- 访问 http://localhost:3000 注册用户
- 体验完整的竞猜流程
- 尝试创建宝箱（需要 streamer 权限）
- 查看 API 文档了解所有接口
祝您使用愉快！ 🎉