多彩编程 多彩编程MZPH · CODE BLOG
ARTICLE DETAIL

文章详情

深耕前端与后端开发技术的一线实战笔记与踩坑复盘。

绕过WSL在Windows安装Docker的完整指南

绕过WSL在Windows安装Docker的完整指南 1. 为什么需要绕过WSL安装Docker在Windows系统上运行Docker的传统方案是通过WSLWindows Subsystem for Linux后端。但实际工作中我们经常会遇到以下几种必须绕过WSL的情况企业IT策略限制部分公司域控环境会禁用WSL功能硬件兼容性问题老款CPU不支持二级地址转换SLAT等虚拟化技术资源占用考量WSL2会默认占用50%可用内存在开发机配置较低时影响性能特殊网络环境某些内网环境下WSL的网络代理配置异常复杂我最近在一台Surface Pro 4i5-7300U上就遇到了典型场景虽然开启了Hyper-V但安装Docker Desktop时持续报错Virtualization support not detected。经过排查发现是CPU缺少必要的VT-d指令集支持最终通过本文方法成功运行了Docker。2. 准备工作与环境检查2.1 系统版本要求Windows 10版本1903及以上内部版本18362Windows 11所有正式发行版均可必须为专业版/企业版/教育版家庭版需手动开启Hyper-V重要提示通过winver命令检查系统版本时如果显示版本2004OS内部版本19041.xxx这类带括号的版本号请以括号内数字为准。2.2 BIOS设置检查开机时按厂商特定按键DEL/F2/F12等进入BIOS确认以下选项已开启设置项典型名称必需性虚拟化技术Intel VT-x / AMD-V必须硬件强制数据执行保护Execute Disable Bit推荐IOMMUVT-d / AMD-Vi可选2.3 PowerShell环境验证以管理员身份运行以下命令Get-ComputerInfo -Property HyperVRequirementVirtualizationFirmwareEnabled返回True表示BIOS设置正确。接着检查Windows功能Get-WindowsOptionalFeature -Online -FeatureName Microsoft-Hyper-V如果State显示Disabled需要先启用Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Hyper-V -All -NoRestart3. 手动安装Docker引擎3.1 安装Hyper-V组件即使不使用WSLDocker Desktop仍依赖Hyper-V提供虚拟化支持。如果之前未启用需要手动安装# 安装Hyper-V管理工具 Add-WindowsCapability -Online -Name HyperVisor -ErrorAction Stop # 配置默认虚拟交换机 New-VMSwitch -Name DockerNAT -SwitchType Internal Get-NetAdapter | Where-Object {$_.InterfaceDescription -match DockerNAT} | Rename-NetAdapter -NewName vEthernet (DockerNAT) New-NetIPAddress -IPAddress 172.16.0.1 -PrefixLength 24 -InterfaceAlias vEthernet (DockerNAT)3.2 下载独立安装包从Docker官网下载离线安装包访问 Docker Desktop for Windows点击Download for Windows右侧的下拉箭头选择Download without WSL 2 backend版本约500MB3.3 静默安装配置创建安装配置文件settings.json{ installer: { no_wsl: true, no_desktop_shortcut: false, no_start_menu: true }, engine: { data_path: D:\\DockerData, storage_driver: windowsfilter } }使用管理员CMD执行安装start /wait DockerDesktopInstaller.exe install --quiet --accept-license --config-filesettings.json4. 网络与存储优化配置4.1 虚拟网络调整默认的NAT网络可能与企业内网冲突建议自定义子网Stop-Service docker $configFile $env:ProgramData\Docker\config\daemon.json $config Get-Content $configFile | ConvertFrom-Json $config | Add-Member -NotePropertyName bip -NotePropertyValue 192.168.100.1/24 -Force $config | ConvertTo-Json | Set-Content $configFile Start-Service docker4.2 存储驱动选择在daemon.json中添加性能优化参数{ storage-opts: [ size120GB, windows.mountoptmetadata ], experimental: false }5. 常见问题解决方案5.1 虚拟化支持报错错误信息Docker Desktop failed to start because virtualization support wasnt detected解决方案检查BIOS设置是否开启VT-x运行系统文件检查sfc /scannow重置Hyper-V虚拟交换机Reset-VMNetworkAdapter -ManagementOS -Name DockerNAT5.2 端口冲突处理当出现端口占用错误时快速查找冲突进程Get-Process -Id (Get-NetTCPConnection -LocalPort 2375).OwningProcess5.3 镜像加速配置在daemon.json中添加国内镜像源{ registry-mirrors: [ https://docker.mirrors.ustc.edu.cn, https://hub-mirror.c.163.com ] }6. 性能监控与调优6.1 资源限制设置为防止Docker占用过多资源创建%ProgramData%\Docker\config\resource-limits.json{ memory: 4GB, cpu: 2, io: { read: 100MB/s, write: 50MB/s } }6.2 监控工具推荐使用Windows自带性能监视器添加计数器\Process(docker)\% Processor Time磁盘监控\PhysicalDisk(*)\Avg. Disk Queue LengthPowerShell实时监控Get-Counter \Process(dockerd)\Working Set - Private -Continuous7. 实际使用技巧7.1 容器与宿主机文件交换创建持久化共享文件夹New-Item -Path C:\docker_share -ItemType Directory docker run -v C:\docker_share:/host_share alpine ls /host_share7.2 Windows容器混合运行虽然本文主要讨论Linux容器但也可以同时运行Windows容器[Environment]::SetEnvironmentVariable(DOCKER_DEFAULT_PLATFORM, windows, Machine) docker run --rm mcr.microsoft.com/windows/nanoserver:1809 cmd /c echo Hello7.3 开发环境集成示例以VS Code为例在settings.json中添加{ docker.explorerRefreshInterval: 3000, docker.commands.attach: start /B docker attach ${containerId}, docker.containers.description: 查看容器详情 }
返回列表