fhriley/kodi-headless-novnc Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

fhriley/kodi-headless-novnc

![构建镜像]([***]

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

[***]

[***]

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

1. Kodi图形界面可通过8000端口的Web浏览器或5900端口的VNC访问，无需运行第二个"真实"的Kodi即可完成所有配置。

2. 此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 \
  fhriley/kodi-headless-novnc:Nexus

Docker Compose示例：

yaml
version: "3"

services:
  kodi:
   image: 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

端口

卷

环境变量

标签

强烈建议使用代号标签而非latest。Docker会自动为您的平台拉取正确架构的镜像。

用户/组标识符

使用数据卷（-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

• linuxserver（原始无头容器）
• matthuisman（此README）

快速扫描

如果您的媒体与该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立即崩溃，请查看以下内容获取可能的修复方法。