Docker容器中的无界面Kodi安装,特别适用于Kodi的MySQL设置,无需播放器系统持续运行即可发送媒体库更新。
https://raw.githubusercontent.com/linuxserver/docker-templates/master/linuxserver.io/img/kodi-banner.png]appurl
bashdocker 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。
-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界面的设置部分启用。
docker exec -it kodi-headless /bin/bashdocker logs -f kodi-headless感谢以下贡献者提供的灵感,尤其是无界面补丁,使其成为可能:
以及Kodi社区其他提供建议的成员。
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。




探索更多轩辕镜像的使用方法,找到最适合您系统的配置方式
通过 Docker 登录认证访问私有仓库
无需登录使用专属域名
Kubernetes 集群配置 Containerd
K3s 轻量级 Kubernetes 镜像加速
VS Code Dev Containers 配置
Podman 容器引擎配置
HPC 科学计算容器配置
ghcr、Quay、nvcr 等镜像仓库
Harbor Proxy Repository 对接专属域名
Portainer Registries 加速拉取
Nexus3 Docker Proxy 内网缓存
需要其他帮助?请查看我们的 常见问题Docker 镜像访问常见问题解答 或 提交工单
docker search 限制
站内搜不到镜像
离线 save/load
插件要用 plugin install
WSL 拉取慢
安全与 digest
新手拉取配置
镜像合规机制
manifest unknown
no matching manifest(架构)
invalid tar header(解压)
TLS 证书失败
DNS 超时
域名连通性排查
410 Gone 排查
402 与流量用尽
401 认证失败
429 限流
D-Bus 凭证提示
413 与超大单层
来自真实用户的反馈,见证轩辕镜像的优质服务