WSL2 安装与Docker安装-海口c网

WSL2 安装与Docker安装

article/2025/7/23 21:45:38

注意：如没有科学上网请勿尝试，无法判断是否会因网络错误导致的安装失败！！！

WSL2（Windows Subsystem for Linux 2）

功能简介：
WSL2 是微软提供的在 Windows 上运行完整 Linux 内核的子系统，支持原生 Linux 二进制程序，无需虚拟机即可实现 Linux 环境。它与 Windows 文件系统紧密集成，提供高速的文件访问和网络性能。

应用场景：

开发者在 Windows 机器上使用 Linux 工具链（如 Bash、Git、Python、Node.js 等）。
运行 Linux 服务器软件或测试环境。
学习和实验 Linux 系统与软件。
在 Windows 与 Linux 环境间无缝切换，简化跨平台开发流程。

Docker

功能简介：
Docker 是一个容器化平台，可以将应用及其依赖打包到轻量级、可移植的容器中，实现“一次构建，处处运行”。它提供快速部署、一致环境和资源隔离。

应用场景：

开发和测试环境标准化，避免“环境不一致”问题。
微服务架构中，各服务独立部署和管理。
持续集成/持续交付（CI/CD）流水线自动化。
方便应用迁移和扩展，尤其在云计算中。
运行数据库、中间件等依赖环境，简化配置和维护。

1. 系统要求与准备

Windows 10 专业版，版本号至少 19041 以上，建议更新至最新补丁。
需要开启虚拟化支持（BIOS 中开启 VT-x/AMD-V）。
需要安装并启用 Windows 子系统 Linux 和虚拟机平台功能，具体如下图选择后会确定安装。

2. 安装 WSL 功能

打开 PowerShell（管理员），执行后重启电脑：

dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

3. 安装或更新 WSL2 内核组件

下载并安装最新的 WSL2 Linux 内核更新包：

WSL2安装包链接

4. 设置 WSL 版本为 2（默认）

wsl --set-default-version 2
wsl -version

5. 安装 Ubuntu 发行版

Ubuntu 压缩包链接

进入该网址下载压缩包，注意选择AMD或ARM要根据你的电脑硬件型号决定，可以在任务管理器的性能里看到。

常见型号错误：<3>WSL (26 - Relay) ERROR: CreateProcessCommon:725: execvpe(/bin/bash) failed: Exec format error

请添加图片描述

手动导入刚才下好的安装包到自定义目录（例如 D 盘），我这里为了方便重命名为 ubuntu.tar.gz ：

wsl --import Ubuntu D:\WSL\Ubuntu C:\path\to\ubuntu.tar.gz --version 2

6.运行 WSL启动Ubuntu

wsl -d Ubuntu

更新软件：

 apt update && apt upgrade -y

添加用户，减少使用root用户：

 adduser user_name#提示你输入两次密码（不可见，直接输入即可）

提升权限：

usermod -aG sudo user_name

退出系统：

 exit

重新进入：

wsl -d Ubuntu -u user_name

查看目录：

passlink@DESKTOP-VI6RFKU:/mnt/d/WSL/Ubuntu$ cd /
passlink@DESKTOP-VI6RFKU:/$ ls
bin   dev  home  lib    lib64   lost+found  mnt  proc  run   snap  sys  usr
boot  etc  init  lib32  libx32  media       opt  root  sbin  srv   tmp  var

修改默认用户：

nano /etc/wsl.conf

加入：

[user]
default=user_name

Ctrl + O → Enter → Ctrl + X ：保存，确认，退出编辑

重启：

wsl --shutdown
wsl

请添加图片描述

7. 常见错误排查

Exec format error：可能导入的镜像架构和系统不匹配（amd64 vs arm64）
无法挂载磁盘：检查 /etc/fstab 配置，禁用挂载出错项或修正路径
WSL2 内核组件未安装或版本过低，重新安装更新包
WSL 版本确认：

wsl --list --verbose

在 Ubuntu 上安装Docker

1. 配置 Docker 官方仓库 GPG Key 和源

sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpgecho "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

2.更新

sudo apt update

3.安装Docker

 sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

4.查看

passlink@DESKTOP-VI6RFKU:/mnt/d/WSL/Ubuntu$ sudo docker info
Client: Docker Engine - CommunityVersion:    28.2.2oad.docker.com/linux/ubuntu jammy/stable amd64 docker-buildx-plugin amd64 0.24.0-1~ubuntu.22.04~jammy Context:    defaultDebug Mode: falsenload.docker.com/linux/ubuntu jammy/stable amd64 docker-ce-rootless-extras amd64 5:28.2.2-1~ubuntu.22. Plugins:[6480 kB]buildx: Docker Buildx (Docker Inc.)nux/ubuntu jammy/stable amd64 docker-compose-plugin amd64 2.36.2-1~ubuntu.22.04~jam    Version:  v0.24.0Path:     /usr/libexec/docker/cli-plugins/docker-buildx amd64 containerd.io amd64 1.7.27-1 [30.5 MB]compose: Docker Compose (Docker Inc.)Version:  v2.36.2Path:     /usr/libexec/docker/cli-plugins/docker-composeServer:Containers: 0Running: 0Paused: 0Stopped: 0Images: 0Server Version: 28.2.2Storage Driver: overlay2Backing Filesystem: extfsSupports d_type: trueUsing metacopy: falseNative Overlay Diff: trueuserxattr: falseLogging Driver: json-fileCgroup Driver: systemdCgroup Version: 2Plugins:Volume: localNetwork: bridge host ipvlan macvlan null overlayLog: awslogs fluentd gcplogs gelf journald json-file local splunk syslogCDI spec directories:/etc/cdi/var/run/cdiSwarm: inactiveRuntimes: io.containerd.runc.v2 runcDefault Runtime: runcInit Binary: docker-initcontainerd version: 05044ec0a9a75232cad458027ca83437aae3f4darunc version: v1.2.5-0-g59923efinit version: de40ad0Security Options:seccompProfile: builtincgroupnsKernel Version: 6.6.87.1-microsoft-standard-WSL2Operating System: Ubuntu 22.04.5 LTSOSType: linuxArchitecture: x86_64CPUs: 4Total Memory: 3.3GiBName: DESKTOP-VI6RFKUID: 8607a6f8-d99e-409d-9306-209ecc78eabdDocker Root Dir: /var/lib/dockerDebug Mode: falseExperimental: falseInsecure Registries:::1/128127.0.0.0/8Live Restore Enabled: false