safesight-edge/docs/deployment.md

RK3588 Media Server 部署指南

架构说明

┌─────────────────┐     ┌─────────────────┐
│  Media Server   │     │  RK3588 Agent   │
│  (systemd)      │◄────│  (systemd)      │
│  高可用独立服务  │     │  监控/控制      │
└─────────────────┘     └─────────────────┘
         │                       │
         ▼                       ▼
   RTSP 输出流             Web 管理界面
   HLS 输出流              http://IP:9100

• Media Server: 独立的 systemd 服务，高可用（崩溃自动重启）
• Agent: 独立的 systemd 服务，通过 systemctl 监控和控制 Media Server
• 两者可独立重启: 重启 Agent 不会影响 Media Server

---

快速开始

1. 编译

在 RK3588 设备上编译：

cd ~/apps/OrangePi3588Media

# 编译 Media Server
mkdir -p build && cd build
cmake .. -DCMAKE_BUILD_TYPE=Release
make -j$(nproc)

# 编译 Agent
cd ../agent
go build -o rk3588-agent_linux_arm64 ./cmd/rk3588-agent

2. 安装

cd ~/apps/OrangePi3588Media
sudo ./scripts/manage.sh install

安装过程会提示选择配置文件：

• test_cam1_face_det_rtsp_server.json - 人脸检测（推荐）
• sample_cam1_native_rtsp_face.json - 完整功能
• test_cam1_face_det_recog_rtsp_server.json - 人脸识别
• sample_cam1.json - 完整功能（需手动修复）

3. 查看状态

sudo ./scripts/manage.sh status

显示内容：

• 系统运行时间
• NPU 负载
• Media Server 状态（PID、CPU/内存、端口）
• Agent 状态
• 最近日志

4. 卸载

sudo ./scripts/manage.sh uninstall

---

升级

cd ~/apps/OrangePi3588Media

# 1. 拉取最新代码
git pull

# 2. 重新编译
mkdir -p build && cd build
cmake .. -DCMAKE_BUILD_TYPE=Release
make -j$(nproc)

cd ../agent
go build -o rk3588-agent_linux_arm64 ./cmd/rk3588-agent

# 3. 重新安装
cd ..
sudo ./scripts/manage.sh install

---

管理命令

Media Server（独立服务）

# 启动/停止/重启
sudo systemctl start media-server
sudo systemctl stop media-server
sudo systemctl restart media-server

# 查看状态
sudo systemctl status media-server

# 查看日志
sudo journalctl -u media-server -f

Agent（独立服务）

# 启动/停止/重启（不影响 Media Server）
sudo systemctl start rk3588-agent
sudo systemctl stop rk3588-agent
sudo systemctl restart rk3588-agent

# 查看状态
sudo systemctl status rk3588-agent

# 查看日志
sudo journalctl -u rk3588-agent -f

Web 管理界面

http://<设备IP>:9100

功能：

• 查看 Media Server 运行状态
• 启动/停止/重启 Media Server（通过 systemctl）
• 查看配置信息

---

配置修改

编辑配置文件：

sudo nano /opt/rk3588-media-server/etc/media-server.json

修改后重启 Media Server：

sudo systemctl restart media-server

---

目录结构

/opt/rk3588-media-server/
├── bin/
│   ├── media-server          # 主程序
│   └── plugins/              # 插件
├── etc/
│   └── media-server.json     # 配置文件
├── models/                   # AI 模型
├── logs/                     # 日志
└── web/hls/                  # HLS 输出

/opt/rk3588-agent/
├── rk3588-agent              # Agent 程序
└── agent.config.json         # Agent 配置

---

故障排查

服务无法启动

# Media Server 错误
sudo journalctl -u media-server -n 50

# Agent 错误
sudo journalctl -u rk3588-agent -n 50

检查 NPU

cat /sys/kernel/debug/rknpu/load
ls /dev/rknpu

RTSP 测试

# 本地测试
ffplay rtsp://localhost:8555/live/cam1_face_det

# 远程测试
ffplay rtsp://<设备IP>:8555/live/cam1_face_det

---

系统要求

• 硬件: Orange Pi 5 Plus (RK3588)
• 系统: Ubuntu 22.04 LTS (ARM64)
• 依赖: RKNN Runtime, MPP, FFmpeg