环境依赖清单
项目：智慧停车综合管理平台（Smart Parking Platform）
版本日期：2026-10-10
1. 基础运行环境
| 组件 |
版本要求 |
用途 |
备注 |
| Docker Engine |
20.10+ |
容器运行时 |
Linux 官方源 / Windows Docker Desktop |
| Docker Compose |
v2.0+ |
多容器编排 |
docker compose 子命令形式 |
| 操作系统 |
Linux（内核 4.x+）/ Windows 10+ / macOS |
宿主机 |
生产推荐 Linux |
| 浏览器 |
Chrome / Edge / Firefox 最新版 |
前端访问 |
需支持 HLS、ES2020 |
2. 容器化组件（由 docker-compose 自动拉取/构建，无需手动安装）
| 组件 |
版本 |
用途 |
默认宿主端口 |
| 前端（Umi4 静态资源） |
随构建 |
Web 界面 |
4010 → 容器 80 |
| 后端（NestJS） |
Node 运行时 |
REST API + WebSocket |
同 4010（Nginx 反代） |
| MySQL |
8.0 |
业务数据库 |
4012 → 3306 |
| Nginx-RTMP / FFmpeg |
- |
RTMP 收流、HLS 分发 |
4015 → 1935 |
3. 本地开发依赖（非 Docker 手动部署时）
3.1 前端
- Node.js 16+（建议 18 LTS）
- 包管理器：npm / pnpm（注意 lockfile 版本匹配；如 pnpm 与 lockfile 冲突可直接使用本地
node_modules/.bin/umi）
- 关键依赖：Umi 4、React 18、Ant Design 5、Leaflet、hls.js
3.2 后端
- Node.js 16+（建议 18 LTS）
- 关键依赖：NestJS、TypeScript、MySQL 驱动、JWT、WebSocket（ws）
- 外部服务：可连接的 MySQL 8.0 实例
3.3 监控算法端（ai-end）
- Python 3.9+
- 关键依赖：Ultralytics YOLO、OpenCV、FFmpeg（系统二进制）、WebSocket 客户端
- 模型文件：
yolov8n.pt（项目内已附带轻量版，可按需更换）
- 可选：NVIDIA GPU + CUDA 以加速推理
4. 网络与端口
| 端口 |
协议 |
方向 |
说明 |
| 4010（可配置） |
TCP/HTTP |
入站 |
Web 访问、API、HLS |
| 4012（可配置） |
TCP |
内部 |
MySQL，建议不对公网开放 |
| 4015（可配置） |
TCP |
入站 |
RTMP 推流 |
| 摄像头源端口 |
TCP/UDP |
出站 |
访问摄像头 RTSP/RTMP 源 |
5. AI 对话可选依赖
- TokenFree 账号及 API Key（
sk- 开头）
- 默认接口地址：
https://www.tokenfree.com/v1
- 默认模型：
kimi-k2.6
- 浏览器需能访问该接口地址（出网）
6. 默认账号（来源：backend/src/database-seeder.ts）
| 角色 |
账号 |
密码 |
| 管理员 |
admin |
admin123 |
| 操作员 |
operator |
123456 |
交付上线前务必修改默认密码，并限制数据库端口暴露。
