Docker + WSL2 完整安装指南

一、前置环境

• 系统：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 盘

1. 打开 Docker Desktop → 设置（Settings）→ 资源（Resources）→ 高级（Advanced）；

2. 找到「Disk image location」，点击「Browse」选择 D 盘路径（如 D:\\Docker\\Data\\DockerDesktopWSL）；

3. 点击「Apply & Restart」，Docker 会自动迁移数据到新路径。

配置 Docker 代理（Github 拉镜像不卡）

1. Docker Desktop → 设置 → 资源 → 代理（Proxies）；

2. 选择「Manual proxy configuration」，填写：

• HTTP Proxy：127\.0\.0\.1:端口号

• HTTPS Proxy：127\.0\.0\.1:端口号

3. No Proxy 留空，点击应用重启。

步骤 4：验证安装成功

# 进入 WSL 终端执行
docker pull hello-world
docker run hello-world

看到「Hello from Docker!」提示，说明安装完成。