gkirsteins/zoneminder.storage

Zoneminder 视频监控系统 Docker 镜像

镜像概述

本镜像基于 Ubuntu 22.04 LTS，集成 Zoneminder 1.37.20 和 MariaDB，提供全功能开源视频监控解决方案。支持本地数据库和外部数据库两种部署模式，已通过 Intel 芯片组硬件加速测试，可灵活适配从家庭到企业级的监控需求。

核心功能与特性

• 全功能监控系统：支持多种摄像头接入，可构建任意规模的监控系统
• 数据库灵活性：内置 MariaDB 支持本地数据库，同时提供外部数据库连接选项
• 硬件加速：支持 Intel 芯片组硬件加速（需配置设备映射）
• 数据持久化：事件、图像、配置等数据存储在容器外部，确保数据安全
• 时区配置：支持通过环境变量设置时区
• 日志管理：可配置日志大小和文件数量，避免日志过度占用空间

使用场景

• 家庭安全监控
• 办公室/商铺视频监控
• 自定义规模的安防系统部署
• 需要硬件加速的高清视频监控场景

使用方法与配置

FFMPEG 配置

若仅使用摄像头直通模式，可能无需配置FFMPEG。如需自定义，在Zoneminder选项中修改以下设置：

• PATH_FFMPEG= /usr/bin/ffmpeg
• FFMPEG_OUTPUT_OPTIONS= -r 30 -vcodec libx264 -threads 2 -b 2000k -minrate 800k -maxrate 5000k
• FFMPEG_FORMATS= mpg mpeg wmv asf mp4* avi mov swf 3gp

建议在FFMPEG_FORMATS中添加mp4（可在mp4后添加*并移除avi后的*，使mp4成为默认格式）。

存储配置

所有数据存储在容器外部，通过卷映射实现持久化：

• /var/cache/zoneminder/（事件、图像和临时文件）
• 数据库文件
• Perl5 配置文件

可按存储需求单独映射各目录：

bash
-v /path_to_storageA/data:/config/data:rw
-v /path_to_storageB/perl:/config/perl:rw
-v /path_to_storageC/config/mysql:rw

部署示例

1. 本地数据库模式

bash
docker create -p 8080:80 --name=zoneminder \
--mount type=tmpfs,destination=/dev/shm,tmpfs-size=2G \
--mount type=tmpfs,destination=/tmp \
--restart=unless-stopped -p 6802:6802 \
-v /path_to_storage:/config:rw \
-e TZ="Europe/Riga" \
--log-opt max-size=10m --log-opt max-file=5 \
gkirsteins/zoneminder.storage:latest

docker run docker.xuanyuan.run/zoneminder

2. 外部数据库模式

创建数据库容器：

bash
docker create --name=mariadb --restart=unless-stopped \
-v ~/zm_video/r_mysql:/var/lib/mysql \
--restart=always \
-e TZ="Europe/Riga" -e MYSQL_ALLOW_EMPTY_PASSWORD=yes \
mariadb:latest

创建Zoneminder容器：

bash
docker create --name=zoneminder --restart=unless-stopped -p 8080:80 -p 6802:6802 \
-v ~/zm_video:/config \
--mount type=tmpfs,destination=/dev/shm,tmpfs-size=2G \
--mount type=tmpfs,destination=/tmp \
--privileged="true" \
--restart=always \
--log-opt max-size=10m --log-opt max-file=5 \
-e ZM_DB_USER=zmuser \
-e ZM_DB_PASS=zmpass \
-e ZM_DB_HOST=mariadb \
-e ZM_DB_NAME=zm \
-e TZ="Europe/Riga" gkirsteins/zoneminder.storage:latest

创建并连接网络：

bash
docker network create "Surveillance"
docker start mariadb
docker start zoneminder
docker network connect Surveillance mariadb zoneminder

3. 反向代理配置（Traefik v1）

在创建命令末尾添加以下标签：

bash
--net=traefik-net --label traefik.frontend.rule="PathPrefix:/zm;Host:your.dns.com" --label traefik.port=80

创建并连接Traefik网络：

bash
docker network create "traefik-net"
docker network connect traefik-net zoneminder

参数说明

硬件加速配置

如需启用硬件加速，添加设备映射参数：

bash
--device /dev/dri:/dev/dri

（已通过VAAPI选项测试）

常用操作命令

• Web访问：http://host_ip:port/zm/
• 修改Zoneminder状态：docker exec zoneminder /usr/bin/zmpkg.pl Daytime
• 进入容器：docker exec -it zoneminder bash
• 查看日志：docker logs zoneminder 或 docker logs zoneminder -f（实时日志）
• 触发报警（需启用OPT_TRIGGERS）：

  bash
  echo "7|on+5|6|cause|text|show text" | netcat xxx.xxx.xxx.xxx 6802
  

  其中：7=监控ID，on+5=报警持续时间，6=报警分数，xxx.xxx.xxx.xxx=Zoneminder服务器IP

升级与备份

从旧版本升级

1. 登录旧容器执行升级：

   bash
   apt update
   apt install zoneminder
   zmupdate.pl
   

2. 如监控异常，尝试修复：

   bash
   zmupdate.pl -f
   

3. 删除旧容器，使用:latest标签创建新容器

数据库备份与恢复

备份数据库：

bash
# 本地数据库
docker exec -it zoneminder zmpkg.pl stop
docker exec -it zoneminder mysqldump zm -u root > backup.sql

# 远程数据库（使用数据库容器名称）
docker exec -it zoneminder zmpkg.pl stop
docker exec -it [数据库容器名] mysqldump zm -u root > backup.sql

恢复数据库：

bash
# 远程数据库
cat backup.sql | docker exec -i mariadb mysql -u root zm

# 本地数据库
docker exec -it zoneminder zmpkg.pl stop
cat backup.sql | docker exec -i zoneminder mysql -u root zm

注意：外部数据库连接时，以下环境变量不可修改：

• ZM_DB_USER=zmuser
• ZM_DB_PASS=zmpass
• ZM_DB_NAME=zm
• ZM_DB_HOST=mariadb（需替换为实际数据库容器名称）