fhriley/kodi-headless-novnc

fhriley

无头模式的Kodi，其GUI可通过VNC（5900端口）和HTTP（noVNC，8000端口）访问，无需额外Kodi实例即可配置，且不修改代码便于更新，适用于MySQL Kodi设置以通过Web界面更新媒体库。

5 次收藏下载次数: 0状态：社区镜像维护者：fhriley仓库类型：镜像最近更新：8 天前

让 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 无法访问外链，可打开说明文档复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。

镜像标签列表与下载命令

fhriley/kodi-headless-novnc

https://github.com/fhriley/kodi-headless-novnc/actions/workflows/actions.yml/badge.svg?branch=master](https://github.com/fhriley/kodi-headless-novnc/actions/workflows/actions.yml)

Docker容器中的无头模式Kodi安装，通常与MySQL Kodi设置配合使用，允许通过Web界面更新媒体库。

https://hub.docker.com/r/fhriley/kodi-headless-novnc

https://github.com/fhriley/kodi-headless-novnc

此镜像相比其他无头镜像有两个主要优势：

Kodi图形界面可通过8000端口的Web浏览器或5900端口的VNC访问，无需运行第二个"真实"的Kodi即可完成所有配置。
此Kodi镜像不使用任何代码补丁，因此可以轻松更新到任何Kodi新版本。

使用方法

bash
docker run --name=kodi-headless-novnc \
  -d --init \
  -v <我的数据路径>:/data \
  -e KODI_DB_HOST=<我的KODI数据库主机> \
  -e KODI_DB_USER=<我的KODI数据库用户> \
  -e KODI_DB_PASS=<我的KODI数据库密码> \
  -e TZ=<我的时区> \
  -p 5900:5900/tcp \
  -p 8000:8000/tcp \
  -p 8080:8080/tcp \
  -p 9090:9090/tcp \
  -p 9777:9777/udp \
  docker.xuanyuan.run/fhriley/kodi-headless-novnc:Nexus

Docker Compose示例：

yaml
version: "3"

services:
  kodi:
   image: docker.xuanyuan.run/fhriley/kodi-headless-novnc:Nexus
   restart: always
   init: true
   ports:
     - "5900:5900/tcp"
     - "8000:8000/tcp"
     - "8080:8080/tcp"
     - "9090:9090/tcp"
     - "9777:9777/udp"
   environment:
     KODI_DB_HOST: 192.168.1.246
     KODI_DB_USER: user
     KODI_DB_PASS: password
     TZ: America/New_York
   volumes:
     - ./kodi_data:/data

端口

端口	描述
`5900/tcp`	VNC（Kodi图形界面）
`8000/tcp`	noVNC HTTP（Kodi图形界面）
`8080/tcp`	Web界面
`9090/tcp`	WebSocket
`9777/udp`	esall接口

卷

路径	描述
`/data`	Kodi数据和配置文件的存储路径

环境变量

变量名	描述
`KODI_DB_HOST`	MySQL数据库主机地址（默认值：`mysql`）
`KODI_DB_USER`	Kodi的MySQL用户名（默认值：`kodi`）
`KODI_DB_PASS`	Kodi用户的MySQL密码（默认值：`kodi`）
`KODI_DB_PORT`	MySQL远程端口（默认值：`3306`）
`KODI_UID`	容器内运行所有进程的用户ID（默认值：`2000`）
`KODI_GID`	容器内运行所有进程的组ID（默认值：`2000`）
`KODI_UMASK`	容器内所有进程的umask值（默认值：`002`）
`TZ`	容器使用的时区（默认值：`UTC`）

标签	代号	架构
`latest`	Nexus	amd64, armv7, arm64
`Omega`	Omega	amd64, armv7, arm64
`Nexus`	Nexus	amd64, armv7, arm64
`Matrix`	Matrix	amd64, armv7, arm64

用户/组标识符

使用数据卷（-v标志）时，主机操作系统和容器之间可能出现权限问题。我们通过允许您指定用户KODI_UID和组KODI_GID来避免此问题。确保主机上的数据卷目录归您指定的同一用户所有，即可正常工作。

使用id user命令查看您的用户ID和组ID：

  $ id <docker用户>
    uid=1001(dockeruser) gid=1001(dockergroup) groups=1001(dockergroup)

在此示例中，KODI_UID=1001且KODI_GID=1001。

应用设置

