异常教程

docker windows 安装（建议收藏）

更新时间:

💡一则或许对你有用的小广告

欢迎加入小哈的星球 ，你将获得：专属的项目实战 / 1v1 提问 / Java 学习路线 / 学习打卡 / 每月赠书 / 社群讨论

截止目前， 星球 内专栏累计输出 90w+ 字，讲解图 3441+ 张，还在持续爆肝中.. 后续还会上新更多项目，目标是将 Java 领域典型的项目都整一波，如秒杀系统, 在线商城, IM 即时通讯，权限管理，Spring Cloud Alibaba 微服务等等，已有 3100+ 小伙伴加入学习 ，欢迎点击围观

在当今的软件开发领域，容器化技术已成为构建、部署和运行应用程序的标准实践。Docker 作为容器技术的代表，通过提供轻量级、可移植的环境，大幅简化了跨平台开发与运维的复杂性。对于 Windows 用户而言，掌握 Docker 的安装与配置是迈向现代化开发流程的重要一步。本文将从零开始，以通俗易懂的方式讲解如何在 Windows 系统上安装 Docker，并通过实际案例帮助读者快速上手这一工具。

系统要求与准备工作

在安装 Docker 之前，需确保 Windows 系统满足以下条件：

  1. 操作系统版本：Windows 10 版本 1607 或更高（建议使用最新版本），或 Windows 11；
  2. Hyper-V 和容器功能：需启用 Windows 的 Hyper-V 和容器支持；
  3. 64 位处理器：支持 SLAT（Second-Level Address Translation）技术。

为什么需要 Hyper-V？

Hyper-V 是 Windows 的虚拟化框架，Docker 在 Windows 上默认依赖它来运行容器。可以将其想象为一个“集装箱码头”，Docker 容器就像一个个标准化的集装箱，而 Hyper-V 则是管理这些集装箱的“码头系统”。

安装 Docker Desktop for Windows

步骤 1：下载 Docker Desktop

访问 Docker 官方网站（https://www.docker.com/products/docker-desktop），下载适用于 Windows 的安装包。选择“Windows”选项后，系统会自动检测版本并提供对应的安装文件。

步骤 2：启用 Hyper-V 和容器功能

  1. 按下 Win + X，选择“程序和功能” → “启用或关闭 Windows 功能”；
  2. 勾选 Hyper-V 和 容器 Windows 容器（或 Hyper-V 容器，根据需求选择）；
  3. 点击“确定”并重启计算机。

提示：若系统版本低于 1607 或无法启用 Hyper-V，可考虑升级系统或使用虚拟机（如 VMware）运行 Linux 发行版，再安装 Docker。

步骤 3：运行安装程序

  1. 双击下载的 .exe 文件，按照提示完成安装；
  2. 安装完成后，Docker 图标会出现在系统托盘区。

配置 Docker 环境

配置 WSL 2 作为运行时（可选但推荐）

从 Docker Desktop 2.4 版本开始，用户可以选择以 Windows Subsystem for Linux 2（WSL 2）作为容器运行时，这能显著提升性能并兼容更多 Linux 镜像。

操作步骤：

  1. 打开 Docker Desktop 设置（右下角图标 → “Settings”）；
  2. 进入“General”选项卡，勾选“Use the WSL 2 based engine”；
  3. 点击“Apply & Restart”。

设置镜像加速器（加速下载速度）

由于 Docker Hub 的国际网络延迟问题，建议配置国内镜像加速器。例如，阿里云提供免费加速服务：

  1. 登录阿里云控制台获取加速器地址（格式如 https://<your-id>.mirror.aliyuncs.com）；
  2. 编辑 Docker 配置文件 C:\Users\<用户名>\.docker\daemon.json，添加以下内容： 
    {  
  "registry-mirrors": ["https://<your-id>.mirror.aliyuncs.com"]  
}
  3. 重启 Docker Desktop。

验证安装与基础命令实践

验证 Docker 是否安装成功

打开命令行工具（如 PowerShell 或 CMD），执行以下命令：

docker --version  
docker run hello-world

若显示类似“Hello from Docker!”的输出，则表示安装成功。

实战案例：部署一个 Nginx 容器

  1. 拉取 Nginx 镜像：

    docker pull nginx

  2. 运行容器并映射端口：

    docker run -d -p 8080:80 --name my-nginx nginx
    • -d 表示后台运行；
    • -p 8080:80 将容器的 80 端口映射到本地 8080；
    • --name 指定容器名称。

  3. 访问 http://localhost:8080，即可看到 Nginx 的默认页面。

常见问题与解决方案

问题 1：安装后 Docker 图标显示红色感叹号

原因：Hyper-V 或容器功能未正确启用。
解决方法：

  1. 重新检查系统功能是否启用；
  2. 以管理员身份运行 Docker Desktop。

问题 2：运行容器时提示“network unreachable”

原因：防火墙或网络设置阻止了 Docker 的通信。
解决方法：

  1. 暂时关闭防火墙测试；
  2. 将 Docker 添加到防火墙的例外列表。

进阶技巧与最佳实践

自动化安装脚本（PowerShell）

对于开发者而言，编写脚本可简化安装流程。以下是一个示例脚本：

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

Invoke-WebRequest "https://desktop.docker.com/win/stable/Docker%20Desktop%20Installer.exe" -OutFile "DockerInstaller.exe"  
Start-Process DockerInstaller.exe -Wait  

wsl --set-default-version 2

安全与资源管理

  • 限制容器资源：在 Docker Desktop 设置中，可为 CPU、内存等设置上限，避免占用过多系统资源；
  • 定期清理镜像：使用 docker system prune 删除未使用的镜像和容器，释放磁盘空间。

结论

通过本文的分步指导，读者应已掌握在 Windows 系统上安装和配置 Docker 的完整流程。Docker 的容器化技术不仅简化了开发环境的搭建，还为团队协作和持续集成提供了坚实基础。无论是构建微服务、测试不同版本的依赖库，还是快速部署应用，Docker 都能显著提升开发效率。

下一步，建议读者尝试使用 Docker Compose 管理多容器应用，或编写自己的 Dockerfile 定制镜像。随着实践的深入，Docker 的强大功能将为您的开发工作流带来更多便利。

最新发布

查看更多文章