linuxserver/kanzi

linuxserver/kanzi

弃用通知

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

镜像概述

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

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

支持的架构

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

支持的架构如下：

应用设置

初始设置

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

1. 创建Amazon开发者账户：https://developer.amazon.com/。
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/反向代理此容器（该容器包含预配置模板，可通过Docker自定义网络将Kanzi容器反向代理到子域或子文件夹）。若已设置Nginx反向代理，可使用以下location块将Kanzi反向代理到子文件夹或子域：

子文件夹配置

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: docker.xuanyuan.run/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 \
  docker.xuanyuan.run/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以增强容器功能。可通过动态徽章查看此镜像可用的Mods及通用Mods。

支持信息

• 容器运行时的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 docker.xuanyuan.run/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 \
  docker.xuanyuan.run/containrrr/watchtower \
  --run-once kanzi

注意：不推荐使用Watchtower自动更新容器，建议使用https://docs.linuxserver.io/general/docker-compose。

镜像更新通知 - Diun

推荐使用https://crazymax.dev/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 docker.xuanyuan.run/multiarch/qemu-user-static:register --reset

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

版本历史

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