在Windows 11 中安装和使用 WSL 2

文章目录

列出可安装的发行版/分发

在安装

WSL

之前，可以通过以下命令查看可供安装的发行版：

wsl --list --online

安装WSL 2

参考：使用 WSL 在 Windows 上安装 Linux：https://learn.microsoft.com/zh-cn/windows/wsl/install

如果不指定发行版，则该命令将安装

WSL

和 Linux 的默认

Ubuntu

发行版：

wsl --install

如果要安装指定的 Linux 发行版，需要添加参数

--distribution

：

wsl --install --distribution <发行版名称>

例如要安装

Ubuntu-22.04

：

wsl --install --distribution Ubuntu-22.04

安装时可能会报错，部分错误如下所示

1. WslRegisterDistribution failed with error: 0x80370114 Error: 0x80370114 ???
2. 由于未安装所需的特性，无法启动操作。Error code: Wsl/Service/CreateInstance/CreateVm/HCS_E_SERVICE_NOT_AVAILABLE

这时先重启电脑，然后输入刚才安装的发行版的名称：

Ubuntu-22.04

如果能成功打开，那么第一次打开时需要设置用户名和密码，设置好后就能正常使用了。

如果报错是找不到xxx文件、无法挂载xxx文件等，那么输入命令列出当前已下载到电脑上的发行版：

wsl -l -v

卸载刚才打开失败的发行版：

wsl --unregister <发行版名称>

再重新安装：

wsl --install --distribution <发行版名称>

常用命令

显示帮助

wsl --help

启动分发

输入

wsl

会启动默认分发

加上参数

-d <发行版名称>

会启动指定分发，例如启动

Ubuntu-22.04

：

wsl -d Ubuntu-22.04

如果在

C:\Users\admin\AppData\Local\Microsoft\WindowsApps

中有特定分发的exe文件，那么输入文件名如

ubuntu2204

则会启动对应的分发：

从powershell中退出分发

按

Ctrl+D

或输入

exit

或直接关闭powershell窗口

关闭正在运行的分发

wsl --terminate <发行版名称>

或

wsl -t <发行版名称>

立即终止所有正在运行的分发和 WSL 2轻型虚拟机。

wsl --shutdown

更新wsl

wsl --update

使用VSCode连接WSL

在扩展中搜索

remote

，安装Remote Development：

在远程资源管理器中找到要连接的发行版连接：

如果在同步插件时出现因网络问题下载失败的情况，尝试关闭防火墙然后重新下载。

设置代理

既然是在Windows上使用，那么共用同一个代理最方便，工具教程见链接（一定要开启TUN模式）：https://bbs.huaweicloud.com/blogs/394280

在Windows上安装好后，只要设置好TUN模式，无需在wsl中进行任何设置，即可使用Windows上开启的代理。

换源

sudosed -i 's/archive.ubuntu.com/mirrors.ustc.edu.cn/g' /etc/apt/sources.list

sudosed -i 's/security.ubuntu.com/mirrors.ustc.edu.cn/g' /etc/apt/sources.list

sudoapt update

WSL 与 Windows 11 共享文件

在文件资源管理器中输入

Linux

即可找到文件：

导入、导出 WSL 发行版

通过导入和导出，可以实现 WSL 发行版的备份、迁移，类似于 Docker 中将容器导出为

*.tar

文件。

参考：

1. 企业环境：为公司设置适用于 Linux 的 Windows 子系统
2. 导入要与 WSL 一起使用的任何 Linux 发行版

导出

1. 关闭要导出的发行版 使用 wsl --shutdown 一次关闭所有发行版，或使用 wsl -t <发行版名称> 关闭特定的发行版
2. 执行导出命令：wsl --export <发行版名称><tar文件保存路径> 例如要导出一个名为 Ubuntu-22.04 的发行版，保存到 C:\Users\admin\Downloads\Ubuntu-2204.tar 中，那么命令为：wsl --export Ubuntu-22.04 C:\Users\admin\Downloads\Ubuntu-2204.tar

导入

