Windows
在 Windows 上使用 Docker Desktop 或内置 WSL2 Docker Engine 运行 Dockerman。
Windows 支持两种 Docker 方案:Docker Desktop 或内置 WSL2 Docker Engine。
快速对比
| 特性 | Docker Desktop | WSL2 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 使用。
编辑 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 连接类型(socket、tcp、npipe)会被记忆,因此切回系统原生 Docker 时会恢复你上次的配置。
如果你更喜欢旧流程,也可以在 设置 → Docker 设置 中切换连接类型并手动重连。
WSL2 资源监控
使用 统计 像监控其他 Docker 守护进程一样监控 WSL2 Engine。如果 Windows 显示内存占用较高,请在任务管理器中检查 WSL2 VM 的内存气球回收情况。