admin 管理员组

文章数量: 1184232

前言

Docker Desktop 是 Windows 用户快速上手 Docker 的核心工具,支持 Linux 容器与 Windows 容器切换,还能与 WSL 2 深度集成提升性能。本文将详细讲解两种下载方式(官网 + 专属网盘)、自定义安装位置的方法,并针对常见启动故障给出可落地的解决方案,适合 Docker 新手及遇到启动问题的用户参考。

一、Docker Desktop 下载(两种方式可选)

1.1 官网下载(推荐,获取最新版)

官网下载能确保获取最新稳定版,同时提供不同架构(x86_64/ARM)的安装包,按需选择即可:

  • x86_64 架构(主流 Windows 电脑):直接下载安装包Docker Desktop for Windows - x86_64
  • 微软商店版(自动更新):适合习惯通过商店管理软件的用户Docker Desktop(微软商店)
  • ARM 架构(早期访问版):仅适用于 ARM 芯片的 Windows 设备(如部分 Surface)Docker Desktop for Windows - ARM

注意:官网下载无需注册登录,点击链接即可直接开始下载。

1.2 网盘下载(备用,高速获取)

若官网下载速度较慢,可通过天翼云盘获取安装包,资源与官网最新版同步:

  • 网盘链接:https://cloud.189/t/QV3IRjRz6bmi
  • 访问密码:uof4
  • 下载文件:Docker Desktop Installer.exe(x86_64 架构,适用于绝大多数 Windows 电脑)

二、Docker Desktop 安装(含自定义安装位置)

2.1 交互式安装步骤

  1. 找到下载的Docker Desktop Installer.exe,双击启动安装向导(建议右键选择 “以管理员身份运行”,减少权限问题);
  2. 阅读许可协议后,勾选 “Accept the terms”,点击 “Next”;
  3. 进入 “Configuration” 页面,按需勾选以下选项(推荐配置):
    • ✅ Create a desktop shortcut(创建桌面快捷方式,方便后续启动)
    • ✅ Use WSL 2 instead of Hyper-V(优先用 WSL 2 后端,性能更优,需提前启用 WSL 2)
    • ❌ Disable Windows Container support(暂不勾选 Windows 容器,新手先聚焦 Linux 容器);
  4. 关键步骤:修改安装位置(见 2.2);
  5. 点击 “Install”,等待安装完成(约 1-3 分钟,取决于电脑配置);
  6. 安装结束后,点击 “Close and restart”,重启电脑使配置生效。

2.2 关键配置:修改默认安装位置

Docker 默认安装路径为C:\Program Files\Docker\Docker,若 C 盘空间不足,可按以下步骤自定义路径:

  1. 打开安装包目录在路径上输入cmd打开终端
  2. 输入命令Desktop Installer.exe install --installationDir="D:\Docker"后面为想要安装的位置

    powershell

    Desktop Installer.exe install --installationDir="D:\Docker"
  3. 等待安装完成重启

2.3 安装后验证

电脑重启后,双击桌面 “Docker Desktop” 图标启动软件:

  • 首次启动会弹出 WSL 配置提示(若未启用 WSL 2),按提示完成配置即可;
  • 当任务栏托盘的 Docker 图标显示为 “绿色”,且打开 PowerShell 输入docker --version能显示版本号(如Docker version 28.0.4, build b8034c0),说明安装成功。

三、常见启动问题及解决方案

在启动 Docker Desktop 时,可能遇到 “启动失败”“Docker 引擎无法启动” 等问题,以下是高频问题的解决方法(含之前遇到的 WSL 相关问题):

3.1 问题 1:Docker 进程占用导致启动失败

现象:启动时提示 “Docker is already running”,但任务栏无 Docker 图标。解决步骤

  1. Ctrl+Shift+Esc打开任务管理器,切换到 “详细信息” 选项卡;
  2. 搜索包含 “docker” 的进程(如docker.exe“Docker Desktop.exe”);
  3. 右键选中这些进程,点击 “结束任务”;
  4. 重新双击桌面 Docker 图标启动。

3.2 问题 2:WSL 配置异常导致启动失败

现象:提示 “WSL needs updating” 或 “WSL 2 installation is incomplete”(最常见问题)。解决步骤

  1. 以管理员身份打开 PowerShell,依次执行以下命令:

    powershell

    # 启用WSL和虚拟机平台功能
    dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
    dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
    
  2. 重启电脑后,再次打开管理员 PowerShell,更新 WSL 内核:

    powershell

    wsl --update
    
  3. 将 WSL 默认版本设为 2:

    powershell

    wsl --set-default-version 2
    
  4. 重新启动 Docker Desktop,在设置中确认 “Use the WSL 2 based engine” 已勾选。所以操作如图所示:

3.3 问题 3:新版本兼容问题(回退旧版本)

现象:更新到最新版(如 4.27+)后无法启动,旧版本可正常使用。解决步骤

  1. 卸载当前 Docker Desktop(控制面板→程序和功能→卸载 Docker Desktop);
  2. 下载稳定旧版本(推荐 4.26.1 或 4.21.1,兼容性较好):
    • 官网旧版本列表:Docker Desktop Release Notes(拉到对应版本,找到 “Download” 链接);
  3. 安装旧版本后,关闭自动更新:打开 Docker 设置→“Check for updates”,取消勾选 “Automatically check for updates”。

3.4 问题 4:配置文件损坏导致启动卡住

现象:启动时一直显示 “Starting the Docker engine”,无法进入主界面。解决步骤

  1. 完全关闭 Docker Desktop(任务管理器结束所有 Docker 进程);
  2. 打开文件资源管理器,进入用户配置目录(需显示隐藏文件):
    • 路径:C:\Users\你的用户名\.docker\desktop(将 “你的用户名” 替换为实际 Windows 用户名);
  3. 删除desktop文件夹(备份重要镜像后操作,此步骤会清除本地镜像和配置);
  4. 重新启动 Docker Desktop,按提示重新同意许可协议,即可正常启动。

四、注意事项与补充说明

  1. 商用授权提醒:若你的企业员工数>250 人或年营收>1000 万美元,商用使用 Docker Desktop 需购买付费订阅(2022 年 1 月 31 日后已终止免费商用授权);
  2. 硬件要求:确保电脑开启 BIOS 级虚拟化(Intel VT-x/AMD-V),且内存≥4GB(推荐 8GB 以上,避免运行容器时内存不足);
  3. 官方文档参考:若遇到特殊问题,可查阅官方安装指南:Docker Desktop for Windows Install Guide。

总结

本文覆盖了 Docker Desktop 从下载(官网 + 网盘)、自定义安装到启动故障修复的全流程,重点解决了 “改安装位置” 和 “WSL 配置” 这两个核心痛点。如果在操作中遇到其他问题,欢迎在评论区留言,也可参考 Docker 社区论坛(forums.docker)获取更多解决方案。

本文标签: 解决方案 教程 详细 系统 资源