1. 新建一个文件夹用于存储导入后的发行版的数据，例如我创建的文件夹路径为 C:\MyData\wslDistroStorage
2. 执行导入命令：wsl --import <发行版名称><发行版数据保存路径><tar文件保存路径>- <发行版名称> 是自定义的名称，可以叫 Ubuntu-22.04 ，也可以叫 Ubuntu_22.04- <发行版数据保存路径> 就是第一步中创建的文件夹的路径- <tar文件保存路径> 是导出时 *.tar 文件的路径。例如导入我刚才导出的 Ubuntu-2204.tar ，并将导入的发行版命名为 Ubuntu_22.04 ：wsl --import Ubuntu_22.04 C:\MyData\wslDistroStorage C:\Users\admin\Downloads\Ubuntu-2204.tar``````*标记的 Ubuntu-22.04 是wsl默认启动的发行版，是前面通过 wsl --install --distribution Ubuntu-22.04 命令安装的版本，下面的 Ubuntu_22.04 是刚才导入的发行版：
3. 设置默认用户 导入的发行版启动之后默认是 root 用户，想要设置为指定用户（前提是存在），就需要修改 /etc/wsl.conf ，关于这个文件的更多信息见WSL 中的高级设置配置。echo -e "[user]\ndefault=<用户名>">> /etc/wsl.conf例如指定为 rog ，那么命令为：echo -e "[user]\ndefault=rog">> /etc/wsl.conf关闭发行版，再次启动后就会更改成功

安装Docker Engine

参考：https://zhaoliangcheng.blog.csdn.net/article/details/130251071

1. 更新apt包索引并安装包以允许apt通过 HTTPS 使用存储库：

sudoapt-get update

sudoapt-getinstall\
    ca-certificates \curl\
    gnupg \
    lsb-release

1. 添加 Docker 的官方 GPG 密钥：

sudomkdir -p /etc/apt/keyrings

curl -fsSL https://download.docker.com/linux/ubuntu/gpg |sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg

1. 使用以下命令设置存储库：

echo\"deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \
  $(lsb_release -cs) stable"|sudotee /etc/apt/sources.list.d/docker.list > /dev/null

1. 更新apt包索引，安装最新版本的 Docker Engine、containerd 和 Docker Compose

sudochmod a+r /etc/apt/keyrings/docker.gpg

sudoapt-get update

sudoapt-getinstall docker-ce docker-ce-cli containerd.io docker-compose-plugin

1. 创建 docker 组

sudogroupadddocker

1. 将用户添加到 docker 组中

sudousermod -aG docker$USER

1. 设置为开机自启

sudo systemctl enable docker.service
sudo systemctl enable containerd.service

1. 重启wsl关闭原来正在运行wsl的powershell窗口，然后再打开新的powershell窗口，执行以下命令：

wsl --shutdown

使用GPU

需要在Windows中安装最新的显卡驱动，不能在WSL中安装显卡驱动。

为WSL中的Docker启用GPU

参考官方文档：WSL 中 ML 的 GPU 加速入门

与在Ubuntu中安装一样，依次执行下列命令即可：

distribution=$(. /etc/os-release;echo $ID$VERSION_ID)

curl -s -L https://nvidia.github.io/nvidia-docker/gpgkey |sudo gpg --dearmor -o /usr/share/keyrings/nvidia-docker-keyring.gpg

curl -s -L https://nvidia.github.io/nvidia-docker/$distribution/nvidia-docker.list |sed's#deb https://#deb [signed-by=/usr/share/keyrings/nvidia-docker-keyring.gpg] https://#g'|sudotee /etc/apt/sources.list.d/nvidia-docker.list

sudoapt-get update

sudoapt-getinstall -y nvidia-docker2

直接在WSL中使用CUDA

参考官方文档：CUDA Support for WSL 2

使用Docker进行开发

参考：https://zhaoliangcheng.blog.csdn.net/article/details/126125106

在

wsl

中新建一个文件夹例如命名为

challenge_cup_docker

，然后在该文件夹内进行之后的操作：

cd&&mkdir challenge_cup_docker &&cd challenge_cup_docker

制作镜像

如果有现成的镜像用，可以跳过这一步。

以制作一个基于官方的ROS 2 Humble镜像的自定义镜像为例。

Dockerfile

新建一个

Dockerfile

文件：

FROM osrf/ros:humble-desktop-full

