exsilium/unifi-video

Unifi-Video

镜像概述和主要用途

Unifi-Video镜像是Docker化的Ubiquiti Unifi Video控制器软件（版本v3.10.13），用于集中管理和监控Unifi系列视频摄像头。该镜像提供了便捷的部署方式，通过Docker容器化技术简化安装和维护流程，同时支持数据持久化存储，确保监控配置和录像数据不会因容器重启而丢失。

核心功能和特性

• Docker化部署：将Unifi Video控制器封装为Docker镜像，简化跨平台安装和升级流程
• 数据持久化：通过主机数据卷（Host Data Volume）存储MongoDB数据库、应用配置和日志文件
• 版本锁定：基于特定版本（v3.10.13）构建，确保运行环境稳定性
• 网络隔离：遵循Docker网络隔离特性，同时提供摄像头配置指南

使用场景和适用范围

适用于需要部署Unifi Video控制器的个人用户、小型企业或安防系统管理员，尤其适合希望通过容器化技术简化部署流程、实现快速迁移和版本管理的场景。支持在macOS等Docker兼容系统上运行。

使用方法和配置说明

准备工作：获取Docker

• 从Docker官网下载Docker安装包；将应用拖到/Applications目录完成安装
• （可选）右键点击顶部菜单栏中的Docker鲸鱼图标，选择“打开Kitematic”，按照提示下载并安装Kitematic到/Applications

Unifi-Video安装步骤

由于/usr/local是Docker保留目录，示例将Unifi Video安装在主机数据卷目录~/Applications/unifi-video中，您可根据需要修改路径。

注意！ 若执行命令时遇到权限错误，请在命令前添加sudo

1. 创建主机数据目录：

   bash
   mkdir -p ~/Applications/unifi-video
   

2. 拉取镜像：

   bash
   docker pull exsilium/unifi-video:v3.10.13
   

   拉取完成后可通过docker images命令验证：

   $ docker images
   REPOSITORY             TAG                 IMAGE ID            CREATED             SIZE
   exsilium/unifi-video   v3.10.13            1cbeb1e369da        44 minutes ago      869.9 MB
   

3. 创建数据子目录：

   bash
   cd ~/Applications/unifi-video
   mkdir mongodb unifi-video log
   

4. 运行容器：

   • （推荐）从https://raw.githubusercontent.com/exsilium/docker-unifi-video/v3.10.13/run.sh%E4%B8%8B%E8%BD%BD%60run.sh%60%E8%84%9A%E6%9C%AC%EF%BC%8C%E7%BC%96%E8%BE%91%E7%A1%AE%E4%BF%9DBASEDIR%E5%92%8CIP%E5%8F%82%E6%95%B0%E7%AC%A6%E5%90%88%E6%82%A8%E7%9A%84%E7%8E%AF%E5%A2%83%EF%BC%88%E9%BB%98%E8%AE%A40.0.0.0%E7%BB%91%E5%AE%9A%E6%89%80%E6%9C%89%E6%8E%A5%E5%8F%A3%EF%BC%89
   • 执行脚本启动容器：

     bash
     chmod +x run.sh
     ./run.sh
     

   • 或手动执行docker run命令（需根据实际路径调整参数）

5. 验证部署： 容器启动后，通过Chrome浏览器访问https://<您的IP>:7443打开Unifi Video设置向导

摄像头配置

由于Docker网络隔离特性，摄像头自动发现功能无法工作。需直接访问摄像头IP地址，手动配置控制器主机IP（即运行该Docker镜像的服务器IP）。

升级指南

从3.9.12升级到3.10.13

3.10.x版本对底层操作系统和MongoDB版本（从2.6升级到3.6）进行了重大更新，升级过程需特别注意：

注意！ 升级前务必备份数据！ 注意！ 确保当前版本为v3.9.12！

1. 通过Unifi-Video Web界面启动升级（此过程不会成功完成，但会升级数据库格式）
2. 登录容器并备份数据库：

   bash
   docker exec -it unifi-video mongodump --port 7441 -d av -o /var/lib/unifi-video/db.backup
   

3. 停止并删除旧容器：

   bash
   docker stop unifi-video
   docker rm unifi-video
   

4. 删除主机数据卷中的数据库文件：

   bash
   rm -rf ~/Applications/unifi-video/mongodb/*
   

5. 启动v3.10.13版本容器：

   bash
   ./run.sh  # 或手动docker run命令
   

6. 导入数据库备份：

   bash
   docker exec -it unifi-video mongorestore --drop --port 7441 -d av /var/lib/unifi-video/db.backup/av
   

7. 重启容器：

   bash
   docker restart unifi-video
   

从3.x.x升级到3.9.12

注意！ 升级前务必备份数据！ 注意！ 跨多版本升级未经过测试！ 注意！ 升级到v3.10.13前需先升级到v3.9.12！

1. 停止当前容器：

   bash
   docker stop unifi-video
   

2. 备份主机数据卷：

   bash
   cp -r ~/Applications/unifi-video ~/Applications/unifi-video_backup
   

3. 拉取v3.9.12镜像：

   bash
   docker pull exsilium/unifi-video:v3.9.12
   

4. 重命名旧容器：

   bash
   docker rename unifi-video unifi-video_old
   

5. 更新run.sh中的版本标签为v3.9.12
6. 启动新容器：

   bash
   ./run.sh
   

支持与帮助

如有问题、功能故障或需要帮助，请通过https://github.com/exsilium/docker-unifi-video/issues%E6%8F%90%E4%BA%A4%E8%AF%B7%E6%B1%82%E3%80%82
请勿使用Docker Hub评论区进行技术支持咨询。