lapicidae/vdr-server

lapicidae/vdr-server 镜像文档

镜像概述和主要用途

Video Disk Recorder（VDR）是由Klaus Schmidinger开发的免费开源项目，旨在使用标准PC组件构建数字视频录像机，支持接收、录制和回放符合DVB标准的数字电视广播。

lapicidae/vdr-server镜像是基于Arch Linux、VDR4Arch和s6-overlay构建的Docker镜像，提供了开箱即用的VDR服务，集成了多种插件支持、定时任务、日志管理等功能，适用于需要快速部署和自定义数字电视录制系统的场景。

核心功能和特性

主要特性

• 定期更新：镜像会自动同步Arch Linux官方镜像和VDR4Arch仓库更新，确保应用及时更新
• 用户映射：通过PUID和PGID轻松配置容器内用户权限
• 插件支持：内置ciplus、ddci2、dvbapi等插件，支持自定义安装VDR4Arch插件
• 邮件通知：集成msmtprc轻量级SMTP客户端，支持邮件通知功能
• 频道Logo：内置PNG格式频道Logo，也支持自定义Logo
• 定时任务：每日运行naludump cron任务，支持自定义调度时间
• HTTP服务器：内置简易HTTP服务器，提供频道Logo和EPG图像（适用于roboTV等插件）
• 自定义包集成：支持集成用户自定义PKGBUILD包
• 日志管理：日志文件化存储并支持自动轮转
• 频道ID列表：自动生成VDR频道ID列表

注意事项

当以下任一源更新时，镜像将自动重建：

• Arch Linux官方Docker镜像（latest标签）
• VDR4Arch GitHub仓库

使用场景和适用范围

适用于需要搭建数字电视录制与回放系统的用户，尤其适合以下场景：

• 家庭或小型办公环境的数字电视录制服务器
• 需要自定义插件扩展功能（如EPG搜索、流服务、网络接口）的场景
• 需远程管理和监控录制任务（通过邮件通知、Web界面）的需求
• 追求系统轻量化和自动化维护的用户

使用方法和配置说明

快速开始

首次启动注意事项

⚠️ 警告：首次启动可能较慢
首次启动时需从AUR构建非内置插件，耗时较长，请耐心等待。

Docker Compose（推荐）

兼容docker-compose v2架构：

yaml
version: "2.1"
services:
  vdr-server:
    image: lapicidae/vdr-server
    container_name: vdr-server
    environment:
      - PUID=1000               # 用户ID（详见下文说明）
      - PGID=1000               # 组ID（详见下文说明）
      - TZ=Europe/London        # 时区（如Asia/Shanghai）
      - PLUGINS=epgsearch live streamdev-server vnsiserver  # 可选：插件列表
    volumes:
      - /path/to/system:/vdr/system          # 系统配置（启动参数、钩子脚本等）
      - /path/to/config:/vdr/config          # 应用配置（setup.conf、channels.conf等）
      - /path/to/recordings:/vdr/recordings  # 录制文件存储目录
      - /path/to/cache:/vdr/cache            # 缓存文件（epgimages、cam.data等）
      - /path/to/channellogos:/vdr/channellogos  # 可选：自定义频道Logo
      - /path/to/log:/vdr/log                # 可选：日志文件存储（需启用LOG2FILE）
      - /path/to/timeshift:/vdr/timeshift    # 可选：时移缓冲目录
      - /path/to/pkgbuild:/vdr/pkgbuild      # 可选：自定义PKGBUILD包目录
    ports:
      - 8008:8008               # VDR-Live插件HTTP端口
      - 6419:6419               # 可选：SVDRP协议端口
      - 6419:6419/udp           # 可选：SVDRP对等连接UDP端口
      - 34890:34890             # 可选：VNSI接口（Kodi客户端）
      - 8099:8099               # 可选：图像服务器端口（需启用START_IMAGESERVER）
    devices:
      - /dev/dvb:/dev/dvb       # 可选：DVB卡设备映射
    cap_add:
      - SYS_TIME                # 可选：允许修改系统时间（需配合VDR的SetSystemTime设置）
    restart: unless-stopped
    stop_grace_period: 60s      # 重要：确保VDR正常关闭

