dlandon/zoneminder.unraid Docker 镜像 - 轩辕镜像

Zoneminder Docker for Unraid 中文技术文档

镜像概述和主要用途

Zoneminder Docker for Unraid 是一个针对 Unraid 系统优化的 Docker 镜像，当前版本为 1.36。该镜像集成了开源视频监控软件 ZoneMinder 和事件通知服务 ZM Event Notification Server，旨在简化视频监控系统的部署流程。镜像预应用了必要的配置参数，用户无需手动修改即可完成首次运行，并支持从旧版本 ZoneMinder 平滑升级。

核心功能和特性

1. 组件集成：同时包含 ZoneMinder（视频监控核心）和 ZM Event Notification Server（事件检测与通知），实现监控与告警一体化。
2. 预配置优化：关键配置参数已预设置，首次启动无需手动调整，降低部署复杂度。
3. 版本兼容性：支持从旧版本 ZoneMinder 升级，保障监控数据和配置的连续性。
4. 安全访问：内置自签名证书，支持通过 HTTPS 安全访问 Web 界面及事件通知服务。
5. 故障排查机制：提供专用环境变量控制服务启动，便于容器故障时进行命令行调试。

使用场景和适用范围

• Unraid 用户：专为 Unraid 系统设计，适合在 Unraid 平台上快速部署视频监控解决方案。
• 轻量化部署需求：适用于希望减少手动配置步骤、快速搭建监控系统的用户。
• 事件通知场景：需要通过事件触发（如移动检测、区域入侵）发送告警的监控场景。
• 版本升级场景：已部署旧版本 ZoneMinder 并需要平滑迁移至新版本的用户。

详细使用方法和配置说明

访问方式

ZoneMinder Web 界面

• HTTPS 访问（默认）：通过 https://<主机IP>:8443/zm 访问 Web 管理界面。
• HTTP 访问（可选）：若启动容器时映射 80 端口（如 -p 8080:80/tcp），可通过 http://<主机IP>:8080/zm 访问。

ZM Event Notification Server

• 事件通知服务通过端口 9000 提供访问，地址为 https://<主机IP>:9000（依赖自签名证书）。

证书说明

镜像启用自签名证书以保障访问安全。iOS 设备使用事件通知功能时，可能需要手动安装该证书（具体步骤参考设备证书安装指引），否则通知可能无法正常推送。

环境变量配置

Docker 部署示例

docker run 命令

bash
docker run -d \
  --name zoneminder \
  -p 8443:443/tcp \  # HTTPS 端口（Web 界面）
  -p 8080:80/tcp \   # 可选，HTTP 端口（Web 界面）
  -p 9000:9000/tcp \ # ZM Event Notification Server 端口
  -e TZ=Asia/Shanghai \  # 可选，设置时区（如 Asia/Shanghai）
  # 建议挂载数据卷以持久化配置和监控数据（示例）：
  # -v /mnt/user/appdata/zoneminder/config:/etc/zm \  # ZoneMinder 配置
  # -v /mnt/user/appdata/zoneminder/mysql:/var/lib/mysql \  # MySQL 数据
  --restart unless-stopped \
  zoneminder-unraid:1.36

docker-compose 配置示例

yaml
version: '3'
services:
  zoneminder:
    image: zoneminder-unraid:1.36
    container_name: zoneminder
    ports:
      - "8443:443/tcp"   # HTTPS 端口（Web 界面）
      - "8080:80/tcp"    # 可选，HTTP 端口（Web 界面）
      - "9000:9000/tcp"  # ZM Event Notification Server 端口
    environment:
      - TZ=Asia/Shanghai  # 可选，设置时区
      # - NO_START_ZM="1"  # 故障排查时启用，不自动启动服务
    volumes:
      # 根据需求挂载数据卷（示例路径需替换为 Unraid 实际路径）
      # - /mnt/user/appdata/zoneminder/config:/etc/zm
      # - /mnt/user/appdata/zoneminder/mysql:/var/lib/mysql
    restart: unless-stopped

故障排查

容器启动失败处理

当容器无法正常启动时，可通过以下步骤定位问题：

1. 启用故障排查模式
   启动容器时添加环境变量 NO_START_ZM="1"，此时 MySQL 和 ZoneMinder 服务不会自动启动，容器将保持运行状态。

2. 进入容器命令行
   通过 docker exec -it zoneminder /bin/bash 进入容器内部。

3. 手动启动服务并调试
   在容器内执行以下命令手动启动服务，观察输出日志定位错误：

   bash
   service mysql start       # 启动 MySQL 服务
   service zoneminder start  # 启动 ZoneMinder 服务
   

   根据命令输出的错误信息（如配置文件错误、端口冲突等）进行针对性修复。