以下是Windows安装WSL(Windows Subsystem for Linux)及在Ubuntu中配置使用Docker的完整流程,整合了最新官方方案和常见问题解决方案:
🔧 一、Windows安装WSL(推荐WSL 2)
📍 安装前提
- 系统要求:Windows 10版本2004(Build 19041)或更高,或Windows 11。
- 启用虚拟化:需在BIOS/UEFI中开启Intel VT-x/AMD-V(重启电脑进入BIOS设置)。
⚙️ 安装步骤
- 管理员身份启动PowerShell
wsl --install
- 此命令自动完成以下操作:
- 启用WSL和虚拟机平台功能
- 安装最新Linux内核
- 默认安装Ubuntu发行版
- 此命令自动完成以下操作:
- 重启电脑
安装完成后根据提示重启系统。 - 初始化Ubuntu
重启后首次打开Ubuntu,按提示设置用户名和密码(密码输入不可见)。
💡 自定义发行版安装(如安装Ubuntu 22.04):
wsl --list --online # 查看可用发行版 wsl --install -d Ubuntu-22.04 #(可选) # 或者Microsoft Store中安装
⚠️ 常见问题解决
- 报错
0x80070057
:检查系统版本是否≥19041,过低需升级。 - WSL 2未启用:
重启后重试。dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart wsl --set-default-version 2
- 代理配置冲突:若启动时提示
localhost代理未镜像
,关闭VPN或代理软件[citation:5]。
🐳 二、安装Docker Desktop
📦 安装流程
-
下载安装包
访问Docker官网下载Windows版安装程序
下载链接:Docker Desktop Installer.exe
-
运行安装向导
- 勾选
Install required Windows components for WSL 2
(关键选项!) - 安装完成后重启电脑
- 勾选
-
基础配置
- 启动Docker Desktop,托盘图标显示🐳即正常
- 验证安装(PowerShell):
docker --version # 显示版本号(如24.0.7) docker run hello-world # 输出欢迎信息即成功(docker hub访问不了的话,这个命令会超时报错)
🔧 关键集成配置(WSL 2支持)
-
打开Docker Desktop → Settings → General
- 勾选
Use the WSL 2 based engine
- 勾选
-
进入 Resources → WSL Integration
- 启用
Enable integration with my default WSL distro
- 勾选已安装的Ubuntu(如
Ubuntu-22.04
)
- 启用
🚀 性能优化
- 镜像加速:编辑
C:\Users\<用户>\.docker\daemon.json
,添加国内镜像源:
(推荐阿里云/腾讯云镜像地址){"registry-mirrors": ["https://<你的镜像码>.mirror.aliyuncs.com"] }
🚀 验证阿里云镜像是否配置成功
登录阿里云镜像控制台
从制品中心找下阿里云自带的MySQL镜像,拉取并启动:
docker run -ti -d --privileged=“true” --net=host alibaba-cloud-linux-3-registry.cn-hangzhou.cr.aliyuncs.com/alinux3/mysql_optimized:20240221-8.0.32-2.3.0 mysql_keentune.sh
镜像拉取成功
启动成功
💎 总结
- WSL 2 + Docker 是Windows下最轻量的Linux开发方案,无需虚拟机即可原生运行容器[citation:9]。
- 关键路径:
- Windows文件 → Linux:
/mnt/c/
- Linux文件 → Windows:
\\wsl$\Ubuntu\
- Windows文件 → Linux:
- 避坑提示:若安装失败,优先检查系统版本、虚拟化是否启用,并关闭代理工具。
通过上述步骤,你已在Windows中构建了完整的Linux开发环境,可直接在Ubuntu内使用Docker部署应用,同时无缝操作双系统文件,高效完成跨平台开发任务 🎉。