在 Windows 中配置 WSL2 与 Debian 的全流程

  • 在 Windows 中配置 WSL2 与 Debian 的全流程已关闭评论
  • 59 次浏览
  • A+
所属分类:linux技术
摘要

ref:
How to Install WSL2 on Windows 10 (Updated) – visited on 2024-01-09
Microsoft – 如何使用 WSL 在 Windows 上安装 Linux – visited on 2024-01-09
清华大学开源软件镜像站 – Debian 软件源 – visited on 2024-01-09
Arch Wiki: Font configuration – visited on 2024-01-15
Arch Wiki: Input Method – visited on 2024-01-16


在 Windows 中配置 WSL2 与 Debian 的全流程

ref:
How to Install WSL2 on Windows 10 (Updated) - visited on 2024-01-09
Microsoft - 如何使用 WSL 在 Windows 上安装 Linux - visited on 2024-01-09
清华大学开源软件镜像站 - Debian 软件源 - visited on 2024-01-09
Arch Wiki: Font configuration - visited on 2024-01-15
Arch Wiki: Input Method - visited on 2024-01-16


这篇文章记录了我在 Windows 10 上配置 WSL2 与 Debian 的全部流程与参考资料。希望对困扰于 WSL 相关问题的读者提供些许帮助。

谢绝转载。

Step1: 确认 Windows 版本

确认 Windows 版本为 Windows 10 版本 大于等于 2004 (内部版本 大于等于 19041) 或 Windows 11。

  1. 以管理员运行 PowerShell

  2. 输入 [System.Environment]::OSVersion.Version

    Windows PowerShell Copyright (C) Microsoft Corporation. All rights reserved.  Try the new cross-platform PowerShell https://aka.ms/pscore6  PS C:Windowssystem32> [System.Environment]::OSVersion.Version  Major  Minor  Build  Revision -----  -----  -----  -------- 10     0      19045  0 
  3. 确认版本与 Build 符合要求。

Step2: 开启与 WSL 相关的 Windows Features

接下来,需要开启 Windows Subsystem Linux 和 Virtual Machine Platform 并重启 Windows。

  1. 以管理员运行 PowerShell

  2. 输入下述指令启动 WSL:

    dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart 
    PS C:Windowssystem32> dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart  Deployment Image Servicing and Management tool Version: 10.0.19041.3636  Image Version: 10.0.19045.3803  Enabling feature(s) [==========================100.0%==========================] The operation completed successfully. 
  3. 输入下述指令启动 VM Platform:

    Enable-WindowsOptionalFeature -Online -FeatureName VirtualMachinePlatform -NoRestart 
    PS C:Windowssystem32> Enable-WindowsOptionalFeature -Online -FeatureName VirtualMachinePlatform -NoRestart WARNING: Restart is suppressed because NoRestart is specified.   Path          : Online        : True RestartNeeded : True 
  4. 重启 Windows。

Step3: 安装 WSL 并设置版本

这一步里,安装 WSL 并设置版本.

  1. 以管理员运行 PowerShell

  2. 输入下述指令安装 WSL:

    wsl --install 

    wsl --install --no-distribution 

    在我的 Windows 版本下,wsl --install 不会安装 Ubuntu, 但根据 Microsoft 的文档,某些版本下默认会安装 Ubuntu。

  3. 重启 Windows

  4. 安装完成后设置 WSL 版本为 WSL2

    wsl --set-default-version 2 
  5. 输入下述指令确认 wsl 版本:

    wsl --version 
    PS C:Windowssystem32> wsl --version WSL version: 2.0.9.0 Kernel version: 5.15.133.1-1 WSLg version: 1.0.59 MSRDC version: 1.2.4677 Direct3D version: 1.611.1-81528511 DXCore version: 10.0.25131.1002-220531-1700.rs-onecore-base2-hyp Windows version: 10.0.19045.3803 

Step4: 下载并安装 Debian

在 Microsoft Store 中安装 Debian。

  1. 打开 Microsoft Store
  2. 安装 Debian
  3. 安装完成后打开 Debian
  4. 第一次进入 Debian 会要求设置用户名和密码。

小结

至此,Debian已经安装完成,打开即可使用 CLI 来操作了。不过,想要使用带GUI的软件,或是中文,我们还需要完成几件事:

  1. 配置 国内镜像源
  2. 配置 GUI 用来打开软件
  3. 配置 中文字体 与 输入法

Step5: 配置 国内镜像源

国内镜像源很多,这里选择清华的镜像源。

  1. 打开并登录 WSL - Debian

  2. 将原有文件设置备份

    sudo mv ~/etc/apt/sources.list ~/etc/apt/sources.list.backup 
  3. 创建新的 ~/etc/apt/sources.list

    sudo touch ~/etc/apt/sources.list 
  4. 在新的 sources.list 中输入:

    deb http://mirrors.tuna.tsinghua.edu.cn/debian/ bookworm main contrib non-free non-free-firmware deb-src http://mirrors.tuna.tsinghua.edu.cn/debian/ bookworm main contrib non-free non-free-firmware  deb http://mirrors.tuna.tsinghua.edu.cn/debian/ bookworm-updates main contrib non-free non-free-firmware deb-src http://mirrors.tuna.tsinghua.edu.cn/debian/ bookworm-updates main contrib non-free non-free-firmware  deb http://mirrors.tuna.tsinghua.edu.cn/debian/ bookworm-backports main contrib non-free non-free-firmware deb-src http://mirrors.tuna.tsinghua.edu.cn/debian/ bookworm-backports main contrib non-free non-free-firmware  deb http://mirrors.tuna.tsinghua.edu.cn/debian-security bookworm-security main contrib non-free non-free-firmware deb-src http://mirrors.tuna.tsinghua.edu.cn/debian-security bookworm-security main contrib non-free non-free-firmware 
  5. Debian CLI 中输入下述代码更新 Debian 软件

    sudo apt update -y && sudo apt upgrade -y 
  6. Debian CLI 中输入下述代码安装 镜像站 https 证书

    sudo apt install apt-transport-https ca-certificates 
  7. ~/etc/apt/sources.list 中,将所有的 http:// 改成 https://

至此,国内镜像站配置完成。

Step6: 配置 GUI

这一步,在 Windows 上安装并运行 X server,并配置 WSL2 中的 Debian 使用 X server 运行需要 GUI 的软件。

  1. source forge 上下载 VcXsrv Windows X Server

  2. 安装 VcXsrv 并运行 XLaunch

  3. 在 XLaunch 的 Select display settings 中,将 Display number 改为 0

  4. 在 XLaunch 的 Extra Settings 中,勾选 Disable access control 选项

  5. 在 XLaunch 的 Configuration complete 界面,点击 Save configuration 来保存设置,下次通过保存的文件启动即可。

  6. 打开 WSL2 Debian (以后每次启动WSL2 Debian之前都需要打开 XLaunch,否则GUI软件无法运作。)

  7. 在 ~/.bashrc 中加入下述代码并保存后退出:

    # Setting DISPLAY pointing to the X server on Windows export DISPLAY=:0 
  8. 在 Debian CLI 中 source ~/.bashrc

至此,如果 Debian 安装了 firefox-esr,X Server 会在 Windows 新开一个窗口并运行 firefox-esr。

**Note: ** WSL2 更新速度跟不上一些软件,导致WSL不能完美支持一些软件的最新版本,如 firefox-esr。

Step7: 配置中文字体

默认的 Debian 为英文环境,我们需要配置中文环境与相关的管理软件。

  1. 检查是否安装语言环境管理包 locales、字体管理包 fontconfigs

    apt list --installed | grep locales apt list --installed | grep fontconfigs 
  2. 若没有locales,则安装 :

    sudo apt-get install locales 

    在 Debian CLI 中配置 locales

    sudo dpkg-reconfigure locales 

    配置界面中,上下左右为移动键,空格为选择键,回车为确认键

    需要选择 en_US.utf8zh_CN.utf8

    默认 localesen_US.utf8 (默认自行选择即可)

    .bashrc 中加入下列代码使 CLI 支持中文字符:

    export LC_ALL=en_US.UTF-8 export LANGUAGE=en_US.UTF-8 

    在 CLI 中 source .bashrc 后,输入 locale 确认 LC_ALLLANGUAGELC_ALL 都设置成 en_US.UTF-8:

 $ locale LANG=en_US.UTF-8 LANGUAGE=en_US.UTF-8 LC_CTYPE="en_US.UTF-8" LC_NUMERIC="en_US.UTF-8" LC_TIME="en_US.UTF-8" LC_COLLATE="en_US.UTF-8" LC_MONETARY="en_US.UTF-8" LC_MESSAGES="en_US.UTF-8" LC_PAPER="en_US.UTF-8" LC_NAME="en_US.UTF-8" LC_ADDRESS="en_US.UTF-8" LC_TELEPHONE="en_US.UTF-8" LC_MEASUREMENT="en_US.UTF-8" LC_IDENTIFICATION="en_US.UTF-8" LC_ALL=en_US.UTF-8             
  1. 配置 fontconfigs,启用bitmap (可略过此步骤):

    sudo dpkg-reconfigure fontconfig-config 

    在 preferred method for tuning fonts 中,选择 Autohinter (Native/Autohinter/None)

    在 preferred automatic font hinting styple 中,选择 Medium (None/Slight/Medium/Full)

    在 subpixel rendering 中,选择 Automatic (Automatic/Always/Never)

    在 enable bitmapped fonts by default 中,选择 Yes (Yes/No)

  2. 安装可直接通过 apt 管理的常用字体:

     sudo apt-get install <FONTPACKAGE_NAME>  # Common monospace font fonts-jetbrains-mono  fonts-hack # Common english fonts fonts-liberation2  # Common Chinese fonts *fonts-wqy* *fonts-arphic*  sudo apt-get install xfonts-intl-chinese 

至此,打开其他带有中文 GUI 的软件,中文可以正常显示。

Step8:配置中文输入法

  1. 检查常见的 IMF(Input-Method Framework) 是否存在。

    apt list --installed | grep ibus apt list --installed | grep fcitx 

    若不存在则安装喜欢的IMF。我选择了 iBus。

    sudo apt-get install ibus 
  2. 确认 dbus (desktop bus) 是否安装

    apt list --installed | grep dbus 

    若不存在则安装 dbus-x11

    sudo apt-get install dbus-x11 
  3. 安装基于对应 IMF 的 IME(Input-Method Editor),我选择了 ibus-pinyin

    sudo apt-get install ibus-pinyin 
  4. 配置iBus,自己喜欢就好。

    ibus-setup 
  5. 修改 ~/.bashrc, 添加下列变量:

    export GTK_IM_MODULE=ibus export QT_IM_MODULE=ibus export XMODIFIERS=@im=ibus 
  6. 之后在 CLI 或者 firefox 等GUI页面中就可以使用中文输入法输入中文了。

    值得注意的是,WSL2打开的CLI terminal是无法显示中文(可以输入,但无法显示)的,想在 terminal 中使用中文,需要用支持 UTF-8 的 terminal emulator 才行。

    我自己测试时发现每次进入 debian 时 ibus 都已经启动了,可能在 ibus-setup 中自动设置了吧。

总结

至此,在windows中配置 WSL2 与 Debian 的全部流程就结束了。现在的 Debian 有了国内的镜像源、GUI、中文字体与输入法,可以的在Debian上做自己其他想做的事情了。

祝好。