Docker

Mar 10, 2026 Eric Guo    2

摘要：Docker 安装与 问题处理办法

第一步：下载安装包

  1. 前往 Docker 官网下载页面。
  2. 点击 "Download for Windows"。

第二步：安装过程中的关键勾选

双击下载好的 Docker Desktop Installer.exe，安装时会弹出几个选项：

  • 必须勾选：Use WSL 2 instead of Hyper-V (recommended)。理由：Windows 11 的 WSL 2 后端比传统的 Hyper-V 快得多，且能更好地与你的 Windows 文件系统交互。
  • 建议勾选：Add shortcut to desktop（方便启动）。

安装完成后，系统通常会提示你 Close and Restart。请务必重启电脑，否则虚拟化网桥可能无法生效。

第三步：首次启动与 WSL 2 补丁

  1. 重启后，从桌面启动 Docker Desktop。
  2. 接受条款：点击 "Accept"。
  3. 报错处理（常见）：如果弹出窗口说 WSL 2 installation is incomplete，不要慌。打开 PowerShell（管理员）。输入并执行：wsl --update。完成后，点击 Docker 报错弹窗上的 Restart。

第四步：针对中国网络环境的配置 (国内用户必看)

由于网络原因，直接拉取 OpenClaw 镜像可能会非常慢甚至失败。你需要配置镜像加速：

  1. 点击 Docker Desktop 右上角的 齿轮图标 (Settings)。
  2. 选择左侧菜单的 Docker Engine。
  3. 在右侧的 JSON 编辑器中，在 {} 里面添加 registry-mirrors 字段。
  4. {
  "builder": {
    "gc": {
      "defaultDiskSpaceThreshold": 20,
      "enabled": true
    }
  },
  "experimental": false,
  "registry-mirrors": [
    "https://docker.m.daocloud.io",
    "https://hub-mirror.c.163.com",
    "https://mirror.baidubce.com"
  ]
}
  5. 点击 Apply & Restart。

第五步：验证是否成功

打开终端（PowerShell 或 CMD），输入以下命令验证：

  • docker version（查看版本）

注意：千万不要勾选allow windows cont6ainer to be userd with this installtion

（除非你有非常明确的旧版企业级软件开发需求）。

对于运行 OpenClaw 来说，勾选这个选项不仅没有帮助，反而会让你的安装变得异常复杂且极其吃内存。

1. 这个选项是什么作用？

Windows 系统支持两种完全不同的容器模式：

  • Linux Containers (默认/推荐)：这是 Docker 的标准模式。它在 Windows 上通过 WSL2 运行一个极轻量级的 Linux 内核。OpenClaw 是基于 Node.js 开发的，运行在 Linux 容器中最为稳定和高效。
  • Windows Containers (不勾选的这个)：它允许你运行原生 Windows 环境的容器（比如运行一个老旧的 .NET Framework 4.5 程序或原生的 IIS 服务器）。

2. 为什么不建议勾选？

  1. OpenClaw 跑不动：OpenClaw 的官方镜像（Image）是为 Linux 环境构建的。如果你切换到了 Windows 容器模式，你将无法运行 OpenClaw 的镜像。
  2. 巨大的资源占用：Windows 容器镜像通常非常巨大（动辄几个 GB 甚至十几个 GB），而 Linux 镜像通常只有几百 MB。
  3. 模式切换麻烦：Docker 同一时间只能运行一种模式。如果你勾选了，Docker 默认可能会进入 Windows 容器模式，导致你无法执行 docker-compose up。
  4. 环境配置复杂：Windows 容器对内核版本要求极高，经常会出现宿主机更新后容器无法启动的兼容性问题。

3. 如果你已经勾选了怎么办？

别担心，安装完成后也可以切换回来：

  1. 在任务栏右下角找到 Docker 鲸鱼图标。
  2. 右键点击它。
  3. 如果你看到选项是 "Switch to Linux containers..."，说明你现在处于 Windows 模式，请点击它切换回 Linux 模式。
  4. 如果你看到的是 "Switch to Windows containers..."，说明你已经处于正确的 Linux 模式了，不需要做任何操作。


评论