Dewedseed's Blog

WSL 基础介绍

WSL (Windows Subsystem for Linux)

Introduction

WSL (Windows Subsystem for Linux) 是微软在 Windows 10 和 Windows Server 2019 中引入的一个兼容层，它允许在 Windows 上运行 Linux 二进制可执行文件（包括 Linux 命令行工具、UNIX 工具和应用程序）

  • WSL 1: Windows NT 内核与 Linux 发行版之间的兼容层
  • WSL 2: 基于 Hyper-Visor 虚拟化平台，通过虚拟机分别运行 Windows 和 Linux 内核

Install

  1. 前置条件：开启 CPU 虚拟化和 windows 相关功能
1
2
3
4
## CPU虚拟化
BIOS > Advanced > CPU Configuration > Virtualization Technology > Enabled
## 修改 Windows 功能并重启电脑
Search: 启用或关闭 Windows 功能 > 适用于 Linux 的 Windows 子系统 & 虚拟机平台 & Hyper-V
  1. 添加 Hyper-V 阿里云
1
2
3
4
5
6
# 添加 Hyper-V.cmd 并以管理员执行
pushd "%~dp0"
dir /b %SystemRoot%\servicing\Packages\*Hyper-V*.mum >hyper-v.txt
for /f %%i in ('findstr /i . hyper-v.txt 2^>nul') do dism /online /norestart /add-package:"%SystemRoot%\servicing\Packages\%%i"
del hyper-v.txt
Dism /online /enable-feature /featurename:Microsoft-Hyper-V-All /LimitAccess /ALL
  1. 安装 WSL2
1
2
3
4
## 管理员身份打开 CMD
wsl --set-default-version 2
wsl -l -o
wsl --install -d Ubuntu-24.04
  1. 迁移至D盘
1
2
3
4
## 输出备份子系统至指定目录
wsl --export Ubuntu-24.04 D:\WSL\Ubuntu-24.04.tar
## 导入子系统至指定目录
wsl --import Ubuntu-24.04-2 D:\WSL\Ubuntu-24.04 D:\WSL\Ubuntu-24.04.tar
  1. 网络镜像
1
2
3
4
5
6
7
8
9
10
11
12
13
## 修改配置文件 C:/Users/xxx/.wslconfig
## 关键在于 networkingMode
[experimental]
autoMemoryReclaim=gradual
networkingMode=mirrored
dnsTunneling=true
firewall=true
autoProxy=true
## 关闭 WSL 并等待 8 秒
wsl --shutdown
## 查看 ip
Ubuntu  $ ifconfig
Windows $ ipconfig

Command

CMD Description
wsl --list -v list of subsystem
wsl --set-default xxx set default subsystem
wsl -d xxx distribution subsystem shell
wsl --unregister xxx uninstall subsystem
wsl --shutdown shutdown subsystem
wsl --export xxx path/xxx.tar export subsystem to tar
wsl --import xxx newPath path/xxx.tar import subsystem to newPath
df -h mount of subsystem

Docker

  1. 下载 Docker-Windows 并安装
  2. 设置：Docker Desktop > Settings > General > Use the WSL 2 based engine
  3. 集成：Docker Desktop > Settings > Resources > WSL Integration > Add WSL 2
  4. 验证：WSL2 > docker --version

VSCode

  1. 安装插件 WSL Docker Dev Container
  2. 在 WSL 指定目录下启动 code .，进入 VSCode-WSL
  3. 创建 Docker

Reference

以下是官方教程

  1. Microsoft | WSL
  2. Microsoft | WSL - Docker
  3. Microsoft | WSL - VSCode
  4. Microsoft | VSCode - Docker

以下是参考教程

  1. CSDN | WSL：检测到 localhost 代理配置，但未镜像到 WSL
  2. 知乎 | 无法解析服务器名称或地址，开启代理后再打开CMD
  3. 知乎 | Windows10/11 D盘 安装 WSL2
  4. CSDN | 在 Windows 中通过 WSL 2 高效使用 Docker
  5. 知乎 | WSL+VSCode食用指南
  6. VSCode 支持 Docker
0%