OliveTin for Channels DVR Docker镜像文档

镜像概述

本镜像基于OliveTin构建，专为Channels DVR用户设计，提供一站式管理解决方案。通过集成多DVR服务器支持、邮件通知、日志管理及Portainer集成等功能，帮助用户简化Channels DVR的日常运维与监控。

核心功能和特性

• 多DVR服务器支持：可配置主DVR服务器及多个备用DVR服务器，实现灵活管理
• 告警通知系统：通过SMTP服务器发送邮件告警，及时反馈系统状态
• 日志持久化：支持日志共享挂载，便于查看和分析DVR运行日志
• Portainer集成：与Portainer联动，实现容器生命周期管理
• 多共享目录支持：可挂载DVR媒体文件、日志及TubeArchivist视频共享目录
• 配置自动更新：支持配置文件(yaml)和脚本自动更新
• 兼容：支持 Magic DNS，便于远程节点访问

使用场景和适用范围

适用于所有使用Channels DVR的用户，尤其适合：

• 需要管理多个Channels DVR服务器的用户
• 希望实时监控DVR录制状态并接收告警的用户
• 需集中管理DVR媒体文件、日志的用户
• 使用Portainer进行容器管理的Docker环境用户

使用方法和配置说明

环境要求

• Docker Engine 20.10+
• Docker Compose 3.9+
• 网络访问权限（用于拉取镜像和发送邮件通知）

环境变量配置

卷挂载配置

Docker Compose部署示例

基础配置

yaml
version: '3.9'
services:
  olivetin:
    image: bnhf/olivetin:${TAG:-latest}
    container_name: ${OLIVETIN_NAME:-olivetin}
    hostname: ${OLIVETIN_NAME:-olivetin}
    dns_search: ${DOMAIN:+${DOMAIN}}
    ports:
      - ${HOST_PORT:-1337}:1337
    environment:
      - OLIVETIN_COMPOSE=2025.03.26
      - CHANNELS_DVR=${CHANNELS_DVR_HOST}:${CHANNELS_DVR_PORT:-8089}
      - ${CHANNELS_DVR2_HOST:+CHANNELS_DVR_ALTERNATES=${CHANNELS_DVR2_HOST}:${CHANNELS_DVR2_PORT}} ${CHANNELS_DVR3_HOST:+${CHANNELS_DVR3_HOST}:${CHANNELS_DVR3_PORT}}
      - CHANNELS_CLIENTS=${CHANNELS_CLIENTS}
      - ALERT_SMTP_SERVER=${ALERT_SMTP_SERVER}
      - ALERT_EMAIL_FROM=${ALERT_EMAIL_FROM}
      - ALERT_EMAIL_PASS=${ALERT_EMAIL_PASS}
      - ALERT_EMAIL_TO=${ALERT_EMAIL_TO}
      - UPDATE_YAMLS=${UPDATE_YAMLS:-true}
      - UPDATE_SCRIPTS=${UPDATE_SCRIPTS:-true}
      - TZ=${TZ}
      - PORTAINER_TOKEN=${PORTAINER_TOKEN}
      - PORTAINER_HOST=${PORTAINER_HOST:-$CHANNELS_DVR_HOST}
      - PORTAINER_PORT=${PORTAINER_PORT:-9443}
      - PORTAINER_ENV=${PORTAINER_ENV:-2}
      - PERSISTENT_LOGS=${PERSISTENT_LOGS:-false}
    volumes:
      - ${HOST_DIR:-/unused}${HOST_DIR:+/olivetin:/config}
      - ${DVR_SHARE:-/unused}${DVR_SHARE:+:/mnt/${CHANNELS_DVR_HOST}-${CHANNELS_DVR_PORT}}
      - ${LOGS_SHARE:-/unused}${LOGS_SHARE:+:/mnt/${CHANNELS_DVR_HOST}-${CHANNELS_DVR_PORT}_logs}
      - ${TUBEARCHIVIST_SHARE:-/unused}${TUBEARCHIVIST_SHARE:+:/mnt/${CHANNELS_DVR_HOST}-${CHANNELS_DVR_PORT}_ta}
      - /var/run/docker.sock:/var/run/docker.sock
    restart: unless-stopped

  static-file-server:
    image: halverneus/static-file-server:latest
    container_name: ${SFS_NAME:-static-file-server}
    dns_search: ${DOMAIN}
    ports:
      - ${HOST_SFS_PORT:-0}:8080
    environment:
      - FOLDER=${FOLDER:-/web}
    volumes:
      - ${HOST_DIR:-/unused}${HOST_DIR:+/olivetin/data:${FOLDER:-/web}}
    restart: unless-stopped

示例环境变量文件 (.env)

env
TAG=latest
DOMAIN=localdomain tailxxxxx.ts.net
HOST_PORT=1337
CHANNELS_DVR_HOST=local-server
CHANNELS_DVR_PORT=8089
CHANNELS_DVR2_HOST=another-server
CHANNELS_DVR2_PORT=8089
CHANNELS_CLIENTS=appletv4k firestick-master amazon-aftkrt
ALERT_SMTP_SERVER=smtp.gmail.com:587
ALERT_EMAIL_FROM=***
ALERT_EMAIL_PASS=xxxxxxxxxxxxxxxx
ALERT_EMAIL_TO=***
UPDATE_YAMLS=true
UPDATE_SCRIPTS=true
TZ=US/Mountain
HOST_DIR=/data
DVR_SHARE=/mnt/dvr
LOGS_SHARE=/mnt/channelsdvr
TUBEARCHIVIST_SHARE=/mnt/dvr
HOST_SFS_PORT=8080
FOLDER=/web
PORTAINER_TOKEN=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
PORTAINER_HOST=docker-host
PORTAINER_PORT=9443
PORTAINER_ENV=2
PERSISTENT_LOGS=false

部署步骤

1. 创建环境变量文件 .env，根据实际需求配置参数
2. 创建 docker-compose.yml 文件，复制上述基础配置
3. 执行部署命令：docker-compose up -d
4. 访问 http://<主机IP>:<HOST_PORT>（默认1337端口）打开Web界面

高级配置

多DVR服务器配置

如需管理多个DVR服务器，需配置：

• CHANNELS_DVR2_HOST 和 CHANNELS_DVR2_PORT：第二台DVR服务器信息
• CHANNELS_DVR3_HOST 和 CHANNELS_DVR3_PORT：第三台DVR服务器信息
• 对应共享目录：DVR2_SHARE、LOGS2_SHARE、TUBEARCHIVIST2_SHARE 等

外部卷配置

如需使用Docker外部卷挂载共享目录，可取消注释 volumes 部分并配置：

yaml
volumes:
  channels-dvr:
    external: true
  channels-dvr-logs:
    external: true
  tubearchivist:
    external: true

然后在环境变量中设置 DVR_SHARE=channels-dvr 等对应卷名。