thehomerepot/nxwitness

thehomerepot/nxwitness

镜像概述和主要用途

NX Witness VMS是一个视频管理系统（VMS），免费提供视频查看功能，购买摄像头许可证后可添加录制能力。本容器基于LinuxServer.io的出色工作，由https://github.com/thehomerepot提供，旨在提供高质量、可靠的容器化部署方案。

核心功能和特性

• 免费视频查看功能，支持通过许可证启用录制功能
• 容器化部署，简化安装与维护流程
• 支持主机网络模式（版本3.1.x之前为必需配置）
• 可配置用户ID（PUID）和组ID（PGID），避免宿主机与容器间的权限冲突
• 支持时区设置，确保系统时间同步

使用场景和适用范围

适用于需要视频监控管理的场景，包括家庭、小型企业等需要对摄像头进行集中管理和录制的环境。特别适合希望通过容器化方式简化部署和维护的用户。

使用方法和配置说明

Docker运行命令

bash
docker run -d \
--name=nxwitness \
--restart=unless-stopped \
--net=host \
-e PUID=<UID> -e PGID=<GID> \
-e TZ=<timezone> \
-v </path/to/config>:/config \
-v </path/to/recordings>:/archive \
thehomerepot/nxwitness

参数说明

参数格式为宿主机部分:容器部分，左侧表示宿主机配置，右侧表示容器内部配置。例如端口映射-p 8080:80表示将容器内80端口映射到宿主机8080端口，通过http://192.168.x.x:8080可访问容器内服务。

• --net=host：与容器共享主机网络，版本3.1.x之前必需
• -v /config：配置文件存储路径
• -v /archive：录制文件存储路径
• -e PGID=<GID>：组ID，用于权限控制（详见下文说明）
• -e PUID=<UID>：用户ID，用于权限控制（详见下文说明）
• -e TZ=<timezone>：时区信息，例如Europe/London

用户/组ID说明

使用数据卷（-v标志）时，宿主机与容器间可能出现权限问题。通过指定PUID（用户ID）和PGID（组ID）可避免此问题，需确保宿主机数据卷目录归属于指定用户。请勿使用root权限。

示例：若PUID=1001且PGID=1001，可通过以下命令获取当前用户ID：

bash
$ id <dockeruser>
  uid=1001(dockeruser) gid=1001(dockergroup) groups=1001(dockergroup)

应用设置

需安装并运行NX Witness桌面客户端，通过端口7001连接到Docker主机。客户端会提示配置新的服务器实例。

许可说明

录制摄像头视频需购买许可证，按每个主动录制的摄像头计费，可在摄像头间移动。

注意：许可证绑定到唯一生成的HWID（硬件ID），不易迁移。v3.1.X版本可能优化此问题，目前需提交支持请求才能将许可证移至新服务器。建议避免在Docker容器内安装许可证。

其他信息

• 容器运行时Shell访问：docker exec -it nxwitness /bin/bash
• 实时监控容器日志：docker logs -f nxwitness

版本历史

• 2019.08.17：更新以支持v4版本变更
• 2017.09.21：初始创建