容器首次启动时，数据库连接设置会自动配置并存储在/data/.kodi/userdata/advancedsettings.xml中。许多其他设置也在此文件内，您可以在生成后修改此文件，或挂载自己的版本。如果挂载自己的版本，数据库配置变量（KODI_DB*）将不会被使用。

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

信息

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

credits

https://github.com/linuxserver/docker-kodi-headless/%EF%BC%88%E5%8E%9F%E5%A7%8B%E6%97%A0%E5%A4%B4%E5%AE%B9%E5%99%A8%EF%BC%89
https://github.com/matthuisman/docker-kodi-headless/%EF%BC%88%E6%AD%A4README%EF%BC%89

快速扫描

如果您的媒体与该Docker容器在同一台机器上，且通过smb://在网络上共享媒体，以下方法适用。

首先，将主机媒体目录挂载到容器内的某个位置，使Kodi可以访问。
例如：--mount type=bind,source=/sharedfolders/pool,target=/media

然后，在Kodi的advancedsettings.xml中进行以下配置：

<pathsubstitution>
  <substitute>
    <from>smb://192.168.20.3/sharedfolders/pool/</from>
    <to>/media/</to>
  </substitute>
</pathsubstitution>

完成。
现在Kodi不会通过smb://扫描，而是替换为/media/，扫描速度更快。找到新项目时，会以smb://路径正确存储在SQL中。

Kodi崩溃

如果容器启动后Kodi立即崩溃，请查看https://docs.linuxserver.io/faq#libseccomp%E8%8E%B7%E5%8F%96%E5%8F%AF%E8%83%BD%E7%9A%84%E4%BF%AE%E5%A4%8D%E6%96%B9%E6%B3%95%E3%80%82

镜像拉取方式

您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问标签列表页面。

轩辕镜像加速拉取命令点我查看更多 kodi-headless-novnc 镜像标签

docker pull docker.xuanyuan.run/fhriley/kodi-headless-novnc:<标签>

使用方法：

DockerHub 原生拉取命令

docker pull fhriley/kodi-headless-novnc:<标签>

轩辕镜像配置手册

按平台快速找到配置文档

Docker

登录仓库拉取

登录认证 · 私有仓库

专属域名拉取

免登录 · 高速拉取

Linux

Docker 镜像配置

Windows / Mac

Docker Desktop 配置

MacOS OrbStack

OrbStack 容器

Apple Container

macOS 原生容器

Docker Compose

Compose 项目配置

NAS

群晖

Synology 配置

飞牛

fnOS 镜像配置

绿联

绿联 NAS

威联通

QNAP 配置

极空间

极空间 NAS

Unraid

Unraid NAS

企业仓库

其他仓库

ghcr · Quay · nvcr

Harbor 镜像源

Proxy Repository 对接

Portainer 镜像源

Registries 配置

Nexus 镜像源

Docker Proxy 缓存

开发工具

Dev Containers

VS Code 开发容器

Podman

Podman 配置指南

Singularity / Apptainer

HPC 科学计算容器

Kubernetes

K8s Containerd

Kubernetes · Containerd

K3s

轻量级集群

面板 / 网络

爱快路由

iKuai 镜像加速

宝塔面板

一键配置镜像源

AI

用 AI 使用轩辕镜像

agents.md · AI 对话 · 提示词

一键安装

一键安装 Docker

Linux Docker 一键安装

需要其他帮助？请查看我们的常见问题Docker 镜像访问常见问题解答或提交工单

镜像拉取常见问题

功能

版本功能对比

功能对比 · 版本选择

支持的镜像仓库

Docker Hub · GCR · GHCR

新手拉取配置

docker search 限制

专属域名 · Hub 搜索

不支持 push

仅支持 pull · 不支持

拉取速度原因

带宽 · 缓存 · 冷热镜像

错误码

402 与流量用尽

402 · 流量包 · 充值

401 认证失败

401 · docker login

manifest unknown

标签错误 · 镜像不存在

410 Gone 排查

410 · Docker 升级

429 限流

免费版 · 请求频率

其他报错

DNS 超时

DNS 解析 · 网络超时

TLS 证书失败

no matching manifest（架构）

账号

失败是否计费

manifest · blob · 计费

申请开发票（企业 / 个人）

企业 · 个人 · 工单

修改登录密码

网站 · 仓库 · 重置

注销账户

工单 · 数据 · 注销

原理

mirrors 不生效

daemon.json · 重启

去掉域名前缀

docker tag · 重命名

指定架构拉取

ARM64 · AMD64 · 多架构

latest 与「最新」

digest · 版本号 · 标签

查看全部问题→

用户好评

