跳至主要內容

从 WSL 到 Cloudflare (一)：WSL 安装与配置

Vyrrth2025年2月19日大约 8 分钟安装配置与踩坑wsllinux

从 WSL 到 Cloudflare (一)：WSL 安装与配置

WSL安装与配置本人亲自踩坑指南

注意

如果在某一方法上失败,不要死磕!
可以及时换用另一种方法尝试。
你也可以在遇到问题时查阅官方文档以获取更详细的支持

一、启用WSL功能

有两个方法可供使用,任选其一即可

  1. 方法一 推荐

    1. 按下 win+S 打开搜索框搜索Terminal,在匹配项上右键选择 以管理员身份运行 。
    2. 启用 Windows 子系统（WSL）功能
      dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
    3. 启用虚拟机平台功能
      WSL2 依赖 Windows 虚拟机功能，需要额外启用：
      dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
    4. 检查WSL状态
      wsl --version
    5. (可选) 更新WSL
      尝试将WSL更新到最新版本以避免可能存在的问题
      wsl --update
    6. 设WSL版本为2
      Windows 11默认版本为2,不需要设置。
      wsl --set-default-version 2

  2. 方法二：Windows GUI 手动安装 WSL2

    1. 按下 Win + R 组合键，输入命令appwiz.cpl，然后点击 确定 或直接按 Enter。

    2. 进入 程序和功能 界面，点击 启用或关闭 Windows 功能。

    3. 启用 WSL 和虚拟机平台
      找到并勾选以下两项，然后点击 确定 ，系统将开始应用更改。随后会弹出提示要求重启计算机，点击 立即重新启动(N) 以完成设置。

      • 适用于 Linux 的 Windows 子系统
      • 虚拟机平台 / Windows 虚拟机监控程序平台

      如果你使用的是 Windows 11，还需要勾选：

      • Windows Hypervisor Platform（有些系统可能没有）
      • Hyper-V（如果你的 Windows 版本支持）

    4. 参照方法一检查WSL状态,将WSL版本设置为2

注意

如果你尝试本方法不成功,说明可能要把windodws版本升级到企业版,点击此链接查看如何升级

二、安装WSL发行版

  • 选择1: 直接使用命令和安装 推荐

    1. 列出当前电脑中已安装的发行版和运行状态
      稍后管理子系统的时候可以用这条命令
      这时候应该显示没有发行版
      wsl -l -v
    2. 列出可以安装的发行版列表
    wsl --list --online

    提示

    建议选择Ubuntu-20.04, 此版本作为长期支持版本, 对于WSL的兼容性较好。
    如果你在安装这个版本或者其他版本时出现了问题, 也可以多尝试换用几种不同的发行版。
    如果要删除当前的发行版请用命令 wsl --unregister <发行版全称(注意大小写)>

    1. 安装指定的发行版
    wsl --install -d <发行版全称(注意大小写)>

    直接进入到 设置用户名步骤 说明安装成功,请直接跳转到 三、配置WSL
    如果在上面安装中遇到问题，建议使用梯子，或以下方法2

  1. 使用镜像本地安装

    1. 在您的电脑上下载 Ubuntu.tar.wsl 镜像文件（此链接直接从官方存储库下载 Ubuntu 镜像）

    2. 在 Windows 11 上打开开始菜单。

    3. 搜索 "命令提示符"，右键单击顶部结果，然后选择 "以管理员身份运行" 选项。

    4. 打开包含下载文件的目录，按住 shift 同时右键，菜单中选中 Open in Terminal,键入以下命令以在 Windows 11 上安装

    wsl --install --from-file Ubuntu2404-250130_x64.wsl

  2. 使用Microsoft Store安装

    参见官方链接

    如果没有Microsoft Store，可以采用这个方法

三、配置WSL

  1. 请正常设置自己喜欢的用户名和密码
    用户名请使用全英文不要添加特殊字符

    tips: 密码在输入的时候并不会显示出来,看起来好像并没有输入一样,这是loader系统输入密码的正常现象,直接输入后回车即可。

  2. 设置root账户密码

    sudo passwd root

    然后需要先输入自己刚刚设置的用户密码,再重复设置两次管理员密码。
    两个密码一个是自己账户的密码, 一个是管理员账户的密码

    tips: 建议两个密码设置为相同密码，避免遗忘。
    然后你可以使用 su - 登录进入管理员账户，使用 exit退出。

  3. 配置网络设置

    1. 使用 exit 退出WSL。
      tips：这只会断开你和WSL的运行的连接，WSL仍在后台运行。

    2. 然后使用下面的命令关闭WSL

    // 这会关闭特定的发行版
