celedhrim/kodi-server
celedhrim
自动构建
用于服务器/NAS的Kodi无头服务器，可通过UPnP向客户端/播放器共享媒体库，提供Web访问，并支持通过API或外部工具（如Sonarr、Radarr等）触发库扫描。
42 次收藏下载次数: 0状态：自动构建维护者：celedhrim仓库类型：镜像最近更新：3 年前
让 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 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
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
| 分支名称（branchname） | Kodi分支 | Kodi版本 | Ubuntu版本 |
|---|---|---|---|
latest（默认） | matrix | 19.1 | 18.04（Bionic Beaver） |
helix | helix | 14.2 | 14.04（Trusty Tahr） |
isengard | isengard | 15.2 | 14.04（Trusty Tahr） |
jarvis | jarvis | 16.1 | 16.04（Xenial Xerus） |
krypton | krypton | 17.6 | Archlinux |
leia | leia | 18.9 | 18.04（Bionic Beaver） |
matrix | matrix | 19.1 | 18.04（Bionic Beaver） |
experimental | krypton | 17.0rc2 | 18.04（Bionic Beaver） |
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 .
构建完成后，可参考“快速启动”部分运行容器。
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 kodi-server 镜像标签
docker pull docker.xuanyuan.run/celedhrim/kodi-server:<标签>
DockerHub 原生拉取命令
docker pull celedhrim/kodi-server:<标签>
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"