网站导航
> 技术文档 > 【Docker 新手入门指南】附：Windows系统安装Docker_windows安装docker

【Docker 新手入门指南】附：Windows系统安装Docker_windows安装docker

网友: 技术文档 2025-08-15 16:05:12

一、Windows 10/11 安装（推荐 Docker Desktop）

1. 系统要求

  • 操作系统：仅支持 Windows 10/11 专业版、企业版、教育版 或 家庭版（需开启 WSL 2）。
  • 硬件要求：CPU 支持虚拟化（需在 BIOS 中启用），至少 4GB 内存。
  • 依赖组件：需启用 Hyper-V 或 WSL 2（Windows Subsystem for Linux）。

2. 启用 Hyper-V（传统虚拟机方式）

注意：启用 Hyper-V 后，VirtualBox、VMWare 15 及以下版本将无法使用。
方法一：通过控制面板

  1. 打开 控制面板 → 程序和功能 → 启用或关闭 Windows 功能。
    【Docker 新手入门指南】附：Windows系统安装Docker_windows安装docker

  2. 勾选 Hyper-V 并确认安装，重启电脑。
    【Docker 新手入门指南】附：Windows系统安装Docker_windows安装docker

方法二：通过 PowerShell（管理员权限）

Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Hyper-V -All

3. 安装 Docker Desktop
步骤：

  1. 访问 Docker Desktop 官方下载页，点击 Download for Windows 获取安装包。
  2. 双击安装包，按向导提示操作（建议默认配置）。
  3. 安装完成后，点击 Finish 启动 Docker Desktop（任务栏会显示鲸鱼图标）。

验证安装：

docker run hello-world

若输出 Hello from Docker!，说明安装成功。

二、Windows 7/8 安装（使用 Docker Toolbox）

1. 系统限制

  • 仅支持 64 位系统，且需启用 CPU 虚拟化。
  • 通过 Oracle VirtualBox 运行 Linux 虚拟机（Docker 引擎部署在虚拟机中）。

2. 安装步骤

  1. 下载工具包：

    • 国内镜像源（推荐）：阿里云 Docker Toolbox 镜像
    • 包含组件：Docker CLI、VirtualBox、Docker Machine、Kitematic（图形界面）等。

  2. 运行安装程序：

    • 双击安装包，按向导提示勾选需要的组件（建议保持默认）。
    • 安装过程中可能需要确认 VirtualBox 的权限，点击 Yes。

  3. 启动 Docker：

    • 双击桌面 Docker QuickStart Terminal 图标，首次启动会自动创建名为 default 的 VirtualBox 虚拟机。
      【Docker 新手入门指南】附：Windows系统安装Docker_windows安装docker

    • 等待终端显示 docker> 提示符，即表示 Docker 环境就绪。

3. 验证安装

docker run hello-world

若输出容器运行日志，说明安装成功。

三、基于 WSL 2 的安装（Windows 10/11 家庭版推荐）

1. 启用 WSL 2

步骤：

  1. 以管理员身份打开 PowerShell，执行：

    wsl --install

    该命令会自动启用 WSL 2 并安装默认 Linux 发行版（如 Ubuntu）。

  2. 重启电脑后，按照提示完成 Linux 系统初始化（设置用户名和密码）。

2. 安装 Docker Desktop

  1. 下载并安装 Docker Desktop for Windows。
  2. 打开 Docker Desktop 设置 → Resources → WSL Integrations，勾选已安装的 Linux 发行版（如 Ubuntu）。
  3. 保存设置后，Docker 会自动配置 WSL 2 环境。

验证：在 WSL 终端中执行 docker run hello-world，确认正常运行。

四、常见问题与解决方法

1. Hyper-V 与其他虚拟机冲突

  • 现象：启用 Hyper-V 后，VirtualBox/VMWare 无法启动虚拟机。
  • 解决：
    • 若需使用其他虚拟机，卸载 Hyper-V（Disable-WindowsOptionalFeature -Online -FeatureName Microsoft-Hyper-V），改用 WSL 2 模式 安装 Docker Desktop。
    • 或使用 Docker Toolbox（基于 VirtualBox）。

2. WSL 报错：找不到文件 ConfigureGpu

  • 错误信息： 
    找不到文件 Wsl/InstallDistro/Service/RegisterDistro/CreateVm/ConfigureGpu/HCS/ERROR_FILE_NOT_FOUND
  • 解决： 
    wsl --uninstallwsl --install -d Ubuntu # 重新安装 WSL 和 Linux 发行版

3. 权限不足（非管理员运行）

  • 现象：普通用户执行 docker 命令提示权限拒绝。
  • 解决：
    • Windows 10/11：确保以管理员身份运行 Docker Desktop，或加入 docker 组（需在 WSL 中操作）。
    • Windows 7/8：通过 Docker QuickStart Terminal 启动（已自动配置权限）。

五、优化建议

  1. 配置镜像加速器（国内用户必选）：

    • 打开 Docker Desktop 设置 → Docker Engine，添加镜像源（如阿里云）： 
      { \"registry-mirrors\": [\"https://your-aliyun-mirror.com\"]}
    • 保存后点击 Apply & Restart 生效。

  2. 调整资源分配：

    • 在 Docker Desktop 设置 → Resources 中，根据硬件配置调整 CPU、内存和磁盘空间，避免容器运行卡顿。

六、总结

  • Windows 10/11 推荐路径：启用 WSL 2 + 安装 Docker Desktop，性能更优且兼容其他开发工具。
  • 旧系统兼容方案：使用 Docker Toolbox，但需注意虚拟机资源占用和兼容性限制。
  • 关键要点：确保系统版本符合要求，优先使用官方工具，遇到问题参考日志和错误信息逐步排查。
网络标签：

相关问题