H3ConuMS-v2/启动指南.md

快速启动指南

✅ 当前状态

• 后端服务：http://localhost:8000 ✅ 运行中
• 前端服务：http://localhost:5173 ✅ 运行中
• 数据库：已初始化 ✅
• API 文档：http://localhost:8000/docs ✅

访问系统

打开浏览器访问：http://localhost:5173

---

后端服务

启动命令

cd backend
source venv/bin/activate
uvicorn app.main:app --reload --host 0.0.0.0 --port 8000

停止服务

按 Ctrl+C

前端服务

启动命令

cd frontend
npm run dev

访问地址

• 前端：http://localhost:5173
• 后端 API：http://localhost:8000
• API 文档：http://localhost:8000/docs

环境配置

确保 backend/.env 文件已配置：

• DATABASE_URL
• REDIS_URL
• CASDOOR_* 配置
• SECRET_KEY

故障排除

后端启动失败

1. 检查虚拟环境：source venv/bin/activate
2. 检查依赖：pip list
3. 检查 .env 配置

数据库连接失败

检查 DATABASE_URL 配置是否正确

---

最后更新：2026-04-01