celedhrim/kodi-server

docker-kodi-server 镜像文档

镜像概述和主要用途

docker-kodi-server 是一个通过Docker运行Kodi作为服务器的镜像，旨在将Kodi部署为无头（无图形界面）服务，适用于服务器或NAS环境。它允许通过UPnP协议共享媒体库，提供Web访问接口，并支持外部工具触发媒体库扫描，满足多设备媒体共享和管理需求。

核心功能和特性

• UPnP媒体共享：通过Kodi UPnP库向UPnP客户端/播放器（如Kodi、Chromecast等）提供媒体文件服务。
• Web访问支持：可通过Web界面访问Kodi，或与htpc-manager等工具集成。
• 库扫描触发：支持通过API或外部工具（如Sickbeard、SickRage、CouchPotato、Sonarr、Radarr等）触发媒体库扫描。

使用场景和适用范围

• 家庭媒体中心服务器，需向多设备共享媒体库。
• NAS环境中部署Kodi，实现无图形界面的媒体管理。
• 需要远程管理媒体库或通过外部工具自动化更新媒体库的场景。

前提条件

• Docker：需先安装Docker，可参考Docker官方安装指南。
• MySQL共享库（推荐）：若不使用UPnP，建议配置MySQL共享库以实现库共享。

快速启动

1. 准备Kodi配置文件

使用Windows或Linux的Kodi GUI版本创建完整配置文件：

• 若需Web访问，需启用Web服务并将端口设置为8089（镜像默认暴露8089端口，避免与8080端口的HTTP代理冲突）。
• 配置建议：
  • 无需显示界面，可禁用所有菜单并设置Kodi启动时直接进入设置。
  • 由于使用软件模拟显示，图形变化会消耗CPU，建议在设置（设置 > 媒体 > 库）中禁用“库更新进度显示”。
  • 仅配置媒体刮削器，并设置插件自动更新。

2. 复制配置文件

将Kodi配置目录（通常为~/.kodi）复制到目标位置（示例路径）：

bash
$ cp -r ~/.kodi ~/kodi-server-profile

3. 拉取预构建镜像

最新稳定版

bash
$ docker pull celedhrim/kodi-server

指定版本

bash
$ docker pull celedhrim/kodi-server:branchname

4. 运行容器

替换/path/to/kodi-server-profile为实际配置文件路径：

bash
$ docker run -d --restart="always" --net=host -v /path/to/kodi-server-profile:/usr/share/kodi/portable_data celedhrim/kodi-server

若使用指定分支：

bash
$ docker run -d --restart="always" --net=host -v /path/to/kodi-server-profile:/usr/share/kodi/portable_data celedhrim/kodi-server:branchname

自行构建容器

bash
$ git clone https://github.com/Celedhrim/docker-kodi-server.git
$ cd docker-kodi-server
$ git checkout branchname  # 替换为目标分支
$ docker build --rm=true -t $(whoami)/kodi-server .

构建完成后，可参考“快速启动”部分运行容器。