前言Docker 是一种开源的容器化平台能够将应用程序及其依赖项打包成轻量级、可移植的容器。在 Windows 环境下安装 Docker 是学习和使用 Milvus 向量数据库的必要前提因为 Milvus 官方不提供 Windows 原生安装包需要通过 Docker 来运行。本文将详细介绍在 Windows 系统中安装 Docker Desktop 的完整流程包括前置条件检查、下载、安装、配置以及常见问题的解决方案。环境说明操作系统Windows 10/11推荐使用 PowerShell 执行命令一、前置条件检查在开始安装之前需要确认你的系统满足以下要求1.1 系统要求要求说明Windows 版本Windows 10 64位 专业版/家庭版 或 Windows 11内存至少 4GB RAM推荐 8GB 或以上磁盘空间至少 20GB 可用空间BIOS 设置虚拟化功能已启用CPU支持虚拟化技术Intel VT-x 或 AMD-V1.2 检查系统信息按Win R输入msinfo32查看系统信息确认以下信息操作系统Windows 10/11系统类型x64-based PC1.3 检查虚拟化是否启用打开任务管理器Ctrl Shift Esc切换到「性能」选项卡确认「虚拟化」显示为「已启用」。如果显示「已禁用」需要进入 BIOS 设置启用虚拟化。二、启用 Windows 功能Docker Desktop 需要启用 Windows 的虚拟化相关功能。2.1 打开 Windows 功能按Win R输入optionalfeatures.exe回车打开「Windows 功能」窗口2.2 勾选必要选项在列表中找到并勾选以下两项☑Hyper-V如果 Windows 10 专业版/企业版没有此选项可跳过☑适用于 Linux 的 Windows 子系统必须勾选☑虚拟机平台必须勾选注意不同 Windows 版本显示的选项可能略有差异。如果只有「适用于 Linux 的 Windows 子系统」和「虚拟机平台」两项勾选这两项即可。2.3 重启电脑点击「确定」后系统会提示需要重启。保存所有工作后重启电脑使配置生效。三、下载 Docker Desktop3.1 访问官网下载页面打开浏览器访问 Docker 官方下载页面https://www.docker.com/products/docker-desktop/3.2 点击下载按钮点击「Download Docker Desktop for Windows」按钮提示如果网络较慢可以考虑使用国内镜像站下载或使用科学上网工具。3.3 选择下载版本系统会自动检测并推荐适合你系统的版本Apple Silicon适用于 Mac M1/M2/M3 芯片Windows (x86_64)适用于 Intel/AMD 处理器大多数 Windows 电脑按Win R输入msinfo32查看「系统类型」x64-based PC → 下载 amd64ARM-based PC → 下载 arm64四、安装 Docker Desktop4.1 运行安装程序找到下载的安装文件通常为Docker Desktop Installer.exe双击运行。注意如果弹出用户账户控制UAC提示点击「是」允许运行。4.2 安装选项在安装向导中可以根据需要进行以下配置推荐配置选项选项说明建议使用 WSL 2 而不是 Hyper-V更轻量、性能更好☑ 勾选推荐添加桌面快捷方式在桌面创建图标☑ 勾选安装后启动 Docker Desktop安装完成后自动启动根据需要提示如果系统不支持 WSL 2安装程序会自动回退到 Hyper-V 模式。4.3 等待安装完成点击「Install」开始安装安装过程可能需要 5-10 分钟取决于电脑配置和网络速度。4.4 安装完成安装完成后点击「Close」关闭向导五、验证安装5.1 检查 Docker 版本打开 PowerShell开始菜单搜索「PowerShell」输入以下命令docker--version应该看到类似输出Docker version 27.x.x, build xxxxxxx5.2 检查 Docker Compose 版本docker-compose--version应该看到类似输出docker-compose version v2.x.x5.3 运行测试容器运行一个简单的测试容器来验证 Docker 是否正常工作docker run hello-world如果看到以下输出说明 Docker 安装成功Hello from Docker! This message shows that your installation appears to be working correctly.如果失败了尝试使用如下方法解决以管理员身份打开 PowerShell 或命令提示符。先停止所有 WSL 实例wsl --shutdown。然后强制更新 WSL 内核绕过缓存wsl --update --web-download。确保内核版本 ≥ 5.10.102.1可以用wsl --kernel-version查看。完成后重新启动 Docker Desktop试试。5.4 查看 Docker 信息docker info这条命令会显示 Docker 的详细信息包括Docker 客户端和服务器版本镜像数量容器数量存储驱动镜像加速器等六、配置与优化7.1 配置镜像加速可选由于 Docker Hub 在国内访问较慢建议配置镜像加速器来提高拉取镜像的速度。进入 Docker Engine 设置在左侧菜单中选择「Docker Engine」修改配置文件在右侧的 JSON 编辑器中将配置修改为以下内容如果已有registry-mirrors配置可以直接替换{builder:{gc:{defaultKeepStorage:20GB,enabled:true}},experimental:false,registry-mirrors:[https://docker.1ms.run,https://dockerproxy.com,https://docker.mirrors.ustc.edu.cn,https://docker.haitaozhou.top,https://docker-0.unsee.tech,https://docker.m.daocloud.io]}说明以上镜像源经过测试可用如有失效可自行搜索可用的镜像地址。点击「Apply Restart」Docker 会自动重启并应用新的配置。验证镜像加速配置完成后可以通过以下命令验证docker info在输出信息中找到Registry Mirrors确认镜像地址已生效Registry Mirrors: https://docker.1ms.run/ https://dockerproxy.com/ https://docker.mirrors.ustc.edu.cn/ ...7.2 迁移镜像存储位置可选Docker 默认将镜像和容器数据存储在系统盘C 盘长期使用会占用大量空间。如果 C 盘空间有限建议将 Docker 数据迁移到其他磁盘。打开Docker点击右上角【Settings齿轮图标】进入【Resources】-【Advanced 】设置页面找到【Disk image location】点击浏览将存储路径修改至D/E/F盘空闲文件夹示例E:\Docker\wsl点击【Apply Restart】等待文件自动迁移、重启生效彻底规避C盘占用问题注意事项事项说明确保目标磁盘有足够空间迁移前检查目标磁盘可用空间是否足够选择与 C 盘文件系统相同的磁盘建议都是 NTFS 格式迁移过程中不要中断复制过程中关闭其他程序减少磁盘占用备份原数据重要数据建议先备份以防迁移失败Docker 版本确保 Docker Desktop 版本支持此操作七、常见问题解决8.1 WSL 2 未安装问题描述安装时报错提示 WSL 2 未安装。解决方案以管理员身份打开 PowerShell执行以下命令wsl--update如果提示需要下载 WSL 2 内核更新包手动下载并安装https://wslstorestorage.blob.core.windows.net/wslblob/wsl_update_x64.msi8.2 虚拟化未启用问题描述Docker 无法启动提示虚拟化未启用。解决方案重启电脑进入 BIOS 设置开机时按F2/Del/Esc等键进入找到「Virtualization Technology」或「Intel VT-x」选项将其设置为「Enabled」保存并退出 BIOS8.3 Docker 服务无法启动问题描述Docker Desktop 显示 “Docker Engine stopped”。解决方案检查 WSL 2 是否正常工作wsl--list--verbose重置 Docker Desktop打开 Docker Desktop 设置选择「Troubleshoot」点击「Reset to factory defaults」重启电脑后重新尝试8.4 端口冲突问题描述Docker 报告端口已被占用。解决方案查找占用端口的进程netstat-ano|findstr :80关闭占用端口的进程或修改 Docker 容器使用的端口。8.5 磁盘空间不足问题描述Docker 报告磁盘空间不足。解决方案清理未使用的镜像和容器docker system prune-a移动 Docker 数据目录到空间更大的磁盘打开 Docker Desktop 设置选择「Resources」-「Advanced」修改「Disk image location」九、相关资源Docker Desktop 官方下载Docker Desktop Windows 安装文档
