一、前置环境
系统:Windows 11 家庭版
代理:需要找到支持来自局域网连接代理,我这里使用 v2rayN/xray(SOCKS5 端口 10808)
二、完整安装步骤
步骤 1:安装并配置 WSL2
手动安装 WSL2 核心组件
(跳过 wsl \-\-install 自动下载,解决国内网络卡 0% 问题)
# 1. 启用 WSL 和虚拟机功能(管理员终端执行)
dism /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
# 2. 手动下载并安装 WSL2 内核更新包
# 下载地址:https://wslstorestorage.blob.core.windows.net/wslblob/wsl_update_x64.msi
# 3. 设置 WSL2 为默认版本
wsl --set-default-version 2
安装完成后重启电脑。
配置 WSL 网络,解决代理访问问题
WSL2 无法直接访问 Windows 本地代理,需配置环境变量:
# 进入 WSL 后执行
echo 'export HOST_IP=$(ip route show default | awk '{print $3}')' >> ~/.bashrc
echo 'export ALL_PROXY=socks5://$HOST_IP:10808' >> ~/.bashrc
echo 'export HTTP_PROXY=$ALL_PROXY' >> ~/.bashrc
echo 'export HTTPS_PROXY=$ALL_PROXY' >> ~/.bashrc
source ~/.bashrc
WSL 配置文件
新建 / 编辑 \.wslconfig(路径:C:\Users\你的用户名\.wslconfig),注释掉不支持的功能:
[wsl2]
# networkingMode=mirrored # Windows 11 Home 版不支持,请勿开启
memory=4GB # 可选:限制 WSL 内存占用
步骤 2:安装 Ubuntu 发行版
安装 Ubuntu
# 管理员终端执行,指定安装 Ubuntu
wsl --install -d Ubuntu
安装完成后重启终端,设置用户名(注意:不能纯数字)。
修复默认用户为 root 问题
如果进入 WSL 直接是 root,执行以下命令:
# Windows 终端(管理员)执行,替换为你的用户名
ubuntu config --default-user zuim
步骤 3:安装 Docker Desktop
下载并安装 Docker Desktop
下载地址:Docker 官网
无需纠结安装路径(默认装 C 盘,仅几百 MB),后续迁移数据到 D 盘即可。
迁移 Docker 数据到 D 盘
打开 Docker Desktop → 设置(Settings)→ 资源(Resources)→ 高级(Advanced);
找到「Disk image location」,点击「Browse」选择 D 盘路径(如
D:\\Docker\\Data\\DockerDesktopWSL);点击「Apply & Restart」,Docker 会自动迁移数据到新路径。
配置 Docker 代理(Github 拉镜像不卡)
Docker Desktop → 设置 → 资源 → 代理(Proxies);
选择「Manual proxy configuration」,填写:
HTTP Proxy:
127\.0\.0\.1:端口号HTTPS Proxy:
127\.0\.0\.1:端口号No Proxy 留空,点击应用重启。
步骤 4:验证安装成功
# 进入 WSL 终端执行
docker pull hello-world
docker run hello-world
看到「Hello from Docker!」提示,说明安装完成。
夜雨聆风