Kiri 的目标是提供与 Docker 工具链兼容、且更轻快的本地容器体验。以下按能力分组介绍其主要特性(具体支持范围以对应版本为准)。
Docker 兼容能力
- 容器:支持
run、exec、logs、attach、stop、restart、pause、stats、cp等常用命令;支持资源限制与常见安全选项。 - 镜像:支持
pull/push/save/load/search等;可使用docker login凭据;支持--platform。 - 构建:支持
docker build与buildx build(通过 BuildKit)。 - Compose:支持
up、down、ps、logs、exec等常用工作流。 - 存储:支持命名卷、匿名卷、绑定挂载(bind mount)、
tmpfs等。
网络与本地域名
- 默认桥接网络、用户自定义网络与容器间按名称解析。
- 支持端口发布(
-p,TCP/UDP)以及host.docker.internal等常见能力。 - 本地域名:容器可通过
http://<name>.kiri.localhost等名称访问;Compose 服务可按<service>.<project>...形式访问。 - HTTPS:可为本地域名提供 HTTPS(由 Kiri 的本地证书体系支持)。
文件与开发体验
- 容器文件访问:在 macOS 上可在
~/Kiri下查看运行中容器的文件(按需读取,非预先全量复制)。 - SSH agent 转发:容器可访问宿主机 SSH agent,便于在容器内使用 Git over SSH 等场景。
- 轻量与休眠:空闲时虚拟机可休眠并归还内存,下一次命令可快速唤醒。
Kubernetes 与 Linux 机器
- Kubernetes:
kiri k8s start可快速启动单节点 k3s 集群,并提供kirikubectl 上下文。 - Linux 机器:
kiri machine create dev --distro ubuntu可创建带用户与 sudo 的长期 Linux 环境,并挂载宿主机目录(按平台能力而异)。
Kiri Share(公网分享)
通过 Kiri Share,可将本地容器暴露为公网 HTTPS 地址,便于演示、联调与在手机等设备上访问:
kiri share login
kiri share <container-or-port>分享链接通常位于 runkiri.cloud 域名下,可随时断开。
图形界面与平台支持
- 原生应用:管理容器、镜像、卷、网络、构建与 Compose 项目;查看实时日志、终端与文件。
- 跨平台:支持 macOS(Apple silicon / Intel)、Windows(Beta,通过 WSL2)与 Linux(systemd)。
- 迁移辅助:可从 OrbStack 或 Docker Desktop 导入镜像、卷与容器(
kiri import,按平台支持情况而定)。