lapicidae/vdr-server

lapicidae

基于Arch Linux的VDR镜像，提供视频录制与媒体管理功能，依托Arch Linux轻量灵活特性及滚动更新机制，适用于媒体中心搭建与电视节目录制场景。

2 次收藏下载次数: 0状态：社区镜像维护者：lapicidae仓库类型：镜像最近更新：4 天前

让 AI 帮你使用轩辕镜像？ · 展开查看说明 · 点击收起说明

如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。

只需在 AI 对话中先发送下面这句话即可：

请先完整阅读并严格遵守以下文档中的全部规则与要求：

https://xuanyuan.cloud/agents.md

在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。

查看 agents.md 用法指南与完整示范。国内用户首推元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。若 AI 无法访问外链，可打开说明文档复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。

镜像标签列表与下载命令

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

参数说明

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

参数	功能说明
`-p 8008`	VDR-Live插件HTTP端口
`-p 3000`	Streamdev服务器HTTP流端口 ¹
`-p 8009`	可选：VDR-Live插件HTTPS端口（需自行配置证书）
`-p 6419`	可选：简单VDR协议（SVDRP）端口
`-p 6419/udp`	可选：SVDRP对等连接UDP端口
`-p 2004`	可选：Streamdev服务器VDR-to-VDR流端口
`-p 34890`	可选：VDR网络流接口（VNSI，用于Kodi客户端）
`-p 8099`	可选：图像服务器端口（需启用START_IMAGESERVER） ²
`-e PUID=1000`	用户ID，用于权限映射（详见下文说明）
`-e PGID=1000`	组ID，用于权限映射（详见下文说明）
`-e TZ=Europe/London`	时区设置（如Asia/Shanghai，完整列表见时区数据库）
`-e LANG=en_US.UTF-8`	默认 locale（支持列表见glibc locales）
`-e PLUGINS=...`	可选：空格分隔的VDR插件列表（默认：`epgsearch live streamdev-server vnsiserver`，插件列表见https://github.com/VDR4Arch/vdr4arch/tree/master/plugins%EF%BC%89
`-e START_NALUDUMP=true`	可选：启用每日naludump定时任务（默认4点运行） ³
`-e START_NALUDUMP_AT=0 4 * * *`	可选：自定义naludump调度时间（cron格式，示例见crontab.guru）
`-e START_IMAGESERVER=true`	可选：启用图像服务器（提供频道Logo和EPG图像）
`-e LOG2FILE=true`	可选：启用日志文件存储（日志路径：`/vdr/log`）
`-e PROTECT_CAMDATA=true`	可选：设置`cam.data`为只读，防止意外修改
`-e DISABLE_WEBINTERFACE=true`	可选：禁用Web界面（live插件）
`-e LOGO_COPY=false`	可选：使用自定义频道Logo（路径：`/vdr/channellogos`）
`-v /vdr/system`	系统配置目录（启动参数、录制钩子、msmtprc配置等）
`-v /vdr/config`	应用配置目录（如`setup.conf`、`channels.conf`）
`-v /vdr/recordings`	录制文件存储目录（视频目录）
`-v /vdr/cache`	缓存目录（如`epgimages`、`cam.data`）
`-v /vdr/channellogos`	频道Logo存储目录
`-v /vdr/log`	日志文件目录（需启用`LOG2FILE=true`）
`-v /vdr/timeshift`	VNSI时移缓冲目录
`-v /vdr/pkgbuild`	自定义PKGBUILD包目录（配置说明见https://github.com/lapicidae/vdr-server/blob/master/build/base/defaults/pkgbuild%EF%BC%89
`--device /dev/dvb`	DVB卡设备映射（如需使用物理DVB设备）

用户/组ID说明

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

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

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

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

VDR配置

目录结构映射

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

容器内路径	主机映射路径	说明
`/etc/vdr`	`/vdr/system`	系统配置（启动参数、钩子脚本等）
`/var/lib/vdr`	`/vdr/config`	应用配置（插件配置、频道列表等）
`/srv/vdr/video`	`/vdr/recordings`	录制文件存储
`/var/cache/vdr`	`/vdr/cache`	缓存文件（EPG图像、CAM数据等）
`/usr/share/vdr/channel-logos`	`/vdr/channellogos`	频道Logo

应用设置

基础配置：

命令行参数可在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镜像构建参考
以及所有未提及的贡献者

Streamdev服务器HTTP流访问地址：http://<主机IP>:3000 ↩
图像服务器启用后，访问说明：http://<主机IP>:8099 ↩
⚠️ 警告：naludump任务设计以安全为目标，但无法保证录制文件在清理过程中完全无损坏风险。 ↩

镜像拉取方式

您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问标签列表页面。

轩辕镜像加速拉取命令点我查看更多 vdr-server 镜像标签

docker pull docker.xuanyuan.run/lapicidae/vdr-server:<标签>

使用方法：

DockerHub 原生拉取命令

docker pull lapicidae/vdr-server:<标签>

轩辕镜像配置手册

按平台快速找到配置文档

Docker

登录仓库拉取

登录认证 · 私有仓库

专属域名拉取

免登录 · 高速拉取

Linux

Docker 镜像配置

Windows / Mac

Docker Desktop 配置

MacOS OrbStack

OrbStack 容器

Docker Compose

Compose 项目配置

NAS

群晖

Synology 配置

飞牛

fnOS 镜像配置

绿联

绿联 NAS

威联通

QNAP 配置

极空间

极空间 NAS

企业仓库

其他仓库

ghcr · Quay · nvcr

Harbor 镜像源

Proxy Repository 对接

Portainer 镜像源

Registries 配置

Nexus 镜像源

Docker Proxy 缓存

开发工具

Dev Containers

VS Code 开发容器

Podman

Podman 配置指南

Singularity / Apptainer

HPC 科学计算容器

Kubernetes

K8s Containerd

Kubernetes · Containerd

K3s

轻量级集群

面板 / 网络

爱快路由

iKuai 镜像加速

宝塔面板

一键配置镜像源

AI

用 AI 使用轩辕镜像

agents.md · AI 对话 · 提示词

一键安装

一键安装 Docker

Linux Docker 一键安装

需要其他帮助？请查看我们的常见问题Docker 镜像访问常见问题解答或提交工单

镜像拉取常见问题

功能

版本功能对比

功能对比 · 版本选择

支持的镜像仓库

Docker Hub · GCR · GHCR

新手拉取配置

docker search 限制

专属域名 · Hub 搜索

不支持 push

仅支持 pull · 不支持

拉取速度原因

带宽 · 缓存 · 冷热镜像

错误码

402 与流量用尽

402 · 流量包 · 充值

401 认证失败

401 · docker login

manifest unknown

标签错误 · 镜像不存在

410 Gone 排查

410 · Docker 升级

429 限流

免费版 · 请求频率

其他报错

DNS 超时

DNS 解析 · 网络超时

TLS 证书失败

no matching manifest（架构）

账号

失败是否计费

manifest · blob · 计费

申请开发票（企业 / 个人）

企业 · 个人 · 工单

修改登录密码

网站 · 仓库 · 重置

注销账户

工单 · 数据 · 注销

原理

mirrors 不生效

daemon.json · 重启

去掉域名前缀

docker tag · 重命名

指定架构拉取

ARM64 · AMD64 · 多架构

latest 与「最新」

digest · 版本号 · 标签

查看全部问题→

用户好评

来自真实用户的反馈，见证轩辕镜像的优质服务

oldzhang

运维工程师

Linux服务器

"Docker访问体验非常流畅，大镜像也能快速完成下载。"