来自真实用户的反馈，见证轩辕镜像的优质服务

oldzhang

运维工程师

Linux服务器

"Docker访问体验非常流畅，大镜像也能快速完成下载。"

fhriley/kodi-headless-novnc

fhriley

无头模式的Kodi，其GUI可通过VNC（5900端口）和HTTP（noVNC，8000端口）访问，无需额外Kodi实例即可配置，且不修改代码便于更新，适用于MySQL Kodi设置以通过Web界面更新媒体库。

5 次收藏下载次数: 0状态：社区镜像维护者：fhriley仓库类型：镜像最近更新：8 天前

让 AI 帮你使用轩辕镜像？ · 展开查看说明 · 点击收起说明

只需在 AI 对话中先发送下面这句话即可：

请先完整阅读并严格遵守以下文档中的全部规则与要求：

https://xuanyuan.cloud/agents.md

在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。

镜像标签列表与下载命令

fhriley/kodi-headless-novnc

https://github.com/fhriley/kodi-headless-novnc/actions/workflows/actions.yml/badge.svg?branch=master](https://github.com/fhriley/kodi-headless-novnc/actions/workflows/actions.yml)

Docker容器中的无头模式Kodi安装，通常与MySQL Kodi设置配合使用，允许通过Web界面更新媒体库。

https://hub.docker.com/r/fhriley/kodi-headless-novnc

https://github.com/fhriley/kodi-headless-novnc

此镜像相比其他无头镜像有两个主要优势：

Kodi图形界面可通过8000端口的Web浏览器或5900端口的VNC访问，无需运行第二个"真实"的Kodi即可完成所有配置。
此Kodi镜像不使用任何代码补丁，因此可以轻松更新到任何Kodi新版本。

使用方法

bash
docker run --name=kodi-headless-novnc \
  -d --init \
  -v <我的数据路径>:/data \
  -e KODI_DB_HOST=<我的KODI数据库主机> \
  -e KODI_DB_USER=<我的KODI数据库用户> \
  -e KODI_DB_PASS=<我的KODI数据库密码> \
  -e TZ=<我的时区> \
  -p 5900:5900/tcp \
  -p 8000:8000/tcp \
  -p 8080:8080/tcp \
  -p 9090:9090/tcp \
  -p 9777:9777/udp \
  docker.xuanyuan.run/fhriley/kodi-headless-novnc:Nexus

Docker Compose示例：

yaml
version: "3"

services:
  kodi:
   image: docker.xuanyuan.run/fhriley/kodi-headless-novnc:Nexus
   restart: always
   init: true
   ports:
     - "5900:5900/tcp"
     - "8000:8000/tcp"
     - "8080:8080/tcp"
     - "9090:9090/tcp"
     - "9777:9777/udp"
   environment:
     KODI_DB_HOST: 192.168.1.246
     KODI_DB_USER: user
     KODI_DB_PASS: password
     TZ: America/New_York
   volumes:
     - ./kodi_data:/data

端口

端口	描述
`5900/tcp`	VNC（Kodi图形界面）
`8000/tcp`	noVNC HTTP（Kodi图形界面）
`8080/tcp`	Web界面
`9090/tcp`	WebSocket
`9777/udp`	esall接口

卷

路径	描述
`/data`	Kodi数据和配置文件的存储路径

环境变量

变量名	描述
`KODI_DB_HOST`	MySQL数据库主机地址（默认值：`mysql`）
`KODI_DB_USER`	Kodi的MySQL用户名（默认值：`kodi`）
`KODI_DB_PASS`	Kodi用户的MySQL密码（默认值：`kodi`）
`KODI_DB_PORT`	MySQL远程端口（默认值：`3306`）
`KODI_UID`	容器内运行所有进程的用户ID（默认值：`2000`）
`KODI_GID`	容器内运行所有进程的组ID（默认值：`2000`）
`KODI_UMASK`	容器内所有进程的umask值（默认值：`002`）
`TZ`	容器使用的时区（默认值：`UTC`）

标签	代号	架构
`latest`	Nexus	amd64, armv7, arm64
`Omega`	Omega	amd64, armv7, arm64
`Nexus`	Nexus	amd64, armv7, arm64
`Matrix`	Matrix	amd64, armv7, arm64

用户/组标识符

使用id user命令查看您的用户ID和组ID：

  $ id <docker用户>
    uid=1001(dockeruser) gid=1001(dockergroup) groups=1001(dockergroup)

在此示例中，KODI_UID=1001且KODI_GID=1001。

应用设置

信息

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

