69 lines
2.6 KiB
Markdown
69 lines
2.6 KiB
Markdown
# 环境依赖清单
|
||
|
||
项目：智慧停车综合管理平台（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](https://www.tokenfree.com/) 账号及 API Key（`sk-` 开头）
|
||
- 默认接口地址：`https://www.tokenfree.com/v1`
|
||
- 默认模型：`kimi-k2.6`
|
||
- 浏览器需能访问该接口地址（出网）
|
||
|
||
## 6. 默认账号（来源：backend/src/database-seeder.ts）
|
||
|
||
| 角色 | 账号 | 密码 |
|
||
| --- | --- | --- |
|
||
| 管理员 | admin | admin123 |
|
||
| 操作员 | operator | 123456 |
|
||
|
||
> 交付上线前务必修改默认密码，并限制数据库端口暴露。
|