异常教程

windows docker 安装（保姆级教程）

更新时间:

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

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

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

在现代软件开发中，Docker 已成为容器化技术的基石，它允许开发者将应用程序及其依赖打包成独立的容器，实现跨环境的一致性运行。对于使用 Windows 操作系统的开发者而言，掌握 Windows Docker 安装 和配置方法是迈向容器化实践的第一步。本文将从零开始，逐步讲解如何在 Windows 环境中安装 Docker Desktop，并通过实际案例演示其核心功能，帮助读者快速上手这一强大工具。

安装前的准备工作

1. 硬件与系统要求

Docker 对硬件和操作系统有一定要求，需提前确认环境是否符合标准：

  • Windows 版本：需安装 Windows 10 专业版/企业版（1809 版本或更高）或 Windows 11。
  • Hyper-V 和 WSL 2 支持：Docker Desktop 依赖 Windows 的 Hyper-V 和 Windows Subsystem for Linux 2（WSL 2）功能。
  • 内存配置：建议分配至少 4GB 内存，容器运行时需预留资源。

形象比喻：
将 Docker 比作一艘货轮，Hyper-V 和 WSL 2 就是它的“动力引擎”和“船体结构”，缺少这些底层支持，货轮就无法在 Windows 这片“海洋”中航行。

2. 启用 Hyper-V 和 WSL 2

步骤 1：启用 Hyper-V

  1. 打开 控制面板 → 程序 → 启用或关闭 Windows 功能。
  2. 勾选 Hyper-V 和 Windows Hypervisor Platform，重启系统。

步骤 2：配置 WSL 2

  1. 通过 PowerShell（管理员权限）执行以下命令： 
    dism.exe /online /enable-feature /featurename:Microsoft-Hyper-V /all /norestart  
wsl --set-default-version 2
  2. 下载并安装 WSL 2 内核更新包（官方链接需自行搜索）。

Docker Desktop 的安装与配置

1. 下载并安装 Docker Desktop

步骤 1：访问官网下载

访问 Docker 官网 ，点击 Get Docker Desktop，选择 Windows 版本。

步骤 2：执行安装

  1. 运行安装程序，根据提示完成基础配置。
  2. 在 Settings → Resources → WSL Integration 中，启用已安装的 WSL 2 发行版（如 Ubuntu）。

关键点：
安装过程中需保持网络畅通，Docker Desktop 会自动下载必要的镜像和组件。

2. 验证安装

打开 PowerShell 或命令提示符，输入以下命令：

docker --version  
docker run hello-world

若输出包含“Hello from Docker!”，则表示安装成功。

核心功能与实战案例

1. 创建并运行第一个容器

案例：部署 Nginx Web 服务器

  1. 拉取镜像：

    docker pull nginx:latest

  2. 运行容器：

    docker run -d -p 80:80 --name my-nginx nginx:latest
    • -d：后台运行容器。
    • -p 80:80：将容器的 80 端口映射到主机的 80 端口。
    • --name：指定容器名称。

  3. 验证访问：
    打开浏览器，输入 http://localhost，即可看到 Nginx 默认页面。

形象比喻：
容器就像一个“集装箱”，Nginx 是“货物”，Docker 负责将集装箱安全地运送到指定“端口”（80 端口）。

2. 管理镜像与容器

常用命令示例

  • 查看所有镜像： 
    docker images
  • 查看运行中的容器： 
    docker ps
  • 停止容器： 
    docker stop my-nginx
  • 删除容器： 
    docker rm my-nginx

高级配置与常见问题解决

1. 配置 Docker 资源

在 Settings → Resources 中，可调整以下参数：

  • CPU 和内存：根据开发需求分配资源（如分配 4GB 内存）。
  • 文件共享：在 File Sharing 标签下添加需共享的 Windows 目录，以便容器访问本地文件。

2. 常见问题与解决方案

问题 1：Docker Desktop 服务无法启动

可能原因：Hyper-V 或 WSL 2 未正确启用。
解决方法：

  1. 检查 Hyper-V 是否启用（参考安装前准备步骤）。
  2. 确保 WSL 2 是默认版本： 
    wsl --set-default-version 2

问题 2：端口占用冲突

现象：运行容器时提示端口已被占用（如 port is already allocated）。
解决方法：

  • 更改映射端口： 
    docker run -d -p 8080:80 --name my-nginx nginx:latest
  • 停止占用端口的进程（如通过 netstat -ano 查找 PID 后终止进程）。

结论

通过本文的讲解，读者应已掌握 Windows Docker 安装 的完整流程，并能够通过实际案例验证 Docker 的核心功能。Docker 不仅简化了开发环境的配置，还为微服务架构、持续集成等场景提供了强大的支持。建议读者进一步探索 Dockerfile、Docker Compose 等高级工具，以实现更复杂的容器化场景。

行动建议：

  1. 尝试将本地项目打包成 Docker 镜像。
  2. 使用 docker-compose.yml 管理多容器应用。
  3. 参考官方文档（Docker Docs ）深入学习进阶技巧。

通过实践，开发者将逐渐体会到 Docker 在提升开发效率、环境一致性方面的巨大价值。

最新发布

查看更多文章