Viseron

自托管、纯本地的网络视频录像机（NVR）及人工智能计算机视觉软件。

凭借物体检测、移动侦测、人脸识别等功能，它能帮助您随时监控家庭、办公室或其他任何需要监视的场所。

入门指南

入门非常简单！您只需启动一个 Docker 容器，并通过内置的 Web 界面编辑配置文件即可。

请前往 文档 查看详细的入门说明。

组件

Viseron 的功能由 组件 提供支持。

您可以通过 组件浏览器 查找所有可用的组件。

贡献

我们非常欢迎各位为本项目贡献力量。请参阅 贡献指南，了解如何开始参与。

您可以从以下方面提供帮助：

• 实现 问题追踪器 中的公开功能请求或问题
• 改进文档
• 回答问题追踪器中的问题或 讨论区 中的问题

您也可以通过下方链接为 Viseron 提供赞助，或进行一次性捐赠。

Viseron 快速上手指南

Viseron 是一款自托管、纯本地运行的 NVR（网络视频录像机）与 AI 计算机视觉软件。它支持物体检测、运动检测、人脸识别等功能，帮助您监控家庭、办公室或其他场所。

环境准备

在开始之前，请确保您的系统满足以下要求：

• 操作系统：支持 Docker 的 Linux 发行版（推荐 Ubuntu/Debian）、macOS 或 Windows（需安装 WSL2）。
• 核心依赖：已安装并运行 Docker 和 Docker Compose。
• 硬件建议：
  • 由于涉及 AI 推理，建议使用具备 GPU 的设备（如 NVIDIA GPU 或 Intel QuickSync）以获得更佳性能。
  • 确保有足够的存储空间用于保存录像文件。

注意：目前官方未提供专门的中国镜像源，请确保网络环境可以正常访问 Docker Hub (docker.io) 拉取镜像。

安装步骤

Viseron 主要通过 Docker 容器部署。以下是使用 docker run 快速启动的步骤：

1. 创建配置目录 在主机上创建一个用于存放配置文件和数据的目录：

   mkdir -p ~/viseron/config
   

2. 启动容器 运行以下命令启动 Viseron 容器。该命令将映射配置目录并开放 Web 界面端口（默认 8888）：

   docker run -d \
     --name viseron \
     --restart unless-stopped \
     -p 8888:8888 \
     -v ~/viseron/config:/config \
     -v /etc/localtime:/etc/localtime:ro \
     roflcoopter/viseron:latest
   

   注：如果您需要使用 GPU 加速（以 NVIDIA 为例），请在命令中添加 --gpus all 参数。

基本使用

启动成功后，您可以通过内置的 Web 界面完成所有配置，无需手动编辑 YAML 文件。

1. 访问 Web 界面 打开浏览器，访问：

   http://<您的服务器 IP>:8888
   

2. 配置摄像头与组件

   • 在 Web 界面中，进入配置编辑器。
   • 添加您的摄像头流地址（支持 RTSP 等协议）。
   • 通过 组件探索器 (Component Explorer) 查找并启用所需功能（如 object_detector 用于物体检测，motion_detector 用于运动检测）。
   • 保存配置，Viseron 将自动重启并应用新设置。

3. 查看监控与日志 配置完成后，您可以在仪表板中实时查看带有 AI 标注的视频流，并在日志面板中监控运行状态。

更多详细配置项请参考官方文档：https://viseron.netlify.app