wsl -t <发行版全称(注意大小写)>

// 这会关闭所有的发行版
wsl --shutdown

// 使用下面的命令观察WSL是否被关闭
wsl -l -v
    1. 退出wsl后在命令行输入
    notepad.exe "$env:USERPROFILE\.wslconfig"
    1. 选择 建立新文件 , 在文件里写入
    [wsl2]
networkingMode=mirrored
dnsTunneling=true
autoProxy=true
firewall=false
[experimental]
hostAddressLoopback=true

    按 ctrl+S 保存后，关闭记事本

    1. 在命令行中使用下面的命令重新进入WSL
    wsl -d <发行版全称(注意大小写)>

    使用 curl baidu.con 检测是否网络连接成功 (不要使用ping)
    如果带有HTML的输出说明结果正确。

    注意

    如果没有对应的输出,请检查前面的过程中是否保存了设置文件,
    或者你可以尝试修改wsl.conf,或者更换一个发行版尝试,
    你可以在这里和这里查阅到更多与网络配置有关的信息。

  4. 更新软件包

    1. 更换为国内源

    提示

    如果你有梯子，请打开TA, 让后使用上面提到的命令彻底关闭WSL，再重新启动。
    这样WSL也会共享梯子，不需要换源，可以直接跳到第二步。

    使用以下命令更新为国内源

    //请先使用`lsb_release -a`查看系统版本

// 大于等于 Debian 12 or Ubuntu 24.04 用这个
sudo sed -i 's@//.*archive.ubuntu.com@//mirrors.ustc.edu.cn@g' /etc/apt/sources.list

// 否则用这个
sudo sed -i 's@//.*archive.ubuntu.com@//mirrors.ustc.edu.cn@g' /etc/apt/sources.list
    1. 更新
    sudo apt update && sudo apt upgrade
    1. 然后就能安装你想要的软件包了！

  5. 将WSL系统从C盘移动到其他位置

    //执行操作后等待十秒左右确保WSL关机完成
wsl --shutdown

//将路径替换为你想转移的路径
//该路径所在的文件夹必须还未创建,不能使用已存在的文件夹
wsl --manage <发行版名称> --move <要转移的绝对路径>

  6. 自定义配置
    windows还为WSL提供了许多配置选项，如果您有需要可以查阅此链接
    配置Windows文件的挂载路径进入系统的默认用户等等其他配置。
    你也可以同时查阅官方文档下的其他指南。

VScode配置

提示

下面的教程默认你知道linux的相关基本命令,如ls,mkdir,cd等。

  1. 在电脑端安装VS code，安装过程中勾选添加到PATH

  2. WSL中新建项目文件夹 or 复制项目文件夹WSL or 在WSL中CD到项目文件夹目录

  3. cd到项目文件夹下，尝试使用以下代码,运行时请保证使用的用户不是root用户。
    直接运行命令,不要使用apt install code安装

    code .
    • 情况一: 提示没有找到 code 命令
      这种情况的原因是在安装时没有配置系统环境变量, ,可以通过下面的方式修复
      1. 找到自己Windows端的vsdode路径（可以自行上网搜寻如何查找），例如我的路径是：D:\Software\Microsoft VS Code
      2. 在目录中找到 bin 文件夹,进入后里面有code文件(没有后缀名), 由此构成文件完整的路径：D:\Software\Microsoft VS Code\bin\code
      3. 将路径中所有的\转换为/,D:(参照你自己的驱动器)修改为 /mnt/d结果为: /mnt/d/Software/Microsoft VS Code/bin/code
      4. 在路径前所有的空格的前面加上反斜杠，结果为 /mnt/d/Software/Microsoft\ VS\ Code/bin/code
      5. 输入命令(其中的路径请替换为你刚才得到的自己的路径)
      echo "alias code='/mnt/d/Software/Microsoft\ VS\ Code/bin/code'" >> ~/.bashrc
      • 退出WSL重新进入即可
        tips：该方法是对linux设置别名，如果在设置过程中遇到问题，可以查阅网络的了解相关信息
    • 情况二：下载速度过慢或者下载失败
      这个下载内容是从GitHub上拉取，所以说在gihub连接不好时有一定概率失败，可以等到能够访问github.com网址的时候再进行这个操作，或者使用梯子。
    • 情况三：能够打开Windows端的程序但是连接失败
      现在网络上搜索相关答案，如果不成功的话，建议删除整个WSL发行版之后重新安装 or 换一个版本尝试
Powered by VuePress
Copyright © 2025 Vyrrth