企业官网建设流程全解析

Kitematic 快速上手指南：在 Windows 与 Mac 上运行图形化容器管理工具

【免费下载链接】docker.kitematicVisual Docker Container Management on Mac & Windows项目地址: https://gitcode.com/gh_mirrors/ki/docker.kitematic

Kitematic 是 Docker 团队出品的桌面应用，用图形界面管理容器、镜像和日志，适合已经装好 Docker、但不想只靠命令行操作的人。按本文走一遍，你可以完成：准备运行环境、通过安装包或源码两种方式启动 Kitematic、验证容器列表能否正常加载，并知道连接失败时从哪里查起。

📦 先判断 Kitematic 适不适合你

在动手安装前，有两点需要确认。

• 它做什么：列出本机容器（启动、停止、重启）、查看日志、搜索并拉取 Docker Hub 镜像、管理端口映射和挂载卷。入口代码在 src/components/，例如ContainerList.react.js负责容器列表页。
• 项目状态：仓库 README.md 顶部有明确的弃用公告——Kitematic 已进入维护停止阶段，相关功能正并入 Docker Desktop。如果你的环境是新版 Windows 或 Mac，优先考虑 Docker Desktop；Kitematic 更适合在旧环境、离线环境或需要研究其实现时用。

如果你属于后两种情况，继续往下。

⚙️ 首次启动前：环境检查清单

Kitematic 本身不运行容器，它需要一台可用的 Docker 引擎。对照下面逐项确认：

1. Docker 引擎在跑：终端执行docker info，能返回Server Version说明引擎正常。
2. 虚拟化已启用：走虚拟机模式时（见下文），需要在 BIOS 中开启 VT-x 或 AMD-V。
3. Windows 用户：确认 Docker for Windows 处于运行状态，或愿意使用 Kitematic 自带的虚拟机方案。
4. 开发者场景：源码编译要求 Node.js 版本低于 10.0.0，这一限制写在 package.json 的engines字段里。

🚀 最短路径：用官方安装包跑起来

新手建议走这条路，三步完成。

1. 从 Kitematic 的官方发布页下载对应系统的安装包（Windows 为 .exe，Mac 为 .dmg）。
2. 安装完成后启动应用，它会先显示一个初始化页面，自动检测本机的 Docker 连接；若没有检测到，会询问是否改用 VirtualBox 虚拟机方式启动一个 Docker 环境，此时需要等待进度条走完。
3. 验证成功标志：进入容器列表页，能看到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 上启动 Docker；Linux 上按页面提示安装 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