erichough/kodi

erichough/kodi

Docker化的Kodi媒体中心，支持音频和视频功能。

!Kodi截图

核心功能

• 容器内包含完整功能的Kodi安装
• 支持音频（ALSA或PulseAudio）和视频（可选OpenGL硬件加速），通过https://github.com/mviereck/x11docker/%E5%AE%9E%E7%8E%B0
• 基于Ubuntu构建，严格遵循官方Kodi安装指南
• 容器终止时Kodi可干净关闭

主机前提条件

1. Linux系统与Docker：需安装功能正常的Docker环境
2. 显示设备与扬声器：需要连接显示器和扬声器（无头模式不适用）
3. X或Wayland：主机需安装X或Wayland显示服务器
4. x11docker：需安装https://github.com/mviereck/x11docker/%E4%BB%A5%E6%94%AF%E6%8C%81%E5%AE%B9%E5%99%A8%E8%AE%BF%E9%97%AE%E4%B8%BB%E6%9C%BA%E6%98%BE%E7%A4%BA%E5%92%8C%E9%9F%B3%E9%A2%91

使用场景

适用于家庭媒体中心、个人娱乐系统等需要Kodi媒体播放功能的场景，通过容器化方式简化部署与管理。

配置说明

启动Kodi

使用x11docker启动镜像，以下是示例命令（多行拆分便于阅读）：

bash
$ x11docker --xorg                                 \
            --pulseaudio                           \
            --gpu                                  \
            --homedir /主机路径/to/kodi/home      \
            -- -v /主机路径/to/media:/media:ro -- \
            erichough/kodi

其中--之间的参数会传递给docker run，可根据需求调整。

停止Kodi

可通过Kodi界面的电源菜单关闭，或从命令行终止容器。

systemd服务示例

ini
[Unit]
Description=Dockerized Kodi
Requires=docker.service
After=network.target docker.service

[Service]
ExecStartPre=/usr/bin/docker pull erichough/kodi
ExecStart=/usr/bin/x11docker ... erichough/kodi
Restart=always
KillMode=process

[Install]
WantedBy=multi-user.target

高级功能

更多高级功能请参考高级文档，包括自定义插件、镜像变体、自定义启动行为等。

帮助与贡献

若遇到问题，可在https://github.com/ehough/docker-kodi/discussions%E6%8F%90%E9%97%AE%EF%BC%9B%E6%AC%A2%E8%BF%8E%E9%80%9A%E8%BF%87https://github.com/ehough/docker-kodi/issues/new%E6%88%96https://github.com/ehough/docker-kodi/compare%E8%B4%A1%E7%8C%AE%E4%BB%A3%E7%A0%81%E3%80%82