Tag: Wsl | Sparkle的个人博客

## 为什么Windows不适合作为开发使用？

对于我个人的前端开发体验而言，主要在这几个方面：

* 利用Node.js实现一些自动化功能，代码内经常混入一些Windows无法运行的bash命令；
* Windows下一般不只有开发环境，还会安装一些其他的软件、游戏等等，相互影响；
* 部分库没有做`cross-env`兼容，在Windows下执行会有意料之外的bug；
* Windows的目录结构在实际使用时会有意料之外的问题；

因此，WSL是在Windows下进行开发更好的选择。

> 截止本文编写时，我仍不建议使用WSL2的版本，会给开发带来一些不必要的困扰，稳定后再体验。

## 开启WSL

有关于如何在Windows下开启WSL功能，很多文章在一年前都进行了说明。在当前版本号1909下，只需要注意以下几点：

1. 可以正常使用Microsoft Store（也支持利用zip包安装，具体详见[官方文档](https://docs.microsoft.com/en-us/windows/wsl/install-manual)）；
2. 开启“适用于Linux的Windows子系统”，设置路径在：控制面板\程序\程序和功能 -> 左侧“启用或关闭Windows功能”，这一步骤需要进行重启使得更改生效；

## 安装

安装比较简单，利用Microsoft Store搜索“Linux”，选择你喜欢的版本进行安装即可。

> 安装会默认安装至C盘，如果你的C盘容量非常“宝贵”，建议使用[LxRunOffline](https://github.com/DDoSolitary/LxRunOffline)工具进行迁移，这个工具还可以进行管理等等功能，有兴趣的可以研究一下。我们下载它的Release并在Windows下解压到合适的目录下，利用PowerShell环境运行exe即可执行相关命令。

等待下载完成后启动，需要等待一些时间，系统会自动对你选择的Linux发行版进行配置和初始化，输入你的用户名密码即可开始使用。

## 配置

配置上正常先将系统自带的各种包更新升级`sudo apt update && sudo apt upgrade`

### ProxyChains

由于WSL使用的是父主机（即Windows系统）的网络环境，因此在WSL环境下，部分软件安装配置时，会存在无法访问的情况（例如Github Release的文件分发地址……），强烈建议先配置[ProxyChains-NG](https://github.com/rofl0r/proxychains-ng)，可以选择手工下载源码make安装，也可以利用包管理器（目前包管理器版本较低，为3.x版本，仓库目前已经到了4.x版本，如果有能力建议使用源码安装，我使用的Ubuntu-18.04版本需要安装make与gcc包），`sudo apt install proxychains`进行安装，这里不赘述。

> 2022年10月，再次从包管理安装`apt-get install proxychains-ng`已经可以安装v4版本的proxychains了

安装好后在`/etc`目录下编辑（如果是源码安装，这里是创建）`proxychains.conf`文件，在文件内写入配置信息：

```bash
[ProxyList]
# add proxy here ...
# meanwile
# defaults set to "tor"
socks5 127.0.0.1 1080
```

在配置完成后，运行命令前带有`proxychains`即可通过代理，例如如下命令即可测试是否成功应用代理：

```bash
proxychains curl myip.ipip.net
```

如果显示代理，即配置成功。

### Node.js & NPM

这里其实没什么需要详细说明的，和我们在服务器环境配置Node.js同理。

> 在官网的角落可以找到一个相对隐蔽的Node源地址，配置后可以直接通过包管理器快捷安装Node，相比于二进制与源码安装更为简单，其[仓库地址](https://github.com/nodesource/distributions)

这里我遇到了Bug，在配置WSL环境前，我没有移除Windows下的Node环境，在完成了上述安装步骤后，`npm -v`提示“Unable to correct problems, you have held broken packages.”，看到对应报错地址指向了`/mnt/c`下的node目录时，明白了npm命令是调用了Windows环境下的npm，因此，卸载Windows下的nvm(**请通过“控制面板”内的软件功能进行卸载**)与Node.js后，移除WSL内已安装的Node.js并重新安装，一切正常工作，完美。

### Oh my Zsh

前文提到过，curl和wget目前都可以通过proxychains进行代理，这里其实没有太大的困难，但是，考虑到可能的DNS污染相关，这里我把官方的curl地址修改为`sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"`并使用代理，安装成功。

> 如果提示SSL相关问题，wget下可以通过`wget --no-check-certificate`临时关闭SSL检查。

这里我还遇到了一个无法连接的问题，我在安装的时候提示我`raw.githubusercontent.com`指向了0.0.0.0，查找[相关issue](https://github.com/microsoft/WSL/issues/3761)，执行以下命令查询是否有相关的软件控制网络或代理，检查发现我的“火绒”影响了，临时退出即可。

```bash
powershell.exe "Get-CimInstance -Namespace root/SecurityCenter2 -ClassName AntivirusProduct" | grep displayName
```

### SSH

配置WSL的git环境需要对应的SSH-key，按照正常的方法，可以生成，但是无法复制出来，**WSL具有可以直接执行Windows环境exe程序的特性**，因此可以通过`cat ~/.ssh/id_rsa | clip.exe`直接复制出来。

然而生成的key无法被Github识别，提示“key is invalid”，查阅得到[这个结果](https://stackoverflow.com/questions/47859437/windows-10-openssh-key-invalid-format)，虽然并不是完全一致的问题，但是提供了思路，将SSH生成的命令修改，删除指定长度“4096”的设置（-b 指定密钥长度。对于RSA密钥，最小要求768位，默认是2048位。DSA密钥必须恰好是1024位(FIPS 186-2 标准的要求)。）

```bash
ssh-keygen -t rsa -C "your_email@example.com"
```

配置到Github，成功。

## 卸载与导出

如果之后不再需要WSL环境，可以通过如下命令进行卸载：

```bash
wslconfig /unregister <wslconfig /list得到的对应名称>
```

额外的，建议将对应的UWP程序同时右键卸载进行彻底移除。

如果希望备份迁移，可以使用前文提到过的LxRunOffline工具进行处理，可以参考项目的Readme进行操作。

利用WSL在Windows下获得更好的开发体验

### WSL 是什么？

Windows Subsystem of Linux, 属于在Windows内加载的旁系统。WSL1与WSL2的实现不一致，WSL2更像是一个系统内的虚拟机，而WSL1是通过兼容层实现了类似与Linux的运行环境，如果涉及底层的一些操作或者命令则不存在。

更详细的对比请参阅: [Comparing WSL 1 and WSL 2
](https://docs.microsoft.com/en-us/windows/wsl/compare-versions)

### 对于前端同学的选择

我的需要最基本的有：可接受的文件io，Node.js，npm/yarn，容器（运行本地Debug环境）。

那么如上的需求，可以考虑WSL1+WSL2的搭配方案，即需要容器的环境使用WSL2挂载项目文件夹进行执行，否则则在WSL1内正常使用Node开发。

> 如果你能接受 __【挂载盘】较慢的io速度__ 以及 __每次需要现查的主机/WSL2 IP地址__ ，那么可以只使用一个WSL2环境。

### WSL快速配置

> 官方旧版安装指南 [Windows Subsystem for Linux Installation Guide for Windows 10](https://docs.microsoft.com/en-us/windows/wsl/install-manual)

> 2021-12-01 官方文档更新了，这个步骤不是很清晰，补充几个关键命令……

```powershell
wsl --install -d Debian # -d <DistributeName>
# 安装完毕后关闭WSL窗口，直接开始导出
wsl --export Debian C:\Debian.tar
wsl --import Debian-WSL1 <SomePathToDir> C:\Debian.tar
wsl --import Debian-WSL2 <SomePathToDir2> C:\Debian.tar
wsl --unregister Debian # 删除原来安装的默认版本
wsl --set-default Debian-WSL1 # 设置WSL1为默认版本
wsl --set-version Debian-WSL2 2 # 将其中一个版本转换为WSL2
```

这里我使用 Manual Installation，同时开启WSL2所需的Features，并安装Linux kernel update package。截止至Step4。

我选择不将所有WSL版本都设置为2，即不设置默认使用版本2。

这时安装的WSL即为一代，选择你希望安装的distribution，我这里选择的Debian。

正常安装并在内部配置好所需的开发工具后，将WSL1导出一份用来生成WSL2。

### 配置Node.js环境

前文赘述了不少关于npm的问题，其实根治的方案就是选择一个node版本控制工具，比如nvm，它会将不同版本的包管理在一个有权限的子目录内，“根本上”避免了权限问题。

> 这里我选择的nvm，官方Guide [Readme](https://github.com/nvm-sh/nvm#installing-and-updating)

安装好nvm并使用nvm安装Node.js以及其他工具如yarn等工具后，我们就可以开启“平行宇宙”，将环境一分为二了。

> Yarn (classic) 目前推荐的安装方案：`npm install -g yarn`

> "开启“平行宇宙”，将环境一分为二"的梗来自于Marvel的"What If..." 04，古一将Doctor Strange一分为二，使得同一时间线内有了两个Doctor Strange。

### 切分环境

打开PowerShell，确保容器目前处于关闭状态。

> 手工关闭，`wsl --shutdown`

首先需要把已有的导出为一个档案文件，

```cmd
wsl --export <DistributionName> <FileName>
```

导出后，再使用import进行导入，这里可以指定安装位置，因此 __也可以用来移动WSL安装位置__ :

```cmd
wsl --import <AnotherDistributionName> <InstallLocation> <FileName>
```

验证可以使用`wsl --list -v`，这时我们已经有了两个WSL1。接下来我们转换其中一个为WSL2

```cmd
wsl --set-version <AnotherDistributionName> 2
```

再执行`wsl --list -v`就可以得到两个版本的WSL共存了。

> 使用同一个环境切分，可以比较方便的处理同一个文件夹下的文件，避免了由于不同用户导致的权限问题。

### WSL2容器解决方案

> Docker Desktop v4开始，对于商业公司使用作出了明确限制，如果涉及商用，就需要使用付费plan，因此本文介绍的都是使用[Podman](https://podman.io/) 进行容器管理的方案。

#### Podman安装

其它WSL底层系统请参考[Podman Installation Instructions](https://podman.io/getting-started/installation)

```bash
sudo apt-get -y install podman
```

#### Podman登录Docker注册表

```bash
podman login your.registry.com
```

#### Podman拉取镜像并运行

```bash
podman pull <image>
podman run <custom-args> <image>
```

由于缺失systemd和journal，可能会启动时遇到报错，可以在执行时增加参数`--cgroup-manager=cgroupfs --events-backend=file`，或者直接在配置文件里进行全局设置：

```bash
vim /etc/containers/containers.conf
```

```conf
[engine]
events_logger="file"
cgroup_manager="cgroupfs"
```

#### Podman停止、列出镜像

```bash
podman ps -a
podman stop <container> && podman rm <container>
```

### WSL2实用命令

#### [如何获取主机IP](https://pscheit.medium.com/get-the-ip-address-of-the-desktop-windows-host-in-wsl2-7dc61653ad51)

```bash
ipconfig.exe | grep 'vEthernet (WSL)' -A4 | cut -d":" -f 2 | tail -n1 | sed -e 's/\s*//g'
```