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 注销现有的 dockerman-backend 发行版并重新导入一份全新的 Alpine 镜像。

重新安装会删除整个 WSL 发行版,包括 Docker 镜像、容器、卷以及保存在其中的其他数据。继续前请导出或备份需要的数据。Dockerman 不会在此操作中保留卷。

切换引擎源

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 的内存气球回收情况。

故障排除