Kitematic 快速上手指南在 Windows 与 Mac 上运行图形化容器管理工具【免费下载链接】docker.kitematicVisual Docker Container Management on Mac Windows项目地址: https://gitcode.com/gh_mirrors/ki/docker.kitematicKitematic 是 Docker 团队出品的桌面应用用图形界面管理容器、镜像和日志适合已经装好 Docker、但不想只靠命令行操作的人。按本文走一遍你可以完成准备运行环境、通过安装包或源码两种方式启动 Kitematic、验证容器列表能否正常加载并知道连接失败时从哪里查起。 先判断 Kitematic 适不适合你在动手安装前有两点需要确认。它做什么列出本机容器启动、停止、重启、查看日志、搜索并拉取 Docker Hub 镜像、管理端口映射和挂载卷。入口代码在 src/components/例如ContainerList.react.js负责容器列表页。项目状态仓库 README.md 顶部有明确的弃用公告——Kitematic 已进入维护停止阶段相关功能正并入 Docker Desktop。如果你的环境是新版 Windows 或 Mac优先考虑 Docker DesktopKitematic 更适合在旧环境、离线环境或需要研究其实现时用。如果你属于后两种情况继续往下。⚙️ 首次启动前环境检查清单Kitematic 本身不运行容器它需要一台可用的 Docker 引擎。对照下面逐项确认Docker 引擎在跑终端执行docker info能返回Server Version说明引擎正常。虚拟化已启用走虚拟机模式时见下文需要在 BIOS 中开启 VT-x 或 AMD-V。Windows 用户确认 Docker for Windows 处于运行状态或愿意使用 Kitematic 自带的虚拟机方案。开发者场景源码编译要求 Node.js 版本低于 10.0.0这一限制写在 package.json 的engines字段里。 最短路径用官方安装包跑起来新手建议走这条路三步完成。从 Kitematic 的官方发布页下载对应系统的安装包Windows 为 .exeMac 为 .dmg。安装完成后启动应用它会先显示一个初始化页面自动检测本机的 Docker 连接若没有检测到会询问是否改用 VirtualBox 虚拟机方式启动一个 Docker 环境此时需要等待进度条走完。验证成功标志进入容器列表页能看到Containers与Images两个标签页且列表能加载数据哪怕为空列表也算连接成功。如果启动后一直停在初始化页或出现 Setup Error说明本地 Docker 没被检测到按下一节排查。 源码编译开发者构建流程需要跑开发版或研究代码时按 package.json 中定义的脚本来。Node 版本必须先低于 10.0.0否则依赖装不上。# 克隆仓库 git clone https://gitcode.com/gh_mirrors/ki/kitematic cd kitematic # 安装依赖并启动start 会先执行 build npm install npm start构建和测试由 Gruntfile.js 与 Jest 驱动npm run build执行tsc加 tslint 检查npm test跑tests/ 下的单元测试。要打包成 Windows 可执行文件运行npm run release:windows产物生成在dist目录。打包细节同样定义在 Gruntfile.js 中。 连接失败怎么排查Kitematic 检测不到 Docker 时初始化页会给出错误信息和对应按钮。按错误类型对号入座提示未找到 native 环境本机 Docker 没运行或没安装。Windows 上确认 Docker for Windows 正在运行Mac 上启动 DockerLinux 上按页面提示安装 Docker 后点 Retry Setup。提示虚拟机相关错误说明它尝试用 VirtualBox 拉起 Docker 虚拟机但失败了。常见原因是宿主机开了 Hyper-V 或 VMware 之类占用虚拟化的软件。可以点页面上的 Use VirtualBox 强制走虚拟机模式清理残留可以用 util/VirtualBox_Uninstall.tool。能连上但容器访问不了打开容器详情页检查Ports标签里的端口映射再确认宿主机防火墙放行了对应端口页面上的 View in Browser 按钮可以直接按映射地址打开。排查逻辑在 src/utils/SetupUtil.js 中其中虚拟机创建前检查失败会以退出码 3 区分读这段代码能看懂每类错误的来源。 下一步资料文档入口docs/README.md说明文档已并入 Docker 官方文档仓库以那里为准应用源码src/界面组件在components/状态管理在stores/功能测试示例tests/ 与__integration__/目录版本路线与归档说明ROADMAP.md、README.md 的 Archive FAQ 部分先跑通容器列表页再按需深入端口映射、卷和日志遇到与 Docker Desktop 功能重叠的部分以 Docker Desktop 为长期方向。【免费下载链接】docker.kitematicVisual Docker Container Management on Mac Windows项目地址: https://gitcode.com/gh_mirrors/ki/docker.kitematic创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
