项目接管 2022

在历经6年多的zmNinja + ES + ML开发之后，Pliable Pixels已无暇继续维护该项目。ZoneMinder开发团队将接替对zmNinja的支持，并负责今后的通知服务提供工作。由于部分应用商店政策的要求，这可能需要使用新的应用名称。

zmNinja官网

zmNinja是一款跨平台（iOS、Android、Windows桌面版、Mac桌面版、Linux桌面版）的客户端，专为ZoneMinder用户设计。ZoneMinder是一款功能强大的开源监控系统，广泛应用于家庭及商业安防监控领域。

帮助

• 官方文档在此
• 如果您正在寻找由机器学习驱动的事件服务器伴侣，其文档在此
• 请前往ZoneMinder移动应用论坛发帖，或在ZoneMinder的Slack频道中联系我（您可在此加入）
• 若您认为发现了程序错误，请在GitHub上提交问题

寻求帮助前

• 请务必阅读常见问题解答
• 请确保已验证您的API是否正常工作（若未通过，则属于ZoneMinder的问题，请至ZoneMinder论坛发帖）
• 若您不熟悉移动应用开发，请勿向我寻求源码编译方面的帮助——建议您先尝试自行解决问题

视频演示

请观看zmNinja的视频演示此处

移动平台

截至今日，zmNinja运行稳定，支持多种Android和iOS设备。请参阅上方链接，在Play商店（Android）和App Store（iOS）下载。

此外，它也支持桌面端运行（见下文）。

桌面平台

请从此处下载二进制文件。

主要特性

• 推送通知 对于报警，支持物体检测/人脸识别（需先设置事件服务器）
• 多语言支持（英语、法语、德语、西班牙语、葡萄牙语、荷兰语等）
• H264视频支持
• 监控画面实时查看
• 拼图视图（支持多种拼图布局与尺寸）
• 事件历史与列表
• 时间线视图
• 摄像头云台控制（需先由ZoneMinder支持）
• 24小时回放

主要限制

• 不支持客户端证书
• 若使用自签名证书，您可能需要将其安装到手机中（尤其是Android设备）
• 若使用基本认证，还需进行额外的配置（详见常见问题解答）

致谢

感谢Pliable Pixels为ZoneMinder社区构建这款应用所作出的卓越贡献。

重要提示

• zmNinja需要在ZoneMinder中启用API功能。请参阅此页，了解如何确认您的API是否正常工作。若API无法正常工作，zmNinja将无法运行。

截图：

zmNinja 快速上手指南

zmNinja 是一款跨平台（iOS、Android、Windows、Mac、Linux）客户端，专为开源监控系统的 ZoneMinder 设计。它支持实时查看、事件回放、云台控制以及基于机器学习的智能报警推送。

环境准备

系统要求

• 服务端：必须已安装并运行 ZoneMinder 监控系统。
• 客户端平台：
  • 移动端：iOS (App Store) 或 Android (Google Play)。
  • 桌面端：Windows、macOS 或 Linux。
• 网络配置：
  • ZoneMinder 必须启用 API 接口（zmNinja 强依赖 API 通信）。
  • 若使用自签名 SSL 证书，需提前将证书导入移动设备信任库（Android 尤其需要）。
  • 若使用 Basic Authentication，需在服务端进行额外配置。

前置依赖检查

在部署客户端前，请确保服务端 API 正常工作。访问以下地址验证（替换为您的服务器 IP）： http://<your-zm-ip>/zm/api/host/getVersion.json 如果无法返回 JSON 数据，请先解决 ZoneMinder 服务端配置问题，否则 zmNinja 无法连接。

注意：如需使用对象检测/人脸识别推送功能，服务端还需部署 zmeventnotification 事件服务器。

安装步骤

1. 移动端安装 (推荐)

直接通过官方应用商店下载，这是最稳定且自动更新的途径。

• iOS: 访问 App Store 搜索 zmNinja Pro 或点击链接： Download on the App Store

• Android: 访问 Google Play 搜索 zmNinja 或点击链接： Get it on Google Play

2. 桌面端安装 (Windows/Mac/Linux)

桌面版不提供应用商店版本，需手动下载二进制文件。

1. 访问 GitHub Releases 页面： https://github.com/zoneminder/zmNinja/releases
2. 根据操作系统下载对应的安装包：
   • Windows: .exe 或 .msi
   • macOS: .dmg
   • Linux: .deb (Debian/Ubuntu) 或 .rpm (Fedora/CentOS) 或 .AppImage
3. 运行下载的安装包并按向导完成安装。

提示：国内用户若访问 GitHub 下载缓慢，可尝试使用镜像加速服务（如 ghproxy.com）拼接下载链接，例如：https://mirror.ghproxy.com/https://github.com/zoneminder/zmNinja/releases/download/<版本号>/<文件名>。

基本使用

第一步：配置连接

1. 启动 zmNinja 应用。
2. 点击 "Add Server" (添加服务器)。
3. 填写以下核心信息：
   • Name: 自定义名称（如 "Home Camera"）。
   • URL: ZoneMinder 的访问地址（例如 https://192.168.1.100/zm）。
   • Username/Password: ZoneMinder 的登录凭证。
4. 点击 "Validate" (验证)。如果显示绿色对勾，说明 API 连接成功。
5. 保存配置。

第二步：实时预览

1. 在主界面选择已添加的服务器。
2. 进入 "Monitors" (监控点) 列表。
3. 点击任意摄像头即可进入 Live View (实时视图)。
   • 支持 H.264 硬解码流畅播放。
   • 若摄像头支持，可在界面上使用手势进行 PTZ (云台/变焦) 控制。

第三步：查看历史与时间轴

1. 在服务器主页选择 "Events" (事件)。
2. 使用 Timeline View (时间轴视图) 快速定位特定时间的报警记录。
3. 点击具体事件条目可回放录像片段。

第四步：启用智能推送 (可选)

若服务端已配置 zmeventnotification：

1. 在应用设置中开启 Push Notifications。
2. 系统将自动接收包含物体检测（人、车等）结果的报警推送。