RUN /bin/bash -c "sed -i 's/archive.ubuntu.com/mirrors.ustc.edu.cn/g' /etc/apt/sources.list \ 
    && sed -i 's/security.ubuntu.com/mirrors.ustc.edu.cn/g' /etc/apt/sources.list \ 
    && apt update && apt upgrade -y && \
    DEBIAN_FRONTEND=noninteractive apt install tzdata git openssh-server vim zsh \ 
    build-essential pkg-config libavcodec-dev libavformat-dev libswscale-dev \ 
    libssl-dev openssl sudo net-tools inetutils-ping \ 
    usbutils x11-apps language-pack-zh* iproute2 ninja-build -y && \
    apt clean"

然后构建镜像，我使用了阿里云的容器镜像服务托管镜像（教程见https://zhaoliangcheng.blog.csdn.net/article/details/125810516），所以镜像名称命名为

registry.cn-hangzhou.aliyuncs.com/2h1c_aliyun/challenge_cup_docker:latest

：

docker build -t=registry.cn-hangzhou.aliyuncs.com/2h1c_aliyun/challenge_cup_docker:latest .

使用容器

新建一个

docker-compose.yml

文件，各参数具体含义见https://zhaoliangcheng.blog.csdn.net/article/details/126125106

允许运行GUI程序

参考：https://zhaoliangcheng.blog.csdn.net/article/details/125771897

在

wsl

中安装x11-xserver-utils

sudoaptinstall x11-xserver-utils

然后执行命令：

xhost +

之后在容器中启动GUI程序，就能正常显示窗口了。

docker-compose.yml

version:'3.7'name: challenge_cup_docker
services:challenge_cup_docker:init:truecontainer_name: challenge_cup_docker
    network_mode:"host"privileged:trueimage: registry.cn-hangzhou.aliyuncs.com/2h1c_aliyun/challenge_cup_docker:latest
    command: bash -c "service ssh start && tail -f /dev/null"
    volumes:-"/tmp/.X11-unix:/tmp/.X11-unix:rw"-"/dev:/dev:rw"-"./Environments:/root/Environments:rw"-"./SHARE:/root/SHARE:rw"-"/mnt:/mnt:rw"-"/tmp:/tmp:rw"devices:-"/dev:/dev:rw"working_dir: /root
    environment:- DISPLAY=$DISPLAY
      - LC_ALL=C.UTF-8

• 为了防止因容器变动导致容器内需要保存的文件丢失（例如代码），可以将文件放在 /root/SHARE 中，这个目录对应 challenge_cup_docker 中的 SHARE （相当于共享文件夹），wsl和容器都能访问这个文件夹

创建、启动

第一次启动时需要先创建容器：

docker compose up -d

之后在你的电脑中会创建一个名为

challenge_cup_docker

的容器，每次启动容器只需运行：

docker start challenge_cup_docker

关闭

容器只会关闭，不会被删除，里面的数据也不会丢失：

docker stop challenge_cup_docker

删除

删除容器，里面的数据会丢失：

docker compose down

重置

先删除，后创建：

docker compose down

docker compose up -d

进入

dockerexec -it challenge_cup_docker bash

或使用ssh命令连接：

ssh -p 2222 root@localhost -Y

退出

按

Ctrl+D

或输入

exit

或直接关闭窗口

导出/保存容器

先关闭容器：

docker stop challenge_cup_docker

然后在当前目录下导出为tar包：

dockerexport -o=challenge_cup_docker.tar challenge_cup_docker

导入为镜像并创建新的容器

在tar包所在目录执行：

dockerimport challenge_cup_docker.tar registry.cn-hangzhou.aliyuncs.com/2h1c_aliyun/challenge_cup_docker:latest

原来的

registry.cn-hangzhou.aliyuncs.com/2h1c_aliyun/challenge_cup_docker:latest

镜像名称会变为，可以通过

docker images -a

命令查看：

旧镜像就没用了，可以先删除旧容器，然后用

docker rmi <镜像ID>

命令删除旧镜像：

然后在

docker-compose.yml

所在目录执行：

docker compose up -d

这样会删除原来的容器，然后创建新的容器，但

SHARE

、

Environments

文件夹中的文件不会丢失

使用VSCode连接容器

与前面所讲的

使用VSCode连接WSL

类似，先用VSCode连接到wsl，再在左侧的远程资源管理器中选择

开发容器

，右键选择

附加到容器

即可连接：

或者在

远程

中新建ssh连接：