KJX ENGINEERING GUIDE · 06
Raspberry Pi 相机服务部署与运维
从相机识别、服务自启、健康检查到日志轮转，形成可交付的边缘相机服务。
参考流程 · 系统镜像需复核
中级
参考学习时长 2–4 小时
核查 2026-08-09
Raspberry Pi 5 / Camera Module 2 / rpicam-apps
公开资料核对，不使用未经确认的整机照片。
适用说明：本手册用于 Raspberry Pi OS、Picamera2/rpicam-apps 与受支持 CSI 相机。实施时请以目标板卡、固件和外设的实际版本为准；正式交付的功能、资料与验收标准以订单或技术协议为准。
返回配置：Raspberry Pi 相机采集与数据网关开发 · 同版参考基线。手册是适用范围内的工程参考，不代表所选配置已经完成实测。
准备与目标
适用范围Raspberry Pi OS、Picamera2/rpicam-apps 与受支持 CSI 相机
实施方式参考流程 · 系统镜像需复核；按目标硬件执行并记录结果
开始前准备
- 官方或授权板卡
- 匹配 CSI 相机与排线
- 稳定电源
- 可更新的系统镜像
完成后应得到
- 相机能力可查询
- 服务异常可恢复
- 日志和版本可审计
01 · 相机冒烟
先用官方工具确认相机和格式，不从业务应用开始排错。
- 记录系统、内核和相机信息。
- 完成预览、抓拍和短视频测试。
- 确认分辨率、帧率和旋转。
✓ 相机被系统识别✓ 三种基础操作通过✓ 接口和排线已记录
02 · 服务化
业务进程必须有独立账号、健康检查和明确依赖。
- 建立最小服务与配置文件。
- 设置网络和相机设备依赖。
- 验证开机自启、进程退出和自动恢复。
✓ 重启后自动可用✓ 失败状态可见✓ 配置与代码分离
03 · 运维与更新
限制日志和缓存，更新前保留可回滚版本。
- 配置日志轮转和磁盘阈值。
- 保存服务版本、系统镜像和配置摘要。
- 在测试环境模拟网络/相机服务中断；磁盘满使用受限测试分区或配额模拟，不填满系统盘。CSI 排线需要变更时先关机断电。
✓ 磁盘不会被日志占满✓ 更新可回滚✓ 三类故障有处置记录
停止条件：先备份测试数据并确认恢复路径，不在客户生产设备上直接做破坏性故障演练。
故障定位
| 现象 | 常见原因 | 建议动作 |
|---|---|---|
| 服务启动但无画面 | 相机被占用、权限、接口或格式不匹配 | 停止业务服务并回到官方相机工具确认基础链路。 |
验收与归档
- 相机基础测试通过
- 开机自启和恢复通过
- 日志轮转已验证
- 系统/服务版本已归档
建议随订单保存：板卡/PCB 版本、固件与依赖版本、BOM 修订号、操作人、测试日期、原始日志、异常样本和最终结论，方便后续复现、维护与售后。
