1. 为什么需要脱机安装WSL与Docker Desktop在Windows环境下进行开发时我们经常会遇到需要Linux环境的情况。传统解决方案是使用虚拟机但虚拟机资源占用高、启动慢。Windows Subsystem for Linux (WSL)的出现改变了这一局面它允许开发者在Windows上直接运行Linux二进制文件无需完整的虚拟机环境。然而很多企业环境或特定场景下开发机器可能无法连接互联网或者网络环境不稳定。这时就需要脱机安装方案。我曾在一个金融项目上遇到这样的情况客户的生产开发环境完全隔离无法连接外网但项目又需要使用Docker进行容器化部署。通过脱机安装WSL和Docker Desktop我们成功在隔离环境中搭建起了完整的开发环境。2. 准备工作获取脱机安装包2.1 下载WSL离线安装包首先需要在一台能联网的机器上获取WSL的离线安装包。微软官方提供了多种获取方式通过PowerShell命令下载Invoke-WebRequest -Uri https://aka.ms/wsl2kernel -OutFile ~/wsl_update_x64.msi或者直接从微软官网下载WSL2内核更新包https://aka.ms/wsl2kernel特定Linux发行版如Ubuntu的.appx包可以从Microsoft Store获取提示建议下载最新稳定版本的安装包不同版本的WSL在功能和性能上有显著差异。我通常会选择LTS版本的Ubuntu作为默认发行版。2.2 获取Docker Desktop离线安装包Docker官方也提供了离线安装包访问Docker官网下载页面https://www.docker.com/products/docker-desktop选择Download for Windows (offline installer)将下载的Docker Desktop Installer.exe文件保存到U盘或共享目录2.3 系统要求检查在开始安装前需要确保目标机器满足以下要求组件最低要求推荐配置操作系统Windows 10 2004及以上Windows 11 22H2内存4GB16GB存储20GB可用空间50GB SSDBIOS设置启用虚拟化启用虚拟化和Hyper-V检查虚拟化是否启用systeminfo | find Hyper-V Requirements如果看到Virtualization Enabled In Firmware: Yes则表示已启用。3. 分步安装WSL3.1 安装WSL内核更新将之前下载的wsl_update_x64.msi复制到目标机器双击运行安装程序按照向导完成安装验证安装wsl --version应该能看到类似输出WSL version: 2.0.9.0 Kernel version: 5.15.90.13.2 离线安装Linux发行版将下载的.appx包如Ubuntu.appx复制到目标机器重命名为.zip并解压在解压目录中找到.exe文件如ubuntu.exe运行该文件完成安装注意如果遇到无法验证应用的错误可以尝试以下命令Add-AppxPackage -Path .\Ubuntu.appx -ForceApplicationShutdown3.3 配置WSL默认版本设置WSL2为默认版本wsl --set-default-version 2验证安装的发行版wsl -l -v正常输出应显示已安装的发行版及其状态。4. Docker Desktop脱机安装与配置4.1 安装Docker Desktop运行之前下载的Docker Desktop Installer.exe选择Install并等待完成安装完成后不要立即启动4.2 解决常见安装问题问题1虚拟化支持未检测到如果遇到Virtualization support not detected错误检查BIOS中虚拟化是否启用确保Windows功能中启用了以下选项Hyper-V虚拟机平台Windows子系统Linux启用命令Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Hyper-V -All Enable-WindowsOptionalFeature -Online -FeatureName VirtualMachinePlatform Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux问题2WSL2需要更新如果提示WSL2需要更新但无法联网确保已安装最新的WSL2内核更新包设置默认版本wsl --set-default-version 24.3 配置Docker使用WSL2后端启动Docker Desktop进入Settings General勾选Use WSL 2 based engine在Resources WSL Integration中启用已安装的Linux发行版验证配置docker version应显示客户端和服务器版本且服务器OS/Arch显示为linux/amd64。5. 高级配置与优化5.1 WSL内存和CPU限制默认情况下WSL2会使用最多50%的物理内存。在生产环境中我们可能需要限制其资源使用创建或编辑%USERPROFILE%.wslconfig文件[wsl2] memory4GB processors2 swap1GB localhostForwardingtrue重启WSL使配置生效wsl --shutdown5.2 Docker磁盘映像位置默认情况下Docker数据存储在系统盘。我们可以将其移动到其他驱动器使用wsl --export导出现有数据使用wsl --import在新位置重新导入在Docker Desktop设置中更新路径5.3 网络配置在企业环境中可能需要配置代理在%USERPROFILE%.wslconfig中添加[network] generateResolvConffalse在Linux发行版中手动配置/etc/resolv.conf6. 实际开发场景集成6.1 开发环境配置在WSL中配置开发环境安装基本工具链sudo apt update sudo apt install -y build-essential git curl配置SSH密钥ssh-keygen -t ed25519安装Docker客户端curl -fsSL https://get.docker.com | sh6.2 IDE集成主流IDE如VS Code可以完美集成WSL安装Remote - WSL扩展在WSL终端中输入code .VS Code会自动在WSL环境中运行6.3 容器化开发流程典型开发流程在WSL中克隆代码仓库使用Docker Compose启动依赖服务在VS Code中开发调试构建并测试容器镜像示例docker-compose.ymlversion: 3.8 services: app: build: . ports: - 3000:3000 volumes: - .:/app depends_on: - db db: image: postgres:13 environment: POSTGRES_PASSWORD: example7. 故障排除与维护7.1 常见问题解决问题Docker Desktop无法启动解决方案检查服务是否运行Get-Service com.docker.service重置Docker数据在Docker Desktop设置中选择Reset to factory defaults或者手动删除%APPDATA%\Docker和%USERPROFILE%.docker问题WSL启动缓慢优化建议禁用不必要的自动挂载wsl --shutdown 然后编辑%USERPROFILE%\.wslconfig添加 [wsl2] autoMemoryReclaimgradual7.2 性能监控监控WSL资源使用wsl --systeminfo监控Docker资源使用docker stats7.3 定期维护清理无用容器和镜像docker system prune -a备份重要数据wsl --export Ubuntu ubuntu_backup.tar更新WSL内核当有新版本可用时wsl --update --web-download在实际项目中我发现这套脱机安装方案特别适合以下场景企业内网开发环境需要快速部署的标准开发环境对开发环境有严格管控要求的场景一个实用的技巧是将完整的脱机安装包和安装脚本打包成一个自解压的安装包这样在新机器上部署时可以一键完成所有配置。我在团队内部维护了这样一个安装包大大简化了新成员的开发环境搭建过程。