linuxserver/kodi-headless

![Build Status]([***]

LinuxServer.io团队为您带来另一款容器，具备便捷的用户映射和社区支持。获取支持请访问：

• forum.linuxserver.io（论坛）
• IRC（在freenode上的#linuxserver.io频道）
• 播客（涵盖如何充分利用Linux服务器的所有内容，重点关注Docker和容器化相关主题！）

镜像概述

Docker容器中的无界面Kodi安装，特别适用于Kodi的MySQL设置，无需播放器系统持续运行即可发送媒体库更新。

使用方法

bash
docker create --name=kodi-headless \
-v 数据路径:/config/.kodi \
-e PGID=组ID -e PUID=用户ID \
-e TZ=时区 \
-p 8080:8080 \
-p 9090:9090 \
-p 9777:9777/udp \
linuxserver/kodi-headless

您可以通过使用标签选择不同的Kodi主要版本。如需指定版本，在linuxserver/kodi-headless后添加标签，格式为linuxserver/kodi-headless:Krypton。

标签

• Helix
• Isengard
• Jarvis
• Krypton
• Leia：当前默认分支。

参数说明

• -p 8080 - web界面端口
• -p 9090 - websockets端口
• -p 9777/udp - esall接口端口
• -v /config/.kodi - Kodi配置文件路径
• -e PGID - 组ID（详见下文说明）
• -e PUID - 用户ID（详见下文说明）
• -e TZ - 时区信息（例如 Europe/London 等）

该镜像基于Ubuntu Bionic，使用s6 overlay。如需在容器运行时访问shell，请执行docker exec -it kodi-headless /bin/bash。

用户/组标识符

使用数据卷（-v参数）时，主机OS与容器之间可能出现权限问题。通过指定用户PUID和组PGID可避免此问题。确保主机上的数据卷目录归属于您指定的用户，即可正常工作。

示例中PUID=1001和PGID=1001。使用id user命令可获取您的用户ID和组ID：

bash
  $ id dockeruser
    uid=1001(dockeruser) gid=1001(dockergroup) groups=1001(dockergroup)

应用设置

MySQL/MariaDB设置需通过编辑advancedsettings.xml文件进行配置，该文件位于/config/.kodi映射的userdata文件夹中。许多其他设置也可在此文件中配置。

web界面及CouchPotato等应用发送更新的默认用户/密码为kodi/kodi。

若您打算使用此Kodi实例执行除更新外的媒体库任务（如媒体库清理等），务必将初始媒体库扫描所在主机的sources.xml文件复制到此实例的userdata文件夹，否则极可能导致数据库丢失。

Leia分支的Rar集成由插件处理，已随镜像编译，但如需使用，需在web界面的设置部分启用。

信息

• 容器运行时的Shell访问：docker exec -it kodi-headless /bin/bash
• 实时监控容器日志：docker logs -f kodi-headless

贡献者

感谢以下贡献者提供的灵感，尤其是无界面补丁，使其成为可能：

• Celedhrim
• sinopsysHK
• wernerb

以及Kodi社区其他提供建议的成员。

版本历史

• 23.06.19: 将Leia版本更新至18.3。
• 23.04.19: 将Leia版本更新至18.2。
• 09.03.19: 构建vfs.libarchive和vfs.rar插件。
• 08.03.19: 将Leia设为默认分支，使用补丁版“headless”构建。
• 30.01.19: 将Leia分支更新至发布版PPA。
• 03.09.18: 恢复libnfs依赖。
• 31.08.18: 基于Ubuntu Bionic重构，使用构建阶段，并添加websockets端口说明。
• 04.01.18: 弃用cpu_core例程（缺乏扩展性）。
• 14.12.17: 修复续行符。
• 17.11.17: 将Krypton版本更新至17.6。
• 24.10.17: 将Krypton版本更新至17.5。
• 22.08.17: 将Krypton版本更新至17.4。
• 25.05.17: 将Krypton版本更新至17.3。
• 23.05.17: 将Krypton版本更新至17.2。
• 23.04.17: 优化cmake，使用cmake PPA并移除不必要的引导行。
• 22.02.17: 切换至cmake构建系统。
• 22.02.17: 将Krypton版本更新至17.1。
• 22.02.17: 将web界面默认用户/密码更改为kodi/kodi。
• 05.02.17: 将Krypton设为默认分支。
• 20.09.16: 添加kodi-send并修复var cache samba权限。
• 10.09.16: 为README添加图层徽章。
• 02.09.16: 基于Alpine Linux重构。
• 13.03.16: 将Kodi 16（Jarvis）设为默认安装版本。
• 21.08.15: 初始发布。