lsiodev/kanzi

https://github.com/linuxserver/docker-kanzi

镜像概述和主要用途

Kanzi（原名为Kodi-Alexa）是一个自定义技能，作为Kodi的终极语音遥控器，支持100多个操作意图，可实现Kodi的各种导航和控制功能。此容器还集成了lexigram-cli工具，用于将Kanzi与Amazon开发者账户关联并自动部署到Amazon平台。

核心功能和特性

• 作为Kodi的语音控制中心，支持100+操作意图
• 内置lexigram-cli工具，简化Amazon开发者账户配置和技能部署流程
• 支持多架构部署（x86-64、arm64、armhf）
• 基于LinuxServer.io自定义基础镜像，集成s6 overlay
• 定期应用更新和安全补丁
• 支持用户ID（PUID）和组ID（PGID）映射，解决权限问题

支持的架构

应用设置

初始设置

首次启动容器后，需完成以下配置步骤：

1. 创建Amazon开发者账户：点击注册
2. 进入容器的/config目录终端：docker exec -itw /config kanzi bash
3. 运行lexigram login --no-browser true配置AWS凭证，复制显示的URL到浏览器，登录Amazon开发者账户后，将授权码粘贴回终端并按回车
4. 根据本地Kodi设置编辑kodi.config文件，该文件将被内置的gunicorn服务器用于处理请求
5. 重启容器以自动部署Kanzi技能
6. 使用https://hub.docker.com/r/linuxserver/letsencrypt/%EF%BC%88%E5%90%AB%E9%A2%84%E9%85%8D%E7%BD%AE%E6%A8%A1%E6%9D%BF%EF%BC%89%E6%88%96%E7%8E%B0%E6%9C%89Nginx%E5%8F%8D%E5%90%91%E4%BB%A3%E7%90%86%EF%BC%8C%E4%BB%A5%E4%B8%8B%E6%98%AF%E6%8E%A8%E8%8D%90%E7%9A%84Nginx%E9%85%8D%E7%BD%AE%EF%BC%9A

子文件夹配置

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;
}

子域配置

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
    container_name: kanzi
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Europe/London
      - INVOCATION_NAME=kanzi
      - URL_ENDPOINT=https://server.com/kanzi/
    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

参数说明

环境变量文件（Docker secrets）

可通过FILE__前缀从文件加载环境变量，例如：

bash
-e FILE__PASSWORD=/run/secrets/mysecretpassword

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

Umask设置

通过-e UMASK=022可覆盖容器内服务的默认umask值。umask用于设置文件创建权限，详情参考umask说明。

用户/组标识符

使用卷时可能出现权限问题，通过指定PUID和PGID可解决。确保主机卷目录所有者与指定ID匹配。使用id username命令获取当前用户的PUID和PGID：

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

Docker Mods

https://img.shields.io/badge/dynamic/yaml?color=94398d&labelColor=555555&logoColor=ffffff&style=for-the-badge&label=kanzi&query=%24.mods%5B%27kanzi%27%5D.mod_count&url=https%3A%2F%2Fraw.githubusercontent.com%2Flinuxserver%2Fdocker-mods%2Fmaster%2Fmod-list.yml]([] "查看此容器的可用mods") https://img.shields.io/badge/dynamic/yaml?color=94398d&labelColor=555555&logoColor=ffffff&style=for-the-badge&label=universal&query=%24.mods%5B%27universal%27%5D.mod_count&url=https%3A%2F%2Fraw.githubusercontent.com%2Flinuxserver%2Fdocker-mods%2Fmaster%2Fmod-list.yml]([] "查看可用的通用mods")

https://github.com/linuxserver/docker-mods%E6%8F%90%E4%BE%9B%E9%A2%9D%E5%A4%96%E5%8A%9F%E8%83%BD%EF%BC%8C%E4%B8%8A%E8%BF%B0%E5%BE%BD%E7%AB%A0%E9%93%BE%E6%8E%A5%E5%8F%AF%E6%9F%A5%E7%9C%8B%E6%AD%A4%E9%95%9C%E5%83%8F%E4%B8%93%E7%94%A8%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

更新信息

通过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
• 停止容器：docker stop kanzi
• 删除容器：docker rm kanzi
• 重新创建容器（保留/config目录则设置不会丢失）
• 清理旧镜像：docker image prune

通过Watchtower更新（仅推荐临时使用）

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

注意：长期建议使用Docker Compose管理容器更新。

镜像更新通知

推荐使用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 .

构建ARM变体（需在x86_64主机上）：

bash
docker run --rm --privileged multiarch/qemu-user-static:register --reset
docker build -f Dockerfile.aarch64 -t lscr.io/linuxserver/kanzi:arm64v8-latest .

版本历史

• 13.04.19：初始发布