gagara/shinobi-arm64

适用于aarch64的Shinobi CCTV镜像

Shinobi是开源的闭路电视（CCTV）解决方案。本镜像支持树莓派（https://github.com/raspberrypi/userland和V4L2 M2M）及瑞芯微（Rockchip）（https://github.com/rockchip-linux/mpp）系列板子（如Rock64）的硬件加速。

Dockerfile

本镜像基于https://gitlab.com/gagara/Shinobi/-/raw/aarch64/Dockerfile.aarch64构建。

仓库

镜像基于官方Shinobi的https://gitlab.com/gagara/Shinobi。

运行

docker run -d \
    --name="shinobi" \
    --privileged \
    -p "8080:8080/tcp" \
    -v "/dev/shm/Shinobi/streams":"/dev/shm/streams":"rw" \
    -v "/dev":"/dev":"rw" \
    -v "/var/cache/shinobi/config":"/config":"rw" \
    -v "/var/cache/shinobi/customAutoLoad":"/home/Shinobi/libs/customAutoLoad":"rw" \
    -v "/var/cache/shinobi/database":"/var/lib/mysql":"rw" \
    -v "/var/cache/shinobi/videos":"/home/Shinobi/videos":"rw" \
    -v "/var/cache/shinobi/plugins":"/home/Shinobi/plugins":"rw" \
    -v "/etc/localtime":"/etc/localtime":"ro" \
    docker.xuanyuan.run/gagara/shinobi-arm64:latest

或直接使用https://gitlab.com/gagara/Shinobi/-/raw/aarch64/docker-compose-aarch64.yaml：

docker-compose -f docker-compose-aarch64.yaml up

建议在运行前将外部SSD/HDD挂载到/var/cache/shinobi目录（该目录存储视频、图片和数据库文件）。

构建

若需自行构建镜像，请克隆仓库并切换到aarch64分支：

git clone https://gitlab.com/gagara/Shinobi.git
cd Shinobi/
git checkout aarch64

然后构建镜像：

docker build -t gagara/shinobi-arm64 -f Dockerfile.aarch64 .

注意：最新镜像基于Gentoo，因此从头构建可能需要大量时间和资源。可通过Docker构建参数传递Gentoo https://wiki.gentoo.org/wiki/Binary_package_guide列表（空格分隔）优化构建过程。例如：

docker build -t gagara/shinobi-arm64 --build-arg BINHOST="https://packages.server.com" -f Dockerfile.aarch64 .

默认使用https://packages.genpi64.com/作为binhost。

如何配置Shinobi硬件加速

树莓派

树莓派有两种加速选项：

• MMAL
• V4L2 M2M

MMAL

支持h264、mpeg2、mpeg4、vc1解码器。

注意：MMAL目前尚未正式支持aarch64。若遇到问题，建议切换到支持更完善且性能更好的v4l2m2m。

1. 确保主机已启用DRM支持（提供/dev/dri设备，如/dev/dri/card0）。若没有这些设备，请参考发行版文档启用DRM，通常需在config.txt中开启dtoverlay=vc4-fkms-v3d并设置足够的显存（gpu_mem=128至少）。
2. 在Shinobi监控设置中：

• 输入
  • 加速器 - Yes
  • 加速引擎 - DRM
  • 视频解码器 - H.264 (Raspberry Pi)
  • 硬件加速设备 - /dev/dri/card0

V4L2 M2M

支持h263、h264、h265、mpeg1、mpeg2、mpeg4、vc1、vp8、vp9解码器及h263、h264、h265、mpeg4、vp8编码器，正式支持aarch64！

1. 确保主机已启用v4l2（系统需有/dev/video10、/dev/video11等设备）。若没有，请参考发行版文档启用。
2. 在Shinobi监控设置中：

• 输入
  • 加速器 - Yes
  • 加速引擎 - Auto
  • 视频解码器 - V4L2 mem2mem H.264 (Raspberry Pi)
  • 硬件加速设备 - （留空）

注意：树莓派硬件加速存在以下限制：

• MMAL和v4l2m2m均支持最高1080p分辨率，若相机为3-4MP，需将分辨率降至1080p或更低。
• 硬件解码器需要大量显存，处理1路1080p流至少需128MB显存。树莓派4最大显存设置为512MB，因此最多可并行处理4路流。
• 实验表明，并行运行多个进程时（如连接多个相机），解码器性能会显著下降。例如，单路1080p h264流的ffmpeg进程占单个CPU核心约10%，但4路并行时每个进程占比约50%。

幸运的是，Shinobi支持子流处理。若相机支持子流（通常为低分辨率），可用于Shinobi，大幅提升性能且不影响体验。请阅读下节关于子流的内容。

在Shinobi中使用子流

多数情况下，运动检测不需要相机的全分辨率、高帧率等。Shinobi默认使用640x480、2fps的灰度图像，足够满足需求。若直接抓取1080p、25fps的流，需消耗大量CPU/GPU时间转码为低质量图像供运动检测引擎使用。 现代相机大多支持多流：主流程（全分辨率、高质量）和子流（低分辨率）。 可配置Shinobi使用主流程录制，子流用于运动检测和直播（实时查看）。详情见Shinobi多流文档。 例如：

• 在连接部分（主输入流）使用相机子流，索引为0。
• 在附加输入映射：1部分使用相机主流程，索引为1。
• 在流部分使用输入流0。
• 在全局检测器设置部分使用输入流0。
• 在传统录制部分使用输入流1。

建议将相机子流分辨率配置为与全局检测器设置中的分辨率一致。

这种设置在树莓派4上连接6台3MP h264相机时，CPU负载可控制在20%以下。

瑞芯微（Rockchip）

瑞芯微对视频硬件解码（https://github.com/rockchip-linux/mpp）支持强大。

MPP

支持h264、h265、vp8、vp9解码器。

1. 确保主机已启用DRM支持（提供/dev/dri设备，如/dev/dri/card0）。若没有，请参考发行版文档启用。
2. 在Shinobi监控设置中：

• 输入
  • 加速器 - Yes
  • 加速引擎 - DRM
  • 视频解码器 - H.264 (RockChip)
  • 硬件加速设备 - /dev/dri/card0

在测试系统（Rock64板子）上，连接6台3MP h264相机（全分辨率）时，CPU负载可控制在40%以下，性能远优于树莓派。

若结合上述子流设置，性能可进一步提升。