linuxserver/kanzi

linuxserver/kanzi

弃用通知

该镜像已被弃用。我们将不再为该镜像提供支持，也不会对其进行更新。

镜像概述

Kanzi（前身为Kodi-Alexa）是一款用于导航Kodi的终极语音遥控器自定义技能，支持100+种指令。此容器还包含lexigram-cli，用于通过Amazon开发者账户设置Kanzi并自动将其部署到Amazon。

注意：该镜像已被弃用，不再接收更新和支持。

支持的架构

该镜像利用Docker manifest实现多平台支持。直接拉取 lscr.io/linuxserver/kanzi:latest 即可获取适合您架构的正确镜像，也可通过标签拉取特定架构的镜像。

支持的架构如下：

应用设置

初始设置

首次启动容器后，需执行以下步骤才能使用：

1. 创建Amazon开发者账户：点击此处。
2. 在容器的/config目录中打开终端：docker exec -itw /config kanzi bash。
3. 输入lexigram login --no-browser true设置AWS凭证，复制显示的URL到浏览器，登录Amazon开发者账户，将生成的授权码粘贴回终端并按回车。
4. 根据本地设置编辑kodi.config文件，该文件将被内置的gunicorn服务器用于响应请求。
5. 重启容器以自动部署Kanzi技能。
6. 使用https://hub.docker.com/r/linuxserver/letsencrypt/%E5%8F%8D%E5%90%91%E4%BB%A3%E7%90%86%E6%AD%A4%E5%AE%B9%E5%99%A8%EF%BC%88%E8%AF%A5%E5%AE%B9%E5%99%A8%E5%8C%85%E5%90%AB%E9%A2%84%E9%85%8D%E7%BD%AE%E6%A8%A1%E6%9D%BF%EF%BC%8C%E5%8F%AF%E9%80%9A%E8%BF%87Docker%E8%87%AA%E5%AE%9A%E4%B9%89%E7%BD%91%E7%BB%9C%E5%B0%86Kanzi%E5%AE%B9%E5%99%A8%E5%8F%8D%E5%90%91%E4%BB%A3%E7%90%86%E5%88%B0%E5%AD%90%E5%9F%9F%E6%88%96%E5%AD%90%E6%96%87%E4%BB%B6%E5%A4%B9%EF%BC%89%E3%80%82%E8%8B%A5%E5%B7%B2%E8%AE%BE%E7%BD%AENginx%E5%8F%8D%E5%90%91%E4%BB%A3%E7%90%86%EF%BC%8C%E5%8F%AF%E4%BD%BF%E7%94%A8%E4%BB%A5%E4%B8%8Blocation%E5%9D%97%E5%B0%86Kanzi%E5%8F%8D%E5%90%91%E4%BB%A3%E7%90%86%E5%88%B0%E5%AD%90%E6%96%87%E4%BB%B6%E5%A4%B9%E6%88%96%E5%AD%90%E5%9F%9F%EF%BC%9A

子文件夹配置

nginx
location /kanzi {
  rewrite           ^/kanzi/(.*)  /$1  break;
  proxy_pass         https://$IP-ADDRESS:8000;
  proxy_redirect     https://$IP-ADDRESS:8000 /kanzi;
  proxy_set_header   Host $host;
  proxy_set_header   X-Real-IP $remote_addr;
  proxy_set_header   X-Forwarded-For $proxy_add_x_forwarded_for;
  proxy_set_header   X-Forwarded-Server $host;
  proxy_set_header   X-Forwarded-Host $server_name;
}

子域配置

nginx
location / {
  proxy_pass         https://$IP-ADDRESS:8000;
  proxy_set_header   Host $host;
  proxy_set_header   X-Real-IP $remote_addr;
  proxy_set_header   X-Forwarded-For $proxy_add_x_forwarded_for;
  proxy_set_header   X-Forwarded-Server $host;
  proxy_set_header   X-Forwarded-Host $server_name;
}

使用方法

docker-compose（推荐）

yaml
---
version: "2.1"
services:
  kanzi:
    image: lscr.io/linuxserver/kanzi:latest
    container_name: kanzi
    environment:
      - PUID=1000  # 用户ID，详见下文说明
      - PGID=1000  # 组ID，详见下文说明
      - TZ=Europe/London  # 时区，例如 Asia/Shanghai
      - INVOCATION_NAME=kanzi  # 技能调用名称，可选kanzi或kod
      - URL_ENDPOINT=https://server.com/kanzi/  # 服务器可访问URL，需包含末尾斜杠
    volumes:
      - </path/to/appdata/config>:/config  # 配置文件目录
    ports:
      - 8000:8000  # 应用端口
    restart: unless-stopped

