Win11 WSL2下CentOS9-Stream保姆级安装指南：从零配置到Docker实战

Win11 WSL2下CentOS9-Stream保姆级安装指南：从零配置到Docker实战

对于需要在Windows环境下进行Linux开发的用户来说，WSL2（Windows Subsystem for Linux 2）无疑是一个革命性的工具。它允许开发者在Windows系统上运行原生的Linux二进制文件，而无需传统的虚拟机开销。本文将详细介绍如何在Win11系统中通过WSL2安装CentOS9-Stream，并完成Docker环境的配置，解决实际开发中可能遇到的各种问题。

1. 环境准备与WSL2安装

在开始安装CentOS9-Stream之前，我们需要确保Windows系统已经正确配置了WSL2环境。以下是详细的准备工作：

1. 系统要求检查：

   • Windows 11版本21H2或更高
   • 64位处理器支持二级地址转换(SLAT)
   • 至少4GB系统内存（建议8GB以上）
   • BIOS中启用虚拟化技术（Intel VT-x或AMD-V）

2. 启用Windows功能： 以管理员身份打开PowerShell，执行以下命令：

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

   执行完成后需要重启系统。

3. 设置WSL2为默认版本：

   wsl --set-default-version 2

提示：如果遇到"WSL 2 requires an update to its kernel component"错误，需要下载并安装最新的WSL2内核更新包。

2. CentOS9-Stream安装与配置

CentOS Stream作为RHEL的上游发行版，提供了更前沿的软件包和功能。在WSL2中安装CentOS9-Stream的步骤如下：

1. 获取CentOS9-Stream WSL镜像：

   • 访问官方GitHub仓库：https://github.com/mishamosher/CentOS-WSL
   • 下载CentOS9-stream.zip文件
   • 解压到指定目录（建议路径不含中文和空格）

2. 安装CentOS9-Stream：

   • 双击解压后的CentOS9-stream.exe文件
   • 等待安装完成（约1-3分钟）
   • 安装完成后会自动关闭窗口

3. 验证安装： 打开PowerShell，执行：

   wsl -l -v

   应该能看到类似输出：

   NAME STATE VERSION * CentOS9-stream Running 2

4. 初始化系统配置：

   • 设置root密码：

     passwd

   • 更新系统软件包：

     dnf update -y

3. WSL2与CentOS9-Stream系统优化

为了获得更好的开发体验，我们需要对WSL2和CentOS9-Stream进行一些优化配置：

1. 启用systemd支持： WSL2默认不启用systemd，但许多服务（如Docker）依赖它。编辑配置文件：

   vi /etc/wsl.conf

   添加以下内容：

   [boot] systemd=true

   保存后退出WSL，在PowerShell中执行：

   wsl --shutdown

   然后重新启动WSL。

2. 网络配置优化： WSL2使用虚拟网络，IP地址会变化。可以配置静态主机名解析：

   echo "$(hostname -I | awk '{print $1}') $(hostname)" | sudo tee -a /etc/hosts

3. 性能调优：

   • 在Windows用户目录下创建.wslconfig文件，内容如下：

     [wsl2] memory=4GB processors=2 swap=2GB

   • 这会将WSL2内存限制为4GB，使用2个CPU核心

4. Docker环境安装与配置

Docker是现代开发不可或缺的工具，在WSL2中安装Docker需要特别注意以下几点：

1. 安装必要工具：

   dnf install -y wget yum-utils device-mapper-persistent-data lvm2

2. 添加Docker CE仓库：

   yum-config-manager --add-repo https://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo

3. 安装Docker组件：

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

4. 配置Docker服务：

   • 启动Docker并设置开机自启：

     systemctl start docker systemctl enable docker

   • 验证安装：

     docker run hello-world

5. 镜像加速配置： 创建或修改/etc/docker/daemon.json：

   { "registry-mirrors": [ "https://registry.docker-cn.com", "https://docker.mirrors.ustc.edu.cn" ] }

   然后重启Docker服务：

   systemctl restart docker

5. 常见问题与解决方案

在实际使用过程中，可能会遇到以下问题：

1. Docker命令报错"Got permission denied"：

   sudo groupadd docker sudo usermod -aG docker $USER newgrp docker

2. WSL2内存占用过高：

   • 定期清理Docker资源：

     docker system prune -f

   • 限制WSL2内存使用（通过.wslconfig文件）

3. 网络连接问题：

   • 检查Windows防火墙设置
   • 重置WSL网络：

     wsl --shutdown netsh winsock reset

4. 文件系统性能优化：

   • 避免在Windows文件系统中直接操作Linux文件
   • 将项目代码放在WSL2文件系统内（/home/目录下）

6. 开发环境进阶配置

为了打造更完善的开发环境，可以考虑以下额外配置：

1. SSH服务配置：

   • 安装OpenSSH服务器：

     dnf install -y openssh-server

   • 修改SSH配置允许root登录：

     sed -i 's/#PermitRootLogin prohibit-password/PermitRootLogin yes/' /etc/ssh/sshd_config

   • 启动SSH服务：

     systemctl start sshd systemctl enable sshd

2. 开发工具安装：

   • 基础开发工具：

     dnf groupinstall -y "Development Tools"

   • 常用工具：

     dnf install -y git vim zsh curl wget net-tools

3. Zsh与Oh-My-Zsh配置：

   dnf install -y zsh sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"

4. GUI应用支持（可选）：

   • 安装X服务器（如VcXsrv）
   • 配置DISPLAY环境变量：

     echo "export DISPLAY=$(cat /etc/resolv.conf | grep nameserver | awk '{print $2}'):0" >> ~/.bashrc

在实际项目中，我发现将WSL2与VS Code配合使用能极大提升开发效率。通过安装"Remote - WSL"扩展，可以直接在Windows上的VS Code中编辑WSL中的文件，同时利用WSL中的工具链进行构建和调试。这种组合既保留了Windows的易用性，又获得了Linux开发环境的强大功能。