timstephens24/channels-dvr

Channels DVR Docker

镜像概述和主要用途

该Docker镜像用于运行Channels DVR，与fancybits官方镜像的核心区别在于：以普通用户身份运行（可通过环境变量映射用户ID和组ID），而非root用户，确保媒体文件拥有正确的权限（归用户所有而非root）。

核心功能和特性

• 用户权限控制：通过环境变量PUID和PGID映射用户身份，解决媒体文件权限问题
• 多平台硬件转码支持：支持Intel和NVIDIA硬件转码；无需Intel支持时可移除--device /dev/dri:/dev/dri配置；无需NVIDIA支持时可移除NVIDIA_VISIBLE_DEVICES环境变量（保留也无影响）
• 网络端口暴露：默认暴露8089（tcp）和1900（udp）端口，推荐使用host网络模式运行

使用场景和适用范围

适用于需要运行Channels DVR且关注媒体文件权限管理的用户，尤其适合需要TVE（电视everywhere）功能和硬件转码加速的场景，如家庭媒体中心、个人DVR服务器等。Unraid用户可使用提供的模板进行部署。

使用方法和配置说明

Docker Compose示例

yaml
version: "3.8"
services:
  channels-dvr:
    network_mode: host
    restart: always
    container_name: channels-dvr
    hostname: channels
    image: timstephens24/channels-dvr
    security_opt:
      - seccomp=unconfined
    environment:
      - PUID=1000          # 用户ID，用于权限映射
      - PGID=1000          # 组ID，用于权限映射
      - TZ=America/New_York # 时区设置
      - NVIDIA_VISIBLE_DEVICES=all # NVIDIA设备可见性（如需NVIDIA转码）
    volumes:
      - /opt/channels-dvr:/channels-dvr # DVR配置和数据目录
      - /mnt/disk/dvr/recordings:/shares/DVR # 媒体文件存储目录（需根据实际路径修改）
      - /etc/localtime:/etc/localtime:ro # 挂载本地时间（只读）
    devices:
      - /dev/dri:/dev/dri # Intel硬件转码设备（如需Intel转码）

Docker Run示例

bash
docker run \
  --detach \
  --net=host \
  --restart=always \
  --name=channels-dvr \
  --hostname=channels \
  --security-opt seccomp=unconfined \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=America/New_York \
  -e NVIDIA_VISIBLE_DEVICES=all \
  --volume /opt/channels:/channels-dvr \
  --volume /mnt/disk/dvr/recordings:/shares/DVR \
  --volume /etc/localtime:/etc/localtime:ro \
  --device /dev/dri:/dev/dri \
  timstephens24/channels-dvr

配置参数说明

• 环境变量：
  • PUID：用户ID，用于映射容器内用户身份，确保文件权限正确（默认1000）
  • PGID：组ID，用于映射容器内用户组身份（默认1000）
  • TZ：时区设置（如America/New_York，需根据实际时区调整）
  • NVIDIA_VISIBLE_DEVICES：NVIDIA设备可见性（all表示所有设备，无需时可移除）
• 卷挂载：
  • /channels-dvr：DVR配置和数据存储目录，需持久化
  • /shares/DVR：媒体文件（如录制内容）存储目录，需根据实际路径修改
  • /etc/localtime:ro：挂载本地时间，确保容器内时间正确
• 设备映射：
  • /dev/dri:/dev/dri：Intel硬件转码设备，无需Intel转码时可移除

Unraid部署说明

Unraid用户可使用模板：https://github.com/timstephens24/docker-templates%E3%80%82%E9%BB%98%E8%AE%A4%E8%B7%AF%E5%BE%84%E7%A4%BA%E4%BE%8B%EF%BC%9A

• Channels DVR配置目录：/mnt/user/appdata/channels-dvr
• 媒体目录：/mnt/user/data/Media（建议在此目录下创建ChannelsDVR子目录用于录制内容）

联系信息