netzfisch/rpi-tvheadend

Tvheadend Docker镜像

原本仅为ARM架构打造，现也支持x86/x64平台，可查看https://github.com/netzfisch/rpi-tvheadend/blob/master/Dockerfile.x86_64%E6%88%96%E8%8E%B7%E5%8F%96https://hub.docker.com/r/netzfisch/tvheadend/%EF%BC%81

仅需15分钟，即可将你的树莓派或x86/x64设备转变为局域网内的电视流与录制服务器！该项目使用知名的Tvheadend软件，基于Alpine Linux（约5MB，比多数发行版基础镜像更小），因此镜像体积更精简高效。

完整源码见https://github.com/netzfisch/rpi-tvheadend%EF%BC%8CARM%E4%B8%8Ex86_64%E5%B9%B3%E5%8F%B0%E7%9A%84%E9%95%9C%E5%83%8F%E5%8F%AF%E5%9C%A8DockerHub%E8%8E%B7%E5%8F%96%EF%BC%9Ahttps://hub.docker.com/r/netzfisch/rpi-tvheadend/%E3%80%81https://hub.docker.com/r/netzfisch/tvheadend/%EF%BC%8C%E5%88%AB%E5%BF%98%E4%BA%86%E7%BB%99%E4%BB%93%E5%BA%93%E7%82%B9%E4%B8%AA%E6%98%9F%E5%93%A6 ;-)

核心功能

• 支持ARM（树莓派）和x86/x64双平台
• 提供电视流直播与节目录制服务
• 基于Alpine Linux，镜像体积轻量、运行高效
• Web界面配置，含初始用户与设置向导

使用场景

• 家庭局域网内的电视直播观看
• 电视节目定时录制与存储
• 树莓派或x86设备的媒体服务器搭建

配置说明

需求

• 树莓派或x86/x64设备
• Linux兼容的DVB-C/S/T USB调谐器
• Docker引擎

安装步骤

1. 安装Docker：可下载Debian Docker包（此处）并通过dpkg -i package_name.deb安装；或使用HypriotOS（基于Raspbian的Docker主机系统，详见入门指南）。
2. 获取DVB固件：例如下载dvb-usb-vp7045固件：

   sh
   cd /lib/firmware && wget https://www.linuxtv.org/downloads/firmware/dvb-usb-vp7045-01.fw
   

3. 设置静态IP：修改/etc/network/interfaces：

   sh
   allow-hotplug eth0
   iface eth0 inet static
     address 192.168.PI.IP
     netmask 255.255.255.0
     gateway 192.168.XXX.XXX
   

4. 挂载NAS：修改/etc/fstab添加NFS挂载：

   sh
   192.168.NAS.IP:/nfs/Public /mnt nfs auto 0 0
   

   或使用Netshare Docker插件直接在容器内挂载NFS：

   sh
   docker run -it --volume-driver=nfs --volume NFShost/path:/data alpine /bin/ash
   

5. 拉取镜像：

   sh
   docker pull netzfisch/rpi-tvheadend
   

构建（x86/x64平台）

sh
vim Dockerfile.x86_64
docker build -t netzfisch/tvheadend:test Dockerfile.x86_64
docker tag netzfisch/tvheadend:test netzfisch/tvheadend:4.0.9

部署示例

运行容器：

sh
docker run --detach \
           --name tvheadend \
           --restart unless-stopped \
           --volume /mnt/Configs/tvh-config:/config \
           --volume /mnt/Movies:/recordings \
           -p 9981-9982:9981-9982 \
           --privileged netzfisch/rpi-tvheadend

配置与调试

• Web配置：通过http://设备IP:9981访问界面，初始用户已创建，将自动启动设置向导。若录制时出现文件创建错误，需检查Web界面中【Recording > DVR-Profile > Advanced View > Filename Charset】是否设置为UTF-8。
• 调试步骤：
  1. 停止并移除容器：docker stop tvheadend && docker rm tvheadend
  2. 重新加载DVB模块：rmmod dvb_usb_vp7045 dvb_usb dvb_core && modprobe dvb_usb_vp7045
  3. 进入容器调试：docker exec -it tvheadend /bin/ash

贡献与许可证

• 如有问题，请提交https://github.com/netzfisch/rpi-tvheadend/issues%E3%80%82
• 欢迎提交https://github.com/netzfisch/rpi-tvheadend/pulls%E8%B4%A1%E7%8C%AE%E4%BB%A3%E7%A0%81%E6%88%96%E5%8A%9F%E8%83%BD%E3%80%82
• 许可证：MIT许可证，详见https://github.com/netzfisch/rpi-tvheadend/blob/master/LICENSE%E6%96%87%E4%BB%B6%E3%80%82