Doni/safesight
6
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
a1064961cc
safesight/docs/客户现场部署检查表.md
tian a1064961cc docs: 客户现场部署检查表移入 control 仓库 
- 新增 docs/客户现场部署检查表.md
- 更新为产品镜像批量生产流程（16G 母卡 -> Etcher 批量烧录 -> init-device.sh 初始化）
- 新增断电保护(overlayroot)维护备忘章节
2026-08-01 16:46:44 +08:00

5.4 KiB
Raw Blame History

客户现场部署检查表

一、硬件

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 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.md）
  • 离线部署文档电子版（docs/离线部署文档.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