Docker CLI

bash
docker run -d \
  --name=vdr-server \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Europe/London \
  -e PLUGINS=epgsearch live streamdev-server vnsiserver `# 可选：插件列表` \
  -p 8008:8008 \
  -p 6419:6419 `# 可选：SVDRP协议端口` \
  -p 6419:6419/udp `# 可选：SVDRP对等连接UDP端口` \
  -p 34890:34890 `# 可选：VNSI接口（Kodi客户端）` \
  -p 8099:8099 `# 可选：图像服务器端口（需启用START_IMAGESERVER）` \
  -v /path/to/system:/vdr/system \
  -v /path/to/config:/vdr/config \
  -v /path/to/recordings:/vdr/recordings \
  -v /path/to/cache:/vdr/cache \
  -v /path/to/channellogos:/vdr/channellogos `# 可选：自定义频道Logo` \
  -v /path/to/log:/vdr/log `# 可选：日志文件存储（需启用LOG2FILE）` \
  -v /path/to/timeshift:/vdr/timeshift `# 可选：时移缓冲目录` \
  -v /path/to/pkgbuild:/vdr/pkgbuild `# 可选：自定义PKGBUILD包目录` \
  --device /dev/dvb:/dev/dvb `# 可选：DVB卡设备映射` \
  --restart unless-stopped \
  --cap-add=SYS_TIME `# 可选：允许修改系统时间` \
  --stop-timeout 60 `# 重要：确保VDR正常关闭` \
  lapicidae/vdr-server

参数说明

容器运行时通过参数进行配置，格式为<外部>:<内部>（如端口映射）。

用户/组ID说明

使用卷映射（-v）时，主机与容器可能出现权限冲突。通过PUID和PGID可指定容器内运行用户的ID，确保与主机目录权限匹配。

通过以下命令获取主机用户的ID：

bash
id username
# 输出示例：uid=1000(dockeruser) gid=4321(dockergroup) groups=4321(dockergroup)

将输出的uid和gid分别作为PUID和PGID参数值。

VDR配置

目录结构映射

容器内标准路径与主机映射目录对应关系：

应用设置

基础配置：

• 命令行参数可在vdr/system/conf.d/00-vdr.conf中修改
• 配置文件位于vdr/config/目录（如setup.conf、channels.conf）
• Web界面（live插件）访问地址：http://<主机IP>:8008，支持通过远程控制界面修改大部分VDR设置

插件配置

• 插件参数通过vdr/system/conf.d/目录下的对应文件配置
• 插件相关文件（如配置、数据）位于vdr/config/plugins/目录
• 可通过PLUGINS环境变量指定需安装的插件（空格分隔）

邮件通知配置

VDR插件（如epgsearch）可通过sendmail发送邮件通知。容器集成msmtp提供sendmail功能，配置文件为vdr/system/eMail.conf。配置方法详见msmtp文档。

附加功能

频道ID列表

容器停止时会自动生成VDR频道ID列表，存储于vdr/cache/channelids.conf。

录制文件错误检查

针对VDR 2.6.0之前版本的录制文件，可通过连续性计数器检查错误（如用于Web界面显示）。只需在录制主目录（vdr/recordings）创建空文件checkrec，容器启动时会自动执行检查，直至完成所有文件扫描。检查通过eTobi的https://github.com/vdr-projects/vdr-checkts%E5%B7%A5%E5%85%B7%E5%AE%9E%E7%8E%B0%E3%80%82

致谢

• Klaus Schmidinger (kls) - VDR项目创始人
• vdr-portal.de - VDR社区论坛
• VDR4Arch - VDR Arch Linux仓库维护团队
• Tobias Grimm (eTobi) - VDR相关工具开发者
• just-containers - s6-overlay项目
• linuxserver.io - Docker镜像构建参考
• 以及所有未提及的贡献者