在WSL上安装Rocky Linux的详细步骤

这是一份基于 Rocky Linux 官方最新文档的 WSL 安装详细方案。在 Rocky Linux 9.6+ 版本中，官方开始提供 .wsl 格式镜像，使得安装过程更加便捷。

准备工作：开启 Windows WSL 功能

在安装任何 Linux 发行版前，需要先在 Windows 上启用 WSL 功能。

1. 以管理员身份打开 PowerShell 或 命令提示符。

2. 执行以下命令，这会自动安装 WSL 所需的所有组件，并将默认版本设置为 WSL 2。

   #powershell
   
   wsl --install

3. 重启电脑，让更改生效。

4. 重启后，建议更新 WSL 内核以确保兼容性，再次打开终端并运行：

   #powershell
   
   wsl --update

方法一：使用官方 .wsl 镜像安装（强烈推荐）

从 Rocky Linux 9.6 版本开始，官方提供了开箱即用的 .wsl 镜像，这是最简单、最推荐的方式。

1. 下载镜像文件

   • 访问 Rocky Linux 官方文档或下载页面，找到最新的 WSL 镜像。

   • 根据你的电脑架构（x86_64 或 aarch64）下载 .wsl 文件（例如 Rocky-10-WSL-Base.latest.x86_64.wsl）。

2. 安装镜像

   • 最简方式：直接双击你下载好的 .wsl 文件，系统便会自动安装。

   • 命令行方式（更灵活）：在终端中执行以下命令，可以为你的系统自定义一个名字：

     #powershell
     
     wsl --install --from-file <文件路径\文件名.wsl> --name <你的系统名称>

3. 首次启动与配置

   • 安装完成后，在终端输入 wsl -d <你的系统名称> 即可启动。

   • 此镜像集成了 systemd，并且首次启动时会提示你创建一个默认的非 root 用户名和密码。

方法二：手动导入 RootFS 文件（更通用）

如果你想使用旧版本或特定的 RootFS 压缩包（如 .tar.xz 文件），可以手动导入。

1. 下载 RootFS 文件

   • 从 Rocky Linux 的官方镜像站或 GitHub 发布页，下载适合 WSL 的 RootFS 文件（通常是 Rocky-9-Container-Base.latest.x86_64.tar.xz 格式）。

2. 决定安装位置

   • 在 Windows 上创建一个文件夹用于存放这个发行版的数据，例如 C:\WSL\RockyLinux。

3. 执行导入命令

   • 在终端中执行以下命令，将下载的 RootFS 文件导入到 WSL：

     #powershell
     
     wsl --import RockyLinux C:\WSL\RockyLinux <下载文件存放路径\rocky-linux-rootfs.tar.xz> --version 2

   • 这条命令会创建一个名为 RockyLinux 的 WSL 实例，--version 2 表示使用性能更佳的 WSL 2 后端。

4. （可选）设置默认用户

   • 通过 wsl --import 导入的系统默认会以 root 用户登录。为方便日常使用，可以创建一个默认用户。

   • 首先进入 Rocky Linux 环境创建用户并赋予 sudo 权限：

     # 以 root 身份启动
     wsl -d RockyLinux -u root
     # 创建新用户（例如 'myuser'）并设置密码
     useradd -m myuser
     passwd myuser
     # 赋予该用户 sudo 权限
     usermod -aG wheel myuser
     exit

   • 在 PowerShell 中，设置该用户为默认登录用户：

     #powershell
     
     RockyLinux config --default-user myuser

安装后的建议操作

完成安装后，首次进入系统，可以进行一些基础配置。

1. 更新系统

   sudo dnf update -y

2. 安装常用工具

   sudo dnf install -y vim git curl wget

3. 确认 systemd 状态
   使用官方 .wsl 镜像安装的版本已默认启用 systemd。如果手动导入的镜像未启用，可以在 /etc/wsl.conf 文件中添加 systemd=true 来开启。

WSL专用优化配置

1. 配置wsl.conf文件（核心优化）

在Rocky Linux内部创建或编辑/etc/wsl.conf文件，这是WSL专用的配置，用于控制挂载、网络、系统参数等行为。

sudo tee /etc/wsl.conf << 'EOF'
[automount]
# 自动挂载Windows盘符到/mnt/下
enabled = true
# 挂载时使用Windows的元数据（支持文件权限）
options = "metadata,umask=22,fmask=11"
# 不自动挂载所有盘符（加速启动）
mountFsTab = false

[network]
# 生成统一的主机名（避免重启后变化）
generateHosts = true
generateResolvConf = true

[interop]
# 允许从Linux调用Windows命令
enabled = true
# 允许Windows命令继承Linux环境变量
appendWindowsPath = true

[systemd]
# 启用systemd（官方.wsl镜像已默认启用）
systemd = true
EOF

保存后，需要在PowerShell中重启WSL实例使配置生效：

#powershell

wsl --shutdown
wsl -d RockyLinux

2. 调整内存和CPU限制（可选）

在Windows用户目录（%UserProfile%）下创建或编辑.wslconfig文件，可以限制WSL使用的资源：

#powershell

# 在PowerShell中执行
notepad "$env:USERPROFILE\.wslconfig"

粘贴以下内容（按需调整）：

ini

[wsl2]
# 限制最大内存使用（例如4GB）
memory=4GB
# 限制CPU核心数（例如使用4核）
processors=4
# 启用swap并设置大小（改善内存不足时的稳定性）
swap=2GB
# swap文件存放位置
swapFile=C:\WSL\swap.vhdx
# 启用对Windows端口转发的支持
localhostForwarding=true

开发环境搭建（以Web开发为例）

1. 安装Node.js（使用NVM管理多版本）

# 安装NVM
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash

# 重启终端或执行以下命令使nvm生效
source ~/.bashrc

# 安装最新的LTS版本
nvm install --lts

# 验证
node --version
npm --version

2. 安装Python（系统已自带，但可安装开发工具）

sudo dnf install -y python3-pip python3-devel
pip3 install --upgrade pip

3. 安装Docker（在WSL中推荐使用Docker Desktop集成）

在WSL环境中，更推荐使用Windows上的Docker Desktop，并启用WSL 2后端，让容器直接在WSL中运行。

• 在Windows上下载并安装Docker Desktop

• 在设置中启用"Use WSL 2 based engine"

• 在"Resources" -> "WSL Integration"中，启用你的Rocky Linux实例

然后在Rocky Linux中即可直接使用docker命令：

docker --version
docker run hello-world

文件系统性能优化

WSL 2的跨文件系统操作（如/mnt/c/与/home/之间）性能较低。建议：

1. 代码项目存放在Linux文件系统内（即/home/youruser/下），而非/mnt/c/。

2. 通过\\wsl.localhost\RockyLinux\home\youruser在Windows文件资源管理器中直接访问Linux文件。

常见问题排查