docker cli

bash
docker run -d \
  --name=kanzi \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Europe/London \
  -e INVOCATION_NAME=kanzi \
  -e URL_ENDPOINT=https://server.com/kanzi/ \
  -p 8000:8000 \
  -v </path/to/appdata/config>:/config \
  --restart unless-stopped \
  lscr.io/linuxserver/kanzi:latest

参数说明

容器运行时通过参数配置，格式为<外部>:<内部>。

环境变量从文件读取（Docker密钥）

可通过特殊前缀FILE__从文件设置环境变量。例如：

bash
-e FILE__PASSWORD=/run/secrets/mysecretpassword

这将根据/run/secrets/mysecretpassword文件内容设置PASSWORD环境变量。

应用运行的Umask设置

所有镜像支持通过-e UMASK=022覆盖默认umask设置。注意umask是权限减法而非加法，详情参考umask说明。

用户/组ID

使用卷（-v标志）时，主机OS与容器可能出现权限问题。通过指定用户ID（PUID）和组ID（PGID）可避免此问题。确保主机上的卷目录由指定用户拥有，权限问题将解决。

获取当前用户的PUID和PGID：

bash
$ id username
  uid=1000(dockeruser) gid=1000(dockergroup) groups=1000(dockergroup)

Docker Mods

我们发布多种https://github.com/linuxserver/docker-mods%E4%BB%A5%E5%A2%9E%E5%BC%BA%E5%AE%B9%E5%99%A8%E5%8A%9F%E8%83%BD%E3%80%82%E5%8F%AF%E9%80%9A%E8%BF%87%E5%8A%A8%E6%80%81%E5%BE%BD%E7%AB%A0%E6%9F%A5%E7%9C%8B%E6%AD%A4%E9%95%9C%E5%83%8F%E5%8F%AF%E7%94%A8%E7%9A%84Mods%E5%8F%8A%E9%80%9A%E7%94%A8Mods%E3%80%82

支持信息

• 容器运行时的Shell访问：docker exec -it kanzi /bin/bash
• 实时监控容器日志：docker logs -f kanzi
• 容器版本号：docker inspect -f '{{ index .Config.Labels "build_version" }}' kanzi
• 镜像版本号：docker inspect -f '{{ index .Config.Labels "build_version" }}' lscr.io/linuxserver/kanzi:latest

更新信息

大多数镜像为静态版本，需更新镜像并重建容器以更新应用。不建议在容器内更新应用（部分例外如nextcloud、plex）。

通过Docker Compose更新

• 更新所有镜像：docker-compose pull
  • 或更新单个镜像：docker-compose pull kanzi
• 更新容器：docker-compose up -d
  • 或更新单个容器：docker-compose up -d kanzi
• 清理旧镜像：docker image prune

通过Docker Run更新

• 更新镜像：docker pull lscr.io/linuxserver/kanzi:latest
• 停止容器：docker stop kanzi
• 删除容器：docker rm kanzi
• 用原参数重建容器（配置文件在主机目录则会保留）
• 清理旧镜像：docker image prune

通过Watchtower自动更新（仅忘记原参数时使用）

bash
docker run --rm \
  -v /var/run/docker.sock:/var/run/docker.sock \
  containrrr/watchtower \
  --run-once kanzi

注意：不推荐使用Watchtower自动更新容器，建议使用Docker Compose。

镜像更新通知 - Diun

推荐使用Diun接收更新通知，不推荐自动更新容器的工具。

本地构建

如需本地修改镜像：

bash
git clone https://github.com/linuxserver/docker-kanzi.git
cd docker-kanzi
docker build \
  --no-cache \
  --pull \
  -t lscr.io/linuxserver/kanzi:latest .

在x86_64硬件上构建ARM变体，需使用multiarch/qemu-user-static：

bash
docker run --rm --privileged multiarch/qemu-user-static:register --reset

注册后，使用-f Dockerfile.aarch64指定Dockerfile。

版本历史

• 20.06.22: - 弃用镜像。
• 13.04.19: - 初始发布。