windows 系统安装 docker

[TOC]

安装 docker

• 第1步，检查 Windows 版本，必须是64位的版本，支持的操作系统清单如下：

Windows 10 专业版或企业版（版本 1607） x64
Windows 11 x64
Windows Server 2016 x64
Windows Server 2019 x64

• 第2步，打开任务管理器，选择“性能 - CPU”， 确认 虚拟化 已启用

附：示例为 VMWare 虚拟机启用虚拟化（需关机状态调整），开机后利用 PowerShell 运行如下命令：

#.启用基于虚拟化的安全性(VBS)
Set-ItemProperty -Path HKLM:\SYSTEM\CurrentControlSet\Control\DeviceGuard -Name EnableVirtualizationBasedSecurity -Value 1

#.重启服务器生效
Restart-Computer -Force

• 第3步，依次打开“控制面板 -> 程序 -> 启用或关闭 Windows 功能”，勾选并安装下面4个功能，安装完毕后根据提示重启电脑

• 第4步，执行 wsl 查看是否已安装 WSL（Windows Subsystem for Linux），没有安装则提示如下：

C:\Windows\System32>wsl
适用于 Linux 的 Windows 子系统没有已安装的分发版。
可以通过访问 Microsoft Store 来安装分发版:
https://aka.ms/wslstore

• 第5步，安装 WSL 2 之前，必须启用 适用于 Linux 的 Windows 子系统、虚拟机平台

dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

• 第6步，下载 WSL 安装包，然后双击安装

cd /d c:\opt
wget -c http://oss.sqlfans.cn/docker/wsl_update_x64.msi
start /wait wsl_update_x64.msi

• 第7步，将 WSL 2 设置为默认版本

C:\Windows\System32>wsl --set-default-version 2
有关与 WSL 2 关键区别的信息，请访问 https://aka.ms/wsl2

操作成功完成。

• 第8步，下载 docker 安装包，然后双击安装，安装之后建议重启系统

cd /d c:\opt
wget -c http://oss.sqlfans.cn/docker/DockerDesktopInstaller.v4.37.1.0.exe
start /wait DockerDesktopInstaller.v4.37.1.0.exe

• 第9步，打开 Docker Desktop，完成初始化配置

• 第10步，将 docker 服务设置为自动启动

sc config com.docker.service start= auto
net start com.docker.service

• 第11步，在CMD终端中输入如下命令，检查是否安装成功

C:\Windows\System32>docker --version
Docker version 27.4.0, build bde2b89

C:\Windows\System32>docker images
REPOSITORY   TAG       IMAGE ID   CREATED   SIZE

注：若执行 docker images 长时间无反应，可以尝试 wsl --update 然后重启机器，开机器后再启动 com.docker.service 服务

遇到的问题

• 问题1：执行 docker images 报错 error during connect: Head xxx: open //./pipe/dockerDesktopLinuxEngine: The system cannot find the file specified. the file specified.

C:\Users\Administrator>docker --version
Docker version 27.4.0, build bde2b89

C:\Users\Administrator>docker images
error during connect: Head "http://%2F%2F.%2Fpipe%2FdockerDesktopLinuxEngine/_ping": open //./pipe/dockerDesktopLinuxEngine: The system cannot find the file specified.

• 解决1：打开 Docker Desktop，完成初始化配置，并将 docker 服务设置为自动启动