dachack/rpi-kodi

dachack/rpi-kodi 镜像文档

概述

dachack/rpi-kodi 是一个Docker化的Kodi媒体中心镜像，支持音频和视频功能，可在Docker容器中运行。该镜像适用于amd64架构设备（如Fujitsu Futro S740），提供完整的Kodi媒体中心功能，并确保容器终止时Kodi能干净关闭。

核心功能

• 完整功能的Kodi安装：在Docker容器中提供全功能的Kodi媒体中心
• 音频与视频支持：支持ALSA或PulseAudio音频输出，具备视频播放能力
• 轻量可靠的基础：基于Debian-slim镜像构建，严格遵循Kodi官方Linux安装指南
• 安全关闭机制：容器终止时自动干净关闭Kodi进程，避免数据损坏

主机要求

运行该镜像的主机系统需满足以下条件：

1. Linux系统与Docker环境
   任何安装了功能正常的Docker的Linux发行版均可使用该镜像。

2. 连接的显示设备与扬声器
   需配备显示器和扬声器以实现音视频输出。

使用方法

Docker Compose配置示例

yml
services:
  rpi-kodi:
    image: dachack/rpi-kodi
    container_name: "kodi"
    user: kodi
    network_mode: host
    restart: unless-stopped
    privileged: true  # 特权模式，存在安全风险
    devices:
      - /dev/fb0:/dev/fb0
      - /dev/dri:/dev/dri
      - /dev/snd:/dev/snd
      - /dev/input/event3:/dev/input/event3   # 根据evtest输出添加USB鼠标和键盘
      - /dev/input/event4:/dev/input/event4
      - /dev/input/event5:/dev/input/event5
      - /dev/input/event6:/dev/input/event6
      - /dev/input/event7:/dev/input/event7
      - /dev/input/event8:/dev/input/event8
      - /dev/input/event9:/dev/input/event9
    volumes:
      - /home/administrator/kodi/home:/home/kodi  # Kodi用户主目录挂载
      - /etc/timezone:/etc/timezone:ro            # 时区配置（只读）
      - /etc/localtime:/etc/localtime:ro          # 本地时间配置（只读）
      - /var/run/dbus:/var/run/dbus               # D-Bus通信
      - /run/udev:/run/udev                       # udev设备管理
    tmpfs:
      - /tmp  # 临时文件系统
#    environment:
#      - PULSE_SERVER=127.0.0.1  # PulseAudio服务器配置（如需）

注意事项

• 安全警告：该容器需要--privileged（特权模式）标志，存在安全风险。若有移除该标志的方法，欢迎提出建议。

• 声卡配置：此容器默认针对Proxmox虚拟机环境，选择第二块声卡作为默认设备。若在物理机上运行，需编辑asound.conf_alsa并重新构建容器，或在Dockerfile中使用asound.conf替代。

• 用户与权限配置：若需将Kodi主目录挂载到容器外部（如/home/pi/kodi/home:/home/kodi），需在主机执行以下命令创建用户并设置权限：

  bash
  # 创建kodi用户和组
  groupadd -g 9002 kodi && useradd -u 9002 -r -g kodi kodi
  
  # 设置目录权限
  chown -R kodi:kodi /home/pi/kodi/home
  

Kodi 控制

Kore-App 远程控制

推荐使用Kore-App进行远程控制：

• Android：Google Play 商店
• iOS：App Store

启用步骤：

1. 在Kodi用户数据目录创建advancedsettings.xml文件：
   /home/pi/kodi/home/.kodi/userdata/advancedsettings.xml

2. 添加以下内容以启用Kodi Web服务器：

   xml
   <advancedsettings>
       <services>
           <esallinterfaces>true</esallinterfaces>  <!-- 允许所有网络接口访问 -->
           <webserver>true</webserver>              <!-- 启用Web服务器 -->
           <zeroconf>true</zeroconf>                <!-- 启用 zeroconf 发现 -->
       </services>
   </advancedsettings>
   

本地控制

当前配置默认不支持键盘和鼠标访问。如需使用本地输入设备，需在devices部分挂载对应的输入设备（参考evtest命令输出识别设备路径）。

红外遥控器支持

如需使用红外遥控器，需在devices部分添加以下设备挂载：

yml
- /dev/lirc0:/dev/lirc0

容器创建后，需手动在容器内启动lircd服务：

bash
docker-compose exec -u root kodi lircd

贡献

该Docker项目基于 https://github.com/ehough/docker-kodi 和 https://github.com/rimago/rpi-kodi 开发。欢迎提交问题反馈或代码贡献，可通过 https://github.com/dachack/rpi-kodi/issues/new 或 https://github.com/dachack/rpi-kodi/compare 参与改进。