tian
29d9ef5d0d
仓库结构: edge/ 设备端（原根目录设备端代码整体移入） control/ 管理端（清理后） docs/ 文档（PRD 移入 design/） README.md 根导航（新增） 清理: - control/.brainstorm 临时草稿删除 - control 根级重复文档(API表/PRD_04)并入 docs/design/ - control/plan.md -> docs/implementation/control-plan.md - control/safesightd-linux-arm64 二进制取消版本控制(.gitignore) - edge/transform 模型转换产物归入 models/，onnx/pt 大源文件取消跟踪(.gitignore) - Readme.md(PRD) -> docs/design/PRD_Product_v1.2.md（避开 README 大小写冲突） 更新: - 根 README.md 导航、docs/README.md 文档索引 - deployment.md/检查表路径加 edge/ 前缀 - .gitignore 重写（edge/control 分区规则）
157 lines
5.4 KiB
Markdown
157 lines
5.4 KiB
Markdown
# 客户现场部署检查表
|
||
|
||
## 一、硬件
|
||
|
||
### Edge 设备
|
||
|
||
- [ ] Orange Pi 5 Plus (RK3588) × ____ 台
|
||
- [ ] Orange Pi 5 (RK3588S) × ____ 台
|
||
- [ ] 电源适配器（与设备配套）× 每台1个
|
||
- [ ] SD 卡（已烧录系统） × 每台1张 + 备用2张
|
||
- [ ] SD 卡复制器 × 2
|
||
|
||
### 网络
|
||
|
||
- [ ] 交换机 / 路由器
|
||
- [ ] 网线 × ____ 根
|
||
- [ ] 插线板 / 延长线 × ____ 个
|
||
|
||
### 调试工具
|
||
|
||
- [ ] Windows 笔记本
|
||
- [ ] Mac 笔记本
|
||
- [ ] 标签打印机（含打印纸）
|
||
- [ ] USB 转串口模块（调试用）
|
||
- [ ] HDMI 线 + 便携显示器（调试 Orange Pi 用）
|
||
- [ ] USB 键盘/鼠标（调试 Orange Pi 用）
|
||
- [ ] U 盘（备用传输部署包）
|
||
- [ ] 手机数据线（Type-C/USB，如需刷机）
|
||
|
||
---
|
||
|
||
## 二、软件 & 部署包
|
||
|
||
### 管理端（Control Server）
|
||
|
||
- [ ] `safesight-control-*.tar.gz`（管理端部署包，含 ARM64/AMD64 二进制）
|
||
- 生成方式：`cd safesight-control && bash scripts/package.sh`
|
||
- [ ] 管理端目标部署位置确认：独立服务器 / 某台 Edge 设备
|
||
|
||
### Edge 端
|
||
|
||
- [ ] `safesight-upgrade-*.tar.gz`（Edge 离线升级包）
|
||
- 生成方式：在 3588 设备上执行 `cd ~/apps/safesight/edge && bash scripts/package-offline.sh`
|
||
- [ ] 预烧录的系统 SD 卡（含 `safesight-edge-server` + `safesight-edge-agent`）
|
||
- [ ] 预烧录的系统 SD 卡（**含 /data 数据分区**，断电保护用；需在母卡镜像中划分）
|
||
- [ ] SD 卡镜像文件（备用）
|
||
- [ ] **产品镜像文件** `safesight-product-*.img.gz`（16G 母卡出厂化后生成，官方镜像同款体积）
|
||
- 生成方式：16G 母卡部署 → `setup-overlayroot.sh install --yes` 建 /data → `disable` → `prepare-image.sh` 出厂化 → `dd | gzip`（或 Win32DiskImager 读取）
|
||
|
||
### 笔记本工具
|
||
|
||
- [ ] SSH 客户端（Putty / Windows Terminal / macOS Terminal）
|
||
- [ ] SCP 工具（scp / WinSCP / FileZilla）
|
||
- [ ] 串口终端（PuTTY / minicom / screen）
|
||
- [ ] IP 扫描工具（Advanced IP Scanner / nmap / arp-scan）
|
||
- [ ] SD 卡烧录工具（Balena Etcher / Win32 Disk Imager / dd）
|
||
- [ ] VS Code / 文本编辑器
|
||
|
||
---
|
||
|
||
## 三、配置参数（提前确认）
|
||
|
||
### 网络规划
|
||
|
||
- [ ] 管理端 IP：______________（如 192.168.1.xxx）
|
||
- [ ] Edge 设备 IP 分配表：
|
||
|
||
| 序号 | 设备型号 | IP | 用途 |
|
||
|------|----------|----|------|
|
||
| 1 | | | |
|
||
| 2 | | | |
|
||
| 3 | | | |
|
||
|
||
### 摄像头
|
||
|
||
- [ ] RTSP 地址清单（CSV 格式，含摄像头编号、名称、RTSP 地址）
|
||
|
||
### 关键 Token / 密码
|
||
|
||
- [ ] Agent Token：`4fe2d69fda23d0d5d04a1486d4920e68`
|
||
- [ ] Edge 设备 SSH：`orangepi / orangepi`
|
||
- [ ] 管理端访问密码（如已设置）：______________
|
||
|
||
### 第三方服务（如需要）
|
||
|
||
- [ ] 告警服务地址：______________
|
||
- [ ] 对象存储（MinIO）地址及凭证：______________
|
||
|
||
---
|
||
|
||
## 四、部署流程
|
||
|
||
### 4.1 设备接线
|
||
|
||
- [ ] 设备插 SD 卡、接电源、插网线
|
||
- [ ] 确认设备通电，交换机指示灯正常
|
||
- [ ] 扫描确认所有设备 IP 可达
|
||
|
||
### 4.2 Edge 设备初始化（产品镜像批量烧录）
|
||
|
||
- [ ] 用 Balena Etcher 烧录 `safesight-product-*.img.gz` 到 **64G 产品 SD 卡**（批量，带校验）
|
||
- [ ] 插卡上电，IP 扫描找到设备（出厂为 DHCP），SSH 登录（orangepi/orangepi）
|
||
- [ ] 执行单台初始化：`sudo /opt/safesight-edge-server/scripts/init-device.sh --hostname <名> --ip <IP/掩码> --gw <网关> --dns <DNS>`（自动扩容 /data 到 64G + 启用断电保护）
|
||
- [ ] `sudo reboot` 重启生效
|
||
- [ ] 验证：`sudo .../setup-overlayroot.sh verify`（断电保护）+ `df -h /data`（应为 ~55G）+ 服务正常
|
||
- [ ] 贴设备标签（编号、IP）
|
||
|
||
### 4.3 部署管理端
|
||
|
||
- [ ] 上传控制端部署包
|
||
- [ ] 安装：`sudo cp safesightd-linux-arm64 /opt/safesightd/bin/safesightd`
|
||
- [ ] 配置 `safesightd.json`（IP、端口、token）
|
||
- [ ] 安装 systemd 服务，启动
|
||
- [ ] 浏览器验证 `http://<管理端IP>:18080`
|
||
|
||
### 4.4 配置下发
|
||
|
||
- [ ] 管理端发现所有 Edge 设备
|
||
- [ ] 导入摄像头 CSV
|
||
- [ ] 上传模型文件
|
||
- [ ] 配置人脸库
|
||
- [ ] 部署向导：选择设备 → 勾选功能 → 下发配置
|
||
- [ ] 验证每个摄像头的 RTSP 推流和算法运行
|
||
|
||
### 4.5 告警联调（如需要）
|
||
|
||
- [ ] 确认告警服务可访问
|
||
- [ ] 管理端 → 集成服务 → 配置告警地址
|
||
- [ ] 触发测试告警，验证告警中心收到
|
||
|
||
### 4.6 验收
|
||
|
||
- [ ] 所有设备在线，状态绿灯
|
||
- [ ] 摄像头画面正常
|
||
- [ ] 模型推理结果正确
|
||
- [ ] 告警上报正常
|
||
- [ ] 管理端各项功能可用
|
||
|
||
---
|
||
|
||
## 五、应急
|
||
|
||
- [ ] 备用 SD 卡（含完整系统镜像）
|
||
- [ ] 备用网线 × 2
|
||
- [ ] 备用电源适配器 × 1
|
||
- [ ] 客户网络/IT 联系人：______________
|
||
- [ ] 部署文档电子版（docs/deployment/deployment.md）
|
||
- [ ] 离线部署文档电子版（docs/deployment/离线部署文档.md）
|
||
|
||
## 六、断电保护（overlayroot）维护备忘
|
||
|
||
- [ ] 设备进入维护模式（装软件/改配置）：`sudo /opt/safesight-edge-server/scripts/setup-overlayroot.sh disable` → `sudo reboot`
|
||
- [ ] 维护完成后恢复保护：`sudo /opt/safesight-edge-server/scripts/setup-overlayroot.sh enable` → `sudo reboot`
|
||
- [ ] 状态/验证：`sudo /opt/safesight-edge-server/scripts/ops.sh overlay-status` 或 `overlay-verify`
|
||
- [ ] 现场遇到断电无法启动：先换备用 SD 卡，再排查 /data 分区
|
||
- [ ] /data 分区告警（写满/损坏）处理：日志→/data/safesight/logs，告警→/data/safesight/{alarms,clips}，设备ID→/data/safesight/agent/device_id
|