Dockerman 文档
平台

Windows

在 Windows 上使用 Docker Desktop 或内置 WSL2 Docker Engine 运行 Dockerman。

Windows 支持两种 Docker 方案:Docker Desktop 或内置 WSL2 Docker Engine。

快速对比

特性Docker DesktopWSL2 Docker Engine
订阅大多数企业需要订阅无需订阅
体积安装包较大基于 Alpine 的小型 WSL 发行版
资源占用较高,因为运行 VM 和服务较低,因为在 WSL2 内部运行
设置难度标准安装程序由 Dockerman 自动完成
支持状态完全支持完全支持,v4.3.0 新增

方案 A:Docker Desktop

安装 Docker Desktop

从 docker.com 下载 Docker Desktop 并运行安装程序。

确保 Docker Desktop 正在运行

等待鲸鱼图标显示 Docker Desktop 正在运行。

启动 Dockerman

Dockerman 会自动检测 Docker Desktop 并连接到它。

方案 B:WSL2 Docker Engine

v4.3.0 新增。

Dockerman 为你内置了 WSL2 方案,因此你无需安装 Docker Desktop 或手动配置 WSL。

前提条件

  • Windows 10 版本 2004 或更高版本,或 Windows 11。
  • 在管理员权限的 PowerShell 会话中运行 wsl --install 安装 WSL2。
  • 在 BIOS 或 UEFI 中启用虚拟化。

设置向导

当未检测到 Docker Desktop 时,设置向导会在首次启动时自动运行。

选择 WSL2 Docker Engine

在欢迎对话框出现时,选择内置的 WSL2 Docker Engine 方案。

导入 Alpine

Dockerman 会导入一个精简的 Alpine WSL 发行版用于运行 Docker Engine。

在 Alpine 内安装 Docker

Dockerman 安装 Docker 并配置守护进程在登录时自动启动。

验证连接

Dockerman 运行健康检查并连接到新的守护进程。

向导运行期间请勿关闭 Dockerman。首次设置需要几分钟时间,必须完成后才能使用应用。

向导执行的操作

向导创建 Alpine 发行版文件,供 Dockerman 运行 Docker 使用。

/etc/docker/daemon.json

编辑 daemon.json

使用 设置 → 守护进程配置 面板来编辑 /etc/docker/daemon.json,支持表单视图(常用字段)或原始 JSON 视图(所有字段)。保存后会重启 Alpine 发行版内的 Docker。

守护进程崩溃恢复

如果 Docker 守护进程崩溃,Dockerman 会显示一个带有重启按钮的横幅,并实时输出崩溃日志以便你诊断故障原因。

重新安装 WSL2 发行版

v5.3.0 新增。如果 Alpine 发行版进入异常状态,可在 WSL 页面打开设置向导,点击 Reinstall 清除现有发行版并重新导入一份全新的 Alpine 镜像。该按钮是破坏性操作——发行版内部存储的任何数据都会丢失,但由 daemon 管理的 Docker 卷保留(除非你同时重置 Docker)。

切换引擎源

v5.3.0 新增。Windows 上的 WSL 页面提供 引擎源 选择器,包含两张卡片:系统原生 Docker socket(Docker Desktop 或系统安装的任意 Docker)以及内置的 Dockerman WSL2 Docker Engine。选择任一卡片后,Dockerman 会静默地将本地主机重新连接到新的源——没有 toast,无需手动保存。之前的 Docker 连接类型(sockettcpnpipe)会被记忆,因此切回系统原生 Docker 时会恢复你上次的配置。

如果你更喜欢旧流程,也可以在 设置 → Docker 设置 中切换连接类型并手动重连。

WSL2 资源监控

使用 统计 像监控其他 Docker 守护进程一样监控 WSL2 Engine。如果 Windows 显示内存占用较高,请在任务管理器中检查 WSL2 VM 的内存气球回收情况。

故障排除