safesight-edge/docs/deployment.md

Edge 设备部署指南

首次部署（从 SD 卡克隆）

克隆前准备

在源设备上清理不需要的文件后关机，取出 SD 卡，使用 dd 或烧录工具克隆到新卡。

克隆后配置

将新 SD 卡插入新设备，开机，执行以下步骤：

1. 生成新的设备 ID

管理端通过设备 ID 区分不同设备，克隆后必须更换：

sudo rm -f /etc/machine-id /var/lib/safesight-edge-agent/device_id
sudo systemd-machine-id-setup

2. 重新生成 SSH 主机密钥

sudo rm -f /etc/ssh/ssh_host_*_key*
sudo ssh-keygen -A

3. 设置主机名

sudo hostnamectl set-hostname <新主机名>

4. 配置静态 IP（生产环境）

编辑 netplan 配置：

sudo nano /etc/netplan/01-network-manager-all.yaml

写入：

network:
  version: 2
  ethernets:
    enP4p65s0:              # 网卡名，用 ip addr 确认
      dhcp4: no
      addresses:
        - 10.0.0.82/24       # 目标 IP
      routes:
        - to: default
          via: 10.0.0.1      # 网关
      nameservers:
        addresses:
          - 10.0.0.1         # DNS

应用：

sudo netplan apply

5. 重启

sudo reboot

验证

# 确认服务状态
systemctl status safesight-edge-server safesight-edge-agent

# 确认新 IP
ip addr show | grep inet

# 确认新设备 ID
cat /var/lib/safesight-edge-agent/device_id

# 管理端发现新设备后，在设备详情页设置别名

---

更新部署

在设备上更新代码和二进制：

cd ~/apps/safesight-edge
git pull
bash scripts/build.sh -m -j4
sudo ./scripts/deploy.sh upgrade