pducharme/unifi-video-controller

unifi-video-controller 镜像文档

镜像概述

该Docker镜像基于Ubuntu系统运行Unifi Video控制器，最初为Unraid 6.x设计，但可在任何Docker环境中正常运行。通过配置本地数据和视频目录，以及指定运行用户ID（UID）和组ID（GID），可实现Unifi Video控制器的灵活部署和管理。

核心功能与特性

• 在Ubuntu环境中运行Unifi Video控制器
• 支持自定义数据存储目录和视频存储目录
• 可指定控制器进程运行的用户ID（UID）和组ID（GID）
• 提供多端口映射，满足控制器各类网络需求
• 支持临时文件系统（tmpfs）配置，优化缓存性能
• 可通过环境变量配置时区、调试模式等参数

使用场景与适用范围

• 家庭或企业视频监控系统中部署Unifi Video控制器
• 需要在Unraid 6.x系统中运行Unifi Video控制器的场景
• 希望通过Docker实现Unifi Video控制器快速部署和环境隔离的用户
• 需要自定义数据存储路径或运行权限的场景

使用方法与配置说明

基本运行命令

通过以下docker run命令启动Unifi Video控制器：

bash
docker run \
        --name unifi-video \
        --cap-add DAC_READ_SEARCH \
        -p 10001:10001 \
        -p 1935:1935 \
        -p 6666:6666 \
        -p 7080:7080 \
        -p 7442:7442 \
        -p 7443:7443 \
        -p 7444:7444 \
        -p 7445:7445 \
        -p 7446:7446 \
        -p 7447:7447 \
        -v <data docker.xuanyuan.run/dir>:/var/lib/unifi-video \
        -v <videos dir>:/var/lib/unifi-video/videos \
        --tmpfs /var/cache/unifi-video \
        -e TZ=America/Los_Angeles \
        -e PUID=99 \
        -e PGID=100 \
        -e CREATE_TMPFS=no \
        -e DEBUG=1 \
        pducharme/unifi-video-controller

参数说明

容器配置参数

• --name unifi-video：指定容器名称为unifi-video
• --cap-add DAC_READ_SEARCH：添加DAC_READ_SEARCH权限，确保控制器正常访问文件系统

端口映射

• 10001:10001：设备发现端口
• 1935:1935：RTMP视频流端口
• 6666:6666：视频传输端口
• 7080:7080：HTTP管理界面端口
• 7442-7447:7442-7447：HTTPS管理及相关服务端口

卷挂载

• -v <data dir>:/var/lib/unifi-video：挂载本地数据目录到容器内控制器数据目录
• -v <videos dir>:/var/lib/unifi-video/videos：挂载本地视频目录到容器内视频存储目录
• --tmpfs /var/cache/unifi-video：使用临时文件系统作为缓存目录

环境变量

• TZ：设置时区，如America/Los_Angeles
• PUID：指定运行控制器进程的用户ID，如99
• PGID：指定运行控制器进程的组ID，如100
• CREATE_TMPFS：是否创建tmpfs，no表示不创建
• DEBUG：是否启用调试模式，1表示启用

访问控制器

容器启动后，通过以下地址访问Unifi Video设置向导：

• http://localhost:7080（本地访问）
• http://<ip.address>:7080（通过IP地址访问）

Docker for Windows 额外配置

在Windows环境中，为避免MongoDB错误导致控制器启动时卡在"upgrading"界面，需执行以下步骤：

1. 创建Docker卷：

   bash
   docker volume create UnifiVideoDataVolume
   

2. 将数据目录挂载到该卷，修改-v参数：

   bash
   -v UnifiVideoDataVolume:/var/lib/unifi-video
   

3. 视频文件可挂载到本地目录（无需使用Docker卷），例如：

   bash
   -v D:\Recordings:/var/lib/unifi-video/videos