credits

https://github.com/linuxserver/docker-kodi-headless/%EF%BC%88%E5%8E%9F%E5%A7%8B%E6%97%A0%E5%A4%B4%E5%AE%B9%E5%99%A8%EF%BC%89
https://github.com/matthuisman/docker-kodi-headless/%EF%BC%88%E6%AD%A4README%EF%BC%89

快速扫描

如果您的媒体与该Docker容器在同一台机器上，且通过smb://在网络上共享媒体，以下方法适用。

首先，将主机媒体目录挂载到容器内的某个位置，使Kodi可以访问。
例如：--mount type=bind,source=/sharedfolders/pool,target=/media

然后，在Kodi的advancedsettings.xml中进行以下配置：

<pathsubstitution>
  <substitute>
    <from>smb://192.168.20.3/sharedfolders/pool/</from>
    <to>/media/</to>
  </substitute>
</pathsubstitution>

完成。
现在Kodi不会通过smb://扫描，而是替换为/media/，扫描速度更快。找到新项目时，会以smb://路径正确存储在SQL中。

Kodi崩溃

如果容器启动后Kodi立即崩溃，请查看https://docs.linuxserver.io/faq#libseccomp%E8%8E%B7%E5%8F%96%E5%8F%AF%E8%83%BD%E7%9A%84%E4%BF%AE%E5%A4%8D%E6%96%B9%E6%B3%95%E3%80%82

镜像拉取方式

您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问标签列表页面。

轩辕镜像加速拉取命令点我查看更多 kodi-headless-novnc 镜像标签

docker pull docker.xuanyuan.run/fhriley/kodi-headless-novnc:<标签>

使用方法：

DockerHub 原生拉取命令

docker pull fhriley/kodi-headless-novnc:<标签>

轩辕镜像配置手册

按平台快速找到配置文档

Docker

登录仓库拉取

登录认证 · 私有仓库

专属域名拉取

免登录 · 高速拉取

Linux

Docker 镜像配置

Windows / Mac

Docker Desktop 配置

MacOS OrbStack

OrbStack 容器

Apple Container

macOS 原生容器

Docker Compose

Compose 项目配置

NAS

群晖

Synology 配置

飞牛

fnOS 镜像配置

绿联

绿联 NAS

威联通

QNAP 配置

极空间

极空间 NAS

Unraid

Unraid NAS

企业仓库

其他仓库

ghcr · Quay · nvcr

Harbor 镜像源

Proxy Repository 对接

Portainer 镜像源

Registries 配置

Nexus 镜像源

Docker Proxy 缓存

开发工具

Dev Containers

VS Code 开发容器

Podman

Podman 配置指南

Singularity / Apptainer

HPC 科学计算容器

Kubernetes

K8s Containerd

Kubernetes · Containerd

K3s

轻量级集群

面板 / 网络

爱快路由

iKuai 镜像加速

宝塔面板

一键配置镜像源

AI

用 AI 使用轩辕镜像

agents.md · AI 对话 · 提示词

一键安装

一键安装 Docker

Linux Docker 一键安装

需要其他帮助？请查看我们的常见问题Docker 镜像访问常见问题解答或提交工单

镜像拉取常见问题

功能

版本功能对比

功能对比 · 版本选择

支持的镜像仓库

Docker Hub · GCR · GHCR

新手拉取配置

docker search 限制

专属域名 · Hub 搜索

不支持 push

仅支持 pull · 不支持

拉取速度原因

带宽 · 缓存 · 冷热镜像

错误码

402 与流量用尽

402 · 流量包 · 充值

401 认证失败

401 · docker login

manifest unknown

标签错误 · 镜像不存在

410 Gone 排查

410 · Docker 升级

429 限流

免费版 · 请求频率

其他报错

DNS 超时

DNS 解析 · 网络超时

TLS 证书失败

no matching manifest（架构）

账号

失败是否计费

manifest · blob · 计费

申请开发票（企业 / 个人）

企业 · 个人 · 工单

修改登录密码

网站 · 仓库 · 重置

注销账户

工单 · 数据 · 注销

原理

mirrors 不生效

daemon.json · 重启

去掉域名前缀

docker tag · 重命名

指定架构拉取

ARM64 · AMD64 · 多架构

latest 与「最新」

digest · 版本号 · 标签

查看全部问题→

用户好评

来自真实用户的反馈，见证轩辕镜像的优质服务

oldzhang

运维工程师

Linux服务器

"Docker访问体验非常流畅，大镜像也能快速完成下载。"