安装方式一：Python + Node.js + MySQL
适合需要本地修改前端或自行执行 npm run build 的部署方式。
环境要求
| 组件 | 说明 |
|---|---|
| MySQL | 5.7+ / 8.x |
| Python | 建议 3.10+ |
| Node.js | 建议 18+（安装依赖与打包前端） |
1. 后端（FastAPI）
Windows（PowerShell，在 backend 目录）
cd backend
python -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install -r requirements.txt
python .\run.py默认开发监听 0.0.0.0:8520（以项目配置为准）。
Linux / 宝塔
cd backend
bash setup.sh
bash start.sh # 生产多 worker若脚本报 $'\r': command not found：
sed -i 's/\r$//' setup.sh start.sh
chmod +x setup.sh start.sh可选环境变量：HOST、PORT、WORKERS。可在 backend 下建 .env 设置 SECRET_KEY 等（详见仓库 使用说明.md）。
2. 前端（开发与打包）
cd frontend
npm install
npm run dev开发服务器默认 5173，已将 /api 代理到 http://127.0.0.1:8520（见 vite.config.ts）。请先启动后端，再开前端。
生产构建：
npm run build产物在 frontend/dist，由 Nginx / Caddy / 宝塔 托管静态文件，并将 /api 反向代理到后端（与开发时代理一致）。
3. 首次安装数据库
浏览器打开前端地址 → 进入安装向导 → 填写 MySQL 与管理员账号 → 完成安装。数据库连接主要写入 backend/instance/app_config.json。
4. 反向代理要点
- 静态：
root指向dist，try_files回退index.html（SPA）。 - 接口：
location /api/ { proxy_pass http://127.0.0.1:8520; }（保留路径前缀）。