Windows下wsl使用简介¶

前言：为什么需要WSL¶

由于种种原因，组内提供的工作电脑的操作系统已经逐渐从Mac转向Windows（更严谨的应该说是x86_64架构的组装机），同时近年来Windows笔记本端可选择性更为丰富，综合诸多因素来看在一些体验上已经可以做到不弱于Mac。而由于Windows操作系统并不是基于Unix的系统，因此系统自带的终端操作逻辑以及文件系统和liunx本身有较大的区别，在使用时可能会带来一些困惑以及不兼容的情况。而额外学CMD命令有些得不偿失而且可能会和linux终端命令搞混来。

而对于Windows下较为成熟的各种终端软件如MobaXTerm，Putty，他们在使用体验上远远不及Mac系统本身带的终端，且整体逻辑较为**割裂**，无法将系统和终端直接联系起来。如在MobaXTerm下使用其直接传递文件的速度并不快，大多时候限制因素并不是网速，远不如使用scp命令进行的文件传；Putty本身不支持x11，如果需要配置远程可视化窗口流程复杂，而且需要在使用时挂一个x11转发软件，同时不支持scp本地文件传递，想要传个文件还需要再开一个windows终端或者scp软件，这太不优雅了。

而wsl（Windows Subsystem for Linux）的出现大大缓解了这种令人两难的情况，单纯从使用者的角度来看，其和直接使用linux命令对Windows进行管理没有太大的区别，我们可以同时享受到Windows可视化界面在信息处理方面带来的便利以及linux命令行带来的批处理方面的便利性。特别是在ssh的使用方面，我们可以将服务器的集群操作以及文件传输同时在一个终端内进行体验较为良好的完成，这在之前的任何软件中都是没有很好地实现的。

如果电脑本地有一些性能，我们还可以尝试在wsl中安装一些计算软件或者调试环境，这样可以在本地做一些短期的参数验证以及代码调试，不需要反复提交到集群上进行排队，提高一定效率的同时可以节省一些机时费用。如cp2k中的REL_CUTOFF以及CUTOFF参数的调优可以在本地快速进行，再在集群上进行长时间的计算。

WSL安装¶

此过程较为容易，且官方教程、中文教程在互联网上较为详尽，不再过多地占篇幅。

从笔者的使用经验来看，Windows Terminal是一个比较不错的终端（Win11系统默认，Win10需要自己安装），在新版中使用wsl2可以直接支持x11的转发，不行的可以参考网页进行设置。

版本推荐

目前wsl默认版本为wsl2，可以完整支持linux内核的功能，后面的内容默认以此版本为准。同时linux版本也可以选择默认的Ubuntu，作为在个人端应用较广的linux发行版，在遇到问题时通过互联网查找信息能够解决的概率相对较大。

终止/重启wsl特定版本的方法，在Powershell/CMD中：

wsl --shutdown distro_name
distro_name    # 启动指定发行版

其中distro_name为安装的发行版名称，可以通过wsl -l -v查看已经安装的发行版。

将wsl移动到其他分区¶

wsl默认安装在C盘下，如果C盘初始分配的相对较小或者有C盘空间焦虑，可以考虑将指定的wsl移动到其他的盘符下。请参考：轻松搬迁！

wsl配置ssh环境¶

在基础设置上和ssh使用章节没有区别。下面将介绍一些便利使用的方法。

改善使用体验的关键：wsl的vpn环境¶

对于在非校园网环境下办公的情况，wsl和EasyConnect的兼容性并不是很好，经常出现开启EasyConnect之后wsl无法访问网络的情况。如果想要正常使用两者，就需要在开机后迅速打开EasyConnect客户端，再打开wsl，但是这种连接也非常脆弱，中间但凡EasyConnect断开，就再也别想连回去了，唯一解决方法就是重启，这无疑会为工作带来相当的困扰。为此，有以下的几种通过环境配置的解决方法，其中最为推荐的是第一种方法：

1. 使用wsl-vpnkit同步Windows的网络环境¶

工具地址：wsl-vpnkit

在使用上，最无感的安装方式为使用wsl的systemd方法建立服务，这种方法不需要建立新的发行版也不需要每次开机后都重启动，操作过程如下：

首先需要获取wsl-vpnkit程序本体

# 安装依赖
sudo apt-get install iproute2 iptables iputils-ping dnsutils wget

# 下载wsl-vpnkit并解压其中关键组件
VERSION=v0.4.x    # 目前最新版本为v0.4.1
wget https://github.com/sakai135/wsl-vpnkit/releases/download/$VERSION/wsl-vpnkit.tar.gz    # 可能需要科学上网下载再传到wsl中
tar --strip-components=1 -xf wsl-vpnkit.tar.gz \
    app/wsl-vpnkit \
    app/wsl-gvproxy.exe \
    app/wsl-vm \
    app/wsl-vpnkit.service
rm wsl-vpnkit.tar.gz

此后在路径下就可以看到wsl-vpnkit, wsl-gvproxy.exe, wsl-vm, wsl-vpnkit.service四个文件，编辑其中的wsl-vpnkit.service文件，以下为该种配置方式的参考：

$ vi wsl-vpnkit.service

[Unit]
Description=wsl-vpnkit
After=network.target

[Service]
# for wsl-vpnkit setup as a distro
#ExecStart=/mnt/c/Windows/system32/wsl.exe -d wsl-vpnkit --cd /app wsl-vpnkit

# for wsl-vpnkit setup as a standalone script
ExecStart=/usr/local/bin/wsl-vpnkit/wsl-vpnkit
Environment=VMEXEC_PATH=/usr/local/bin/wsl-vpnkit/wsl-vm GVPROXY_PATH=/usr/local/bin/wsl-vpnkit/wsl-gvproxy.exe

Restart=always
KillMode=mixed

[Install]
WantedBy=multi-user.target

此后需要将运行文件和服务配置文件放到该放的位置：

sudo mkdir /usr/local/bin/wsl-vpnkit
sudo mv wsl-vpnkit wsl-gvproxy.exe wsl-vm /usr/local/bin/wsl-vpnkit/
sudo mv wsl-vpnkit.service /etc/systemd/system/

其中/usr/local/bin/wsl-vpnkit可以是任意位置，确保wsl开机后不会消失就可以。此后就可以启动服务并设置开机启动：

sudo systemctl enable wsl-vpnkit    # 设置开机启动
sudo systemctl start wsl-vpnkit     # 开启服务
systemctl status wsl-vpnkit         # 查看运行状态

如果没有查看状态没有报错，就说明已经可以正常运行了。

其他的运行模式可以参考github界面进行设置。

2. 设置wsl的网络模式为mirrored¶

注意

网络映射在wsl新版本中仍为实验性功能，可能存在不稳定的情况。同时旧版本wsl无法使用。

wsl默认的网络模式为NAT，而EasyConnect的工作原理可以简单的理解为建立了一个虚拟网卡和校园网进行沟通，这两种方式并不能进行完美的配合，具有很强的先后运行顺序的关联。而在新版的wsl版本中，提供了一种镜像Windows中所有的网络环境到wsl中的手段，包括系统代理也可以镜像到wsl当中。

首先设置.wslconfig文件：

$ vi /mnt/c/Users/username/.wslconfig

[experimental]
networkingMode=mirrored

其中/mnt/c/Users/username/.wslconfig是Windows下的用户根目录下的一个wsl配置文件，一般是新创建的。同时，该文件也可以设置wsl占用的系统资源等一些参数。完成编辑保存并退出后，重启wsl发行版就可以实现网卡的映射。可以通过以下的命令进行观察:

sudo apt install net-tools

ifconfig

可以将输出的信息和任务管理器中的网卡信息进行对比，可以发现任务管理器中的网卡ip已经映射到wsl当中，我们也可以访问校园网服务器。

3. WSL2 + Docker + EasyConnect + Clash¶

参考：新时代的快乐科研：WSL2+Docker+EasyConnect+Clash

该方式的实现非常优雅，并且因为容器化的原因能够让EasyConnect非常老实，且可以登录一个vpn让多个设备使用，让校园网外的手机和平板平台也能访问校园网（移动端的EasyConnect并不支持扫码登录）。比较麻烦的点在于如果你的Clash配置文件会自动更新，会覆盖自己加入的那一行转发规则，~~不更新可能导致和某scholar检索say byebye~~。同时.ssh/config文件的编写会稍微有一些问题，如果在校园网下工作没有打开vpn的情况是不需要走代理端口的，此时若不修改文件内容就会报错（

wsl的文件系统: scp使用相关¶

此处是wsl相对于其他解决方案最有优势的地方。wsl可以将Windows的硬盘挂载在文件系统上，我们可以直接通过df -h命令进行查看：

$ df -h
Filesystem      Size  Used Avail Use% Mounted on
...
/dev/sdc       1007G   50G  907G   6% /
...
C:\             203G   88G  115G  44% /mnt/c
D:\             196G   80G  116G  41% /mnt/d
E:\             528G   52G  476G  10% /mnt/e

在此处，硬盘被分了三个盘符，均可以直接在wsl中看到，其默认的挂载点是/mnt/x，并可以直接通过wsl下的linux命令进行操作，如我想将桌面上的所有python脚本传递到集群上：

scp /mnt/disk/Users/username/Desktop/*py server:~/scripts

其中disk为电脑桌面的所在的盘符（如果没有移动过默认在C盘，则其值为c），username为你的电脑用户名（这也是不建议将用户名设置为中文的原因之一，可能会引起错误或者输入不便），server可以通过.ssh/config进行设置。

每次都需要输入这么一长串路径会很麻烦，因为挂载点在启动时并不会改变，因此可以将常用的文件夹映射到$HOME下：

ln -sf /mnt/disk/Users/username/Desktop $HOME/windows_desktop

因为建立的是软链接，因此在Windows中做的改动都会反映在文件当中，不需要反复进行同步。此后就可以直接将$HOME/windows_desktop中的文件通过scp传递到服务器上了。

WSL软件安装踩坑（未完待续）¶

WSL发行版：Ubuntu-24.04

CP2K¶

不要使用sudo apt install mpich的方法安装mpi运行库，这会导致即使使用psmp版本也无法使用mpi并行计算的bug，mpirun会导致同时运行n个相同的子程序。如果不想自己编译mpi库的话，因为不是集群多软件环境一般没有依赖冲突，使用--with-openmpi=install，此后使用时source /dir/to/cp2k/tools/toolchain/setup设置环境变量即可。