Doni/safesight
6
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
e9c2de53cd
safesight/docs/deployment/客户现场部署检查表.md
tian 29d9ef5d0d refactor: 项目结构梳理 - 设备端/管理端对称布局 
仓库结构:
  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 分区规则）
2026-08-02 11:39:54 +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 ~/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