返回更新列表
新发布Aug 11, 2026

zoneminder v1.38.4

ZoneMinder 是一款免费、开源的闭路电视软件应用程序,专为 Linux 开发,支持 IP、USB 和模拟摄像头。

分享

ZoneMinder

加入 Slack drawing

ZoneMinder 的所有文档现已在线发布于 https://zoneminder.readthedocs.org

概述

ZoneMinder 是一套集成应用程序,提供完整的监控解决方案,可对连接到 Linux 机器的任何 CCTV 或安防摄像头进行采集、分析、录制和监控。它设计用于支持 Video For Linux (V4L) 接口的发行版,并已通过连接到 BTTV 卡、各种 USB 摄像头的视频摄像头测试,同时也支持大多数 IP 网络摄像头。

联系开发团队

在我们的 github 论坛创建 issue 之前,请先阅读我们的发帖规则: https://github.com/ZoneMinder/ZoneMinder/wiki/Github-Posting-Rules

安装方法

从软件包仓库安装

这是将 ZoneMinder 安装到系统中的推荐方法。ZoneMinder 软件包为以下发行版维护:

如果您的发行版没有可用的托管 ZoneMinder 软件包的仓库,建议您自行构建软件包,而不是从源码构建。虽然各发行版各有不同之处,但它们通常足够相似,可以让您将其他发行版的软件包构建说明适配到自己的发行版。

使用 Docker 运行

amd64 和 arm64 的官方镜像位于 Docker Hub 上,名称为 zoneminder/zoneminder,同时也位于 GitHub Container Registry 上,名称为 ghcr.io/zoneminder/zoneminder。CI 每天从 zmrepo 软件包重新构建它们。

  • latest:最新版本。当 zmrepo 发布新的次版本(1.40、1.42)时,它会随之更新。
  • 1.38、1.38.6 等:固定到某个发布系列或确切版本。
  • dev:master 的每夜构建。请勿在您依赖的系统上运行它们。
  • 每个标签都有一个带事件服务器(zmeventnotificationNg)的 -es 版本:latest-es、1.38-es。

zmdockerfiles 仓库包含一个 compose 文件,可运行 ZoneMinder 与 MariaDB,以及一个可选的目标检测容器:

git clone https://github.com/ZoneMinder/zmdockerfiles.git
cd zmdockerfiles
cp .env.example .env     # set ZM_DB_PASS, MARIADB_ROOT_PASSWORD and TZ
docker compose up -d

然后打开 http://localhost:8080/zm。请在 zmdockerfiles 仓库中提交 Docker 相关问题。

不鼓励从源码构建

历史上,将 ZoneMinder 安装到系统上需要从源代码构建,即执行传统的 configure、make、make install 命令。为了让 ZoneMinder 能够构建,必须事先确定并安装其所有依赖项。构建完成后,还必须手动将 init 和 logrotate 脚本复制到相应位置。诸如 jscalendar 和 Cambozola 之类的可选软件包必须手动安装。卸载可能会留下残留文件,这可能在升级过程中引发问题。说到升级,当需要升级时,所有这些手动步骤都必须再次重复。

如今已有更好的方法可以为你完成大部分工作。当前的开发团队以及其他志愿者已经取得了长足进展,提供了避免从源码构建所需的资源。

构建 ZoneMinder 软件包

将 ZoneMinder 构建成软件包并不比从源码构建更难。事实上,如果你过去曾成功从源码构建过 ZoneMinder,那么你可能会发现这些步骤更加简单。

在构建软件包时,最好在专门用于开发目的的独立环境中进行此工作。这可以简单到创建一台虚拟机、使用 Docker 或使用 mock。只需一次“失误”,你就会后悔在生产服务器上做这项工作。

最后,如果你希望从 master 分支构建开发快照,建议你先使用 ZoneMinder 的官方发行版构建软件包。这将有助于判断你遇到的任何问题是由构建过程引起的,还是 master 分支中的新问题。

请访问我们的 ReadtheDocs 站点 获取针对各发行版的说明。

软件包维护者

许多 ZoneMinder 配置变量的默认值无法在构建时通过 autotools 或 cmake 进行配置。新增了一个名为 zmeditconfigdata.sh 的工具,允许软件包维护者在不修补源码的情况下操作存储在 ConfigData.pm 中的任何变量。

例如,假设我创建了一个新的 ZoneMinder 软件包,其中包含 cambozola javascript 文件。然而默认情况下 cambozola 支持是关闭的。要解决这个问题,请将以下内容添加到打包脚本中:

./utils/zmeditconfigdata.sh ZM_OPT_CAMBOZOLA yes

请注意,zmeditconfigdata.sh 应在运行 cmake 或 configure 之前,从根构建文件夹中调用。

贡献模式与开发

非常欢迎提交 Pull Request!如果您想做出贡献,请遵循以下步骤。其中第 3 步为可选步骤,但推荐执行。

  1. Fork 该仓库
  2. 在我们的 GitHub Issues Tracker 中提交一个 issue。 请按照 issue 模板描述您发现的 bug 或安全问题。请注意,功能请求或疑问应发布在我们的用户论坛或 Slack 频道中。
  3. 创建您的功能分支(git checkout -b 456-my-new-feature)
  4. 提交您的更改(git commit -am 'Added some feature') 建议您“尽早且频繁地提交”,而不是将所有更改集中到单个提交中。
  5. 将您的分支推送到您在 github 上的 fork(git push origin 456-my-new-feature)
  6. 创建新的 Pull Request
  7. 团队随后将进行审查、讨论,并有望合并您的更改。

分类