Kiri on Linux
在 Linux 上,Kiri 无需虚拟机:守护进程与代理直接运行在宿主机内核上,通过 systemd 服务 kiri.service 管理。docker CLI、Compose 与 buildx 可照常使用。完整 kiri 包(x86-64)还包含图形窗口;kiri-lite 与部分架构包可能仅提供命令行。
无 VM,同一引擎
- macOS 上使用 VM + vsock;Linux 上代理作为普通 root 进程运行,通信改为私有目录中的 Unix socket。
- 容器隔离仍基于命名空间、cgroup、overlayfs、capabilities 与 seccomp;无 dockerd/containerd/shim/runc。
- 无 VM 内存气球与 VM 级空闲休眠。
软件包
提供 .deb(Debian/Ubuntu)与 .rpm(Fedora/RHEL/openSUSE),支持 x86-64 与 arm64。可从 runkiri.com/download 下载。
| 包 | 内容 |
|---|---|
kiri |
引擎 + docker CLI、Compose、buildx(部分架构含窗口) |
kiri-lite |
仅引擎,适合已安装 docker 的机器 |
两者互斥,只能安装其一。安装内容通常包括:
/usr/bin/kiri、/usr/bin/kiri-initkiri.service(安装但可能不自动启动;按版本行为,需完成设置/授权后启动并可开机自启)kiri用户组(拥有/run/kiri/docker.sock,通常0660 root:kiri)- 数据目录
/var/lib/kiri-daemon、/var/lib/kiri kiri包附带的 Docker CLI/插件路径(如/usr/libexec/kiri、/usr/lib/docker/cli-plugins)
安装
安装脚本
curl -fsSL https://runkiri.com/install.sh | bash
# 安装 lite 版本
KIRI_LITE=1 curl -fsSL https://runkiri.com/install.sh | bash脚本会选择匹配发行版与架构的包、校验摘要并使用包管理器安装(需要 systemd 与 sudo)。
手动安装
# Debian / Ubuntu
sudo apt install ./kiri_<version>_amd64.deb
# Fedora / RHEL
sudo dnf install ./kiri-<version>-1.x86_64.rpm
# openSUSE
sudo zypper install --allow-unsigned-rpm ./kiri-<version>-1.x86_64.rpm安装后将当前用户加入 kiri 组并重新登录:
sudo usermod -aG kiri $USER验证:
docker run --rm hello-world使用 kiri-lite 时,可创建并切换 Docker context:
docker context create kiri --docker host=unix:///run/kiri/docker.sock
docker context use kiri权限提示:
kiri组成员可通过引擎以 root 权限运行容器并挂载任意路径,等同于docker组权限,请仅授予可信用户。
Docker 如何找到 Kiri
/usr/bin/docker:kiri包可能通过update-alternatives提供 CLI(仅在路径空闲或已为 alternatives 链接时);已有其他来源的docker不会被强行替换。/var/run/docker.sock:当该路径未被其他引擎占用时,kiri.service可在启动时创建指向/run/kiri/docker.sock的链接,供忽略 docker context 的工具(如 Testcontainers、docker-py 等)使用;停止服务时移除 Kiri 创建的链接。DOCKER_HOST、DOCKER_CONTEXT或docker context use可显式指定引擎。
命令与诊断
kiri run/ps/compose ...:通过 PATH 中的docker面向 Kiri 执行。kiri share、kiri k8s:在 Linux 上可用(按版本支持)。kiri diag logs、kiri diag report:诊断信息;服务日志也可通过journalctl -u kiri查看(部分日志需 root 权限访问数据目录)。
macOS 专属命令(如菜单栏、kiri setup、kiri update、kiri import 等)在 Linux 上不可用或行为不同。
升级
- 当前可能需手动下载新包安装或重新运行安装脚本;官方计划提供签名 apt/dnf 仓库。
- 升级后引擎可能仍运行旧版本以避免中断容器,可在合适时执行:
sudo systemctl restart kiri。
卸载
# Debian/Ubuntu
sudo apt remove kiri # 保留数据
sudo apt purge kiri # 同时删除数据与组(按包行为)
# Fedora/RHEL
sudo dnf remove kiri移除包会停止服务并清理 Kiri 创建的 alternatives/链接;数据目录是否保留取决于 remove/purge 行为与发行版包管理器。RPM 系统移除后如需彻底清理,可手动删除 /var/lib/kiri、/var/lib/kiri-daemon 并删除 kiri 组。
无包安装(源码/手动)
可使用源码中的 systemd unit 与自行构建的静态二进制(cargo xtask linux 等)部署,需自行放置 kiri/kiri-init、配置 kiri.service 与 kiri 组。细节以仓库 contrib/linux/kiri.service 与构建脚本为准。