Kiri on Windows
在 Windows 上,Kiri 通过 WSL2 运行其 Linux 引擎。Windows 侧程序 kiri-win.exe 负责 Docker API 命名管道、图形窗口与托盘图标,并与 WSL 内的引擎通信。
Beta:Windows 版本处于 Beta 阶段。安装包在部分版本中可能未签名,系统可能提示确认;如遇问题可通过窗口内反馈渠道提交。
系统要求与安装包
- 支持 Windows 10/11,提供 x64 与 ARM64 安装包(如
Kiri-<version>-x86_64.msi、Kiri-<version>-arm64.msi)。 - 安装包与引擎、CLI 工具需与 CPU 架构匹配;在错误架构上安装会提示更换正确安装包。
- 每用户安装(无需管理员权限安装本体),默认路径通常为
%LOCALAPPDATA%\Kiri,并可添加开始菜单项与“已安装应用”条目。
首次运行与设置向导
首次打开 Kiri 会进入分步设置(进度保存在本地,可在重启后继续):
- 语言选择(较新版本):默认跟随 Windows 语言,可选择界面语言。
- WSL2:如未安装,Kiri 可下载并安装所需组件,可能需要管理员批准与系统重启。
- 选择 Linux 发行版:
- Kiri Linux:安装包内置的轻量发行版(注册为
kiriWSL 发行版),下载/占用更小。 - Ubuntu 26.04 或已有 Ubuntu:可从微软渠道下载或复用已安装发行版。
- Kiri Linux:安装包内置的轻量发行版(注册为
- 启动引擎:在所选 WSL 发行版中启动引擎并通过运行测试容器验证。
- Docker 工具:安装/校验
dockerCLI、Compose、buildx,配置kiri-build构建器与默认 context(若选择)。 - 完成:可选“登录时启动(托盘)”并打开 Kiri。
Kiri 的 bin 目录通常追加到用户 PATH 末尾,避免覆盖已有 docker。未设为默认时可使用 docker --context kiri。
代理与网络
- 若 Windows 代理监听在
127.0.0.1(如http://127.0.0.1:7892),Kiri 可将 WSL 内的代理连接转发到 Windows 侧代理,使镜像拉取等操作可用。 - 安装/拉取失败时,向导或日志会尽量给出具体原因(代理拒绝、注册表不可达、限流或需认证等)。
USB 设备
Windows 上通过 usbipd-win 将 USB 设备共享到 WSL 供容器使用。若未安装,USB 视图可提供安装入口;首次附加设备需管理员批准。详见 USB 设备。
工作原理概览
- WSL 内:引擎在 Unix socket(如
/var/lib/kiri-daemon/.kiri/run/docker.sock)提供 Docker API。 - Windows 内:
kiri-win.exe在\\.\pipe\kiri提供 Docker API(对应 docker context 的npipe:////./pipe/kiri)。 - 两者通过
wsl.exe -u root -- kiri bridge进程以帧协议中继连接,避免 WSL TCP localhost 转发对半关闭的兼容性问题,保证docker run/attach等场景正常。
托盘与命令行
- 关闭窗口通常使 Kiri 最小化到托盘并继续运行;托盘菜单可打开窗口、查看状态、检查更新与退出。
kiri命令位于安装目录的bin中:kiri run/ps等通过 Kiri context 执行 Docker 命令,kiri share、kiri k8s、kiri machine、kiri diag等按支持情况转发到引擎。
更新
- Kiri 按架构检查对应更新源,后台下载安装包并校验完整性与元数据。
- 可选择立即重启或稍后安装;更新可能停止容器(有重启策略的容器可恢复)。引擎组件可能需要按提示重启以完成切换。详见 更新。
卸载
- 从“已安装应用”卸载会清理 context、构建器配置、PATH 与自启动项等。
- 若使用 Kiri 创建的专用 WSL 发行版,卸载可能注销该发行版并删除其中数据;使用自有发行版时通常仅移除 Kiri 引擎组件,数据保留在
/var/lib/kiri等位置(以实际卸载行为与提示为准)。 - 建议从原安装用户账户执行卸载,以正确清理用户级设置。