yaoa/eventserver-base

ZoneMinder EventServer Base 镜像文档

概述

ZoneMinder EventServer Base 是一个为ZoneMinder视频监控系统设计的Docker基础镜像，提供事件处理和管理功能。该镜像作为构建完整ZoneMinder监控解决方案的基础组件，负责处理监控事件的捕获、存储、检索和分析。

核心功能和特性

• 事件捕获与处理：实时捕获和处理来自ZoneMinder监控系统的事件
• 事件存储管理：高效存储和管理监控事件数据
• 事件检索接口：提供API接口用于查询和检索历史事件
• 可扩展架构：支持自定义事件处理器和插件
• 轻量级设计：优化的容器化设计，资源占用低

使用场景和适用范围

• 家庭和小型企业视频监控系统
• 中型到大型商业监控部署
• 安全监控中心事件管理系统
• 需要集中管理多个监控摄像头的场所
• 要求事件记录和检索功能的安全监控解决方案

使用方法和配置说明

基本使用

使用以下命令启动EventServer容器：

bash
docker run -d \
  --name zoneminder-eventserver \
  -p 9000:9000 \
  -e ZM_DB_HOST=db \
  -e ZM_DB_NAME=zoneminder \
  -e ZM_DB_USER=zmuser \
  -e ZM_DB_PASS=zmpass \
  docker.xuanyuan.run/zoneminder-containers/eventserver-base:latest

Docker Compose 配置示例

yaml
version: '3'

services:
  eventserver:
    image: docker.xuanyuan.run/zoneminder-containers/eventserver-base:latest
    container_name: zoneminder-eventserver
    ports:
      - "9000:9000"
    environment:
      - ZM_DB_HOST=db
      - ZM_DB_NAME=zoneminder
      - ZM_DB_USER=zmuser
      - ZM_DB_PASS=zmpass
      - ZM_EVENT_STORAGE_PATH=/var/cache/zoneminder/events
      - ZM_LOG_LEVEL=info
    volumes:
      - events_data:/var/cache/zoneminder/events
    depends_on:
      - db
    restart: unless-stopped

  db:
    image: docker.xuanyuan.run/mysql:5.7
    container_name: zoneminder-db
    environment:
      - MYSQL_DATABASE=zoneminder
      - MYSQL_USER=zmuser
      - MYSQL_PASSWORD=zmpass
      - MYSQL_ROOT_PASSWORD=rootpass
    volumes:
      - db_data:/var/lib/mysql
    restart: unless-stopped

volumes:
  events_data:
  db_data:

配置参数和环境变量

数据库配置

• ZM_DB_HOST: 数据库主机地址，默认值: db
• ZM_DB_PORT: 数据库端口，默认值: 3306
• ZM_DB_NAME: 数据库名称，默认值: zoneminder
• ZM_DB_USER: 数据库用户名，默认值: zmuser
• ZM_DB_PASS: 数据库密码，默认值: zmpass

存储配置

• ZM_EVENT_STORAGE_PATH: 事件存储路径，默认值: /var/cache/zoneminder/events
• ZM_EVENT_RETENTION_DAYS: 事件保留天数，默认值: 30

服务配置

• ZM_EVENT_SERVER_PORT: 事件服务器端口，默认值: 9000
• ZM_LOG_LEVEL: 日志级别，可选值: debug, info, warn, error，默认值: info
• ZM_MAX_EVENTS: 最大事件数量限制，默认值: 10000

扩展和自定义

EventServer Base 镜像支持通过挂载自定义配置文件和插件进行扩展：

bash
docker run -d \
  --name zoneminder-eventserver \
  -p 9000:9000 \
  -v /path/to/custom/config:/etc/zm-eventserver \
  -v /path/to/plugins:/usr/share/zm-eventserver/plugins \
  docker.xuanyuan.run/zoneminder-containers/eventserver-base:latest

维护和更新

定期更新镜像以获取最新功能和安全修复：

bash
docker pull docker.xuanyuan.run/zoneminder-containers/eventserver-base:latest
docker restart zoneminder-eventserver

故障排除

常见问题

1. 数据库连接问题: 确保数据库服务正常运行且连接参数正确
2. 事件存储问题: 检查存储卷挂载是否正确，确保有足够的磁盘空间
3. 性能问题: 对于大型部署，考虑增加内存资源或优化事件保留策略

查看日志

bash
docker logs zoneminder-eventserver