WSL必备神器：LxRunOffline

LxRunOffline 是一款用于管理 Windows 10 和 Windows 11 上的 Windows Subsystem for Linux (WSL) 实例的命令行工具。它允许用户在不启动 WSL 的情况下，离线管理 Linux 发行版。通过 LxRunOffline，用户可以安装、卸载、注册、导出、导入和克隆 WSL 实例，支持多种 Linux 发行版，如 Ubuntu、Debian、Fedora 等。此外，它还可以方便地将现有的 WSL 实例移动到不同的驱动器或目录，或者备份当前的 WSL 环境到 tar 文件中。该工具适合需要更灵活、更精细管理 WSL 实例的高级用户和开发者。

安装 LxRunOffline

方式一：普通手动安装。下载解压 LxRunOffline ，并设置环境变量方便调用 (也可将其直接丢到C:\Windows下)。

方式二：使用 Chocolatey 安装。

choco install lxrunoffline

方式三：使用 Scoop 安装。

scoop bucket add extras
scoop install lxrunoffline

LxRunOffline 选项及参数

开发者并没有在 GitHub 上给出任何选项参数说明，你需要在终端内直接输入 lxrunoffline 查看，这里列举一下当前版本 (3.4.0) 的选项说明。相关的参数可以直接输入选项查看，比如 lxrunoffline i。

所有命令如下：

C:\WINDOWS\system32>lxrunoffline version
LxRunOffline v3.5.0

C:\WINDOWS\system32>lxrunoffline
[ERROR] No action is specified.

Supported actions are:
    l, list            List all installed distributions.
    gd, get-default    Get the default distribution, which is used by bash.exe.
    sd, set-default    Set the default distribution, which is used by bash.exe.
    i, install         Install a new distribution.
    ui, uninstall      Uninstall a distribution.
    rg, register       Register an existing installation directory.
    ur, unregister     Unregister a distribution but not delete the installation directory.
    m, move            Move a distribution to a new directory.
    d, duplicate       Duplicate an existing distribution in a new directory.
    e, export          Export a distribution's filesystem to a .tar.gz file, which can be imported by the "install" command.
    r, run             Run a command in a distribution.
    di, get-dir        Get the installation directory of a distribution.
    gv, get-version    Get the filesystem version of a distribution.
    ge, get-env        Get the default environment variables of a distribution.
    se, set-env        Set the default environment variables of a distribution.
    ae, add-env        Add to the default environment variables of a distribution.
    re, remove-env     Remove from the default environment variables of a distribution.
    gu, get-uid        Get the UID of the default user of a distribution.
    su, set-uid        Set the UID of the default user of a distribution.
    gk, get-kernelcmd  Get the default kernel command line of a distribution.
    sk, set-kernelcmd  Set the default kernel command line of a distribution.
    gf, get-flags      Get some flags of a distribution. See https://docs.microsoft.com/en-us/previous-versions/windows/desktop/api/wslapi/ne-wslapi-wsl_distribution_flags for details.
    sf, set-flags      Set some flags of a distribution. See https://docs.microsoft.com/en-us/previous-versions/windows/desktop/api/wslapi/ne-wslapi-wsl_distribution_flags for details.
    s, shortcut        Create a shortcut to launch a distribution.
    ec, export-config  Export configuration of a distribution to an XML file.
    ic, import-config  Import configuration of a distribution from an XML file.
    sm, summary        Get general information of a distribution.
    version            Get version information about this LxRunOffline.exe.

使用 LxRunOffline 安装 WSL

与微软商店的安装方式不同，LxRunOf­fline 安装 WSL 更灵活，它可以安装任意发行版到任意目录，还可以自定义 WSL 名称。

如果你没有使用过 WSL ，首先以管理员身份运行 Pow­er­Shell (WIN+X , A)，输入下面的命令开启 “适用于 Linux 的 Win­dows 子系统” 功能，并重启。

Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux

下载 WSL 官方离线包，改后缀名为.zip，解压后可得到名为 install.tar.gz 的文件。或者在 LxRunOffline WiKi 中下载大佬们提供的镜像文件。

输入以下命令进行安装：

lxrunoffline i -n <WSL名称> -d <安装路径> -f <安装包路径>.tar.gz

加入-s参数可在桌面创建快捷方式。

设置默认用户

当修改过 WSL 的名称或目录后就无法通过微软官方提供的方法设置默认用户。这时可以使用 LxRunOf­fline 进行设置。

设置普通用户为默认用户

使用 LxRunOf­fline 新安装的 WSL 默认是以 root 用户登录，如果你需要默认以普通用户进行登录，就需要进行下面的操作。

首先运行 WSL ，输入以下命令创建用户：

useradd -m -s /bin/bash <用户名>

然后对该用户设置密码，输入命令后会提示输入两次密码。

passwd <用户名>

授予该用户 sudo 权限。

usermod -aG sudo <用户名>

为了保持和微软商店安装的效果一致，这里提及的方法是把用户添加到 sudo 用户组。其他关于 sudo 权限的设置方法以及免密设置可参考《Linux 中授予普通用户 sudo 权限的正确方法》这篇文章。

查看用户 UID ，一般是 1000。

id -u <用户名>

按 Ctrl+D 退出 WSL ，在 Pow­er­Shell 中输入以下命令：

lxrunoffline su -n <WSL名称> -v 1000

设置 root 为默认用户

root 用户的 UID 为 0，所以可以直接在 Pow­er­Shell 输入以下命令进行设置：

lxrunoffline su -n <WSL名称> -v 0

转移 WSL 安装目录

LxRunOf­fline 可以对系统中已经安装的 WSL 进行目录转移操作，拯救爆满的 C 盘。

查看系统中已安装的 WSL 。

lxrunoffline l

类似于wsl -l。LxRunOf­fline 不会显示默认 WSL ，查看默认 WSL 需要使用 lxrunoffline gd命令。

输入命令对 WSL 的目录进行移动：

lxrunoffline m -n <WSL名称> -d <路径>

最后查看路径，进行确认：

lxrunoffline di -n <WSL名称>

备份和恢复 WSL

使用 LxRunOf­fline 可以方便的对 WSL 进行备份和恢复，同样可以实现转移的操作，而且还可以在转移到其它电脑上。

备份 WSL

查看系统中已安装的 WSL 。

wsl -l

然后输入需要备份的 WSL 名称和备份的目标路径。

lxrunoffline e -n <WSL名称> -f <压缩包路径>.tar.gz

类似但不等同于wsl --export <压缩包路径>.tar。LxRunOf­fline 备份完会生成一个.xml后缀的同名配置文件，比如WSL.tar.gz.xml。

恢复 WSL

输入以下命令可以恢复已备份的 WSL，和安装是相同的命令。

lxrunoffline i -n <WSL名称> -d <安装路径> -f <压缩包路径>.tar.gz

类似但不等同于wsl --import <安装路径> <压缩包路径>.tar。LxRunOf­fline 会读取备份时生成的配置文件并写入配置，前提是同目录且同名。否则你需要加入-c参数指定配置文件。

创建快捷方式

使用微软应用商店安装的 WSL 会在开始菜单添加应用图标（快捷方式），而使用 LxRunOf­fline 安装 WSL 时可以通过添加 -s 参数在桌面创建快捷方式。如果你安装时忘记添加参数，可以使用以下命令进行创建。

lxrunoffline s -n <WSL名称> -f <快捷方式路径>.lnk

举例：

lxrunoffline s -n centos -f C:\Users\<用户名>\Desktop\centos.lnk

设置默认 WSL

设置默认 WSL 后，可以在 cmd 和 powershell 中输入 wsl 直接调用默认的 WSL 。

lxrunoffline sd -n <WSL名称>

等同于wsl -s

运行 WSL

和原生运行方式本质上是一样的。在有多个 WSL 的情况下，可以指定运行某个发行版。

lxrunoffline r -n <WSL名称>

等同于wsl -d

其他操作

查看 WSL 安装目录。

lxrunoffline di -n <WSL名称>

导出指定的 WSL 配置文件到目标路径。

lxrunoffline ec -n <WSL名称> -f <配置文件路径>.xml

配置信息可以输入lxrunoffline sm -n查看

取消注册（这个操作不会删除目录）

lxrunoffline ur -n <WSL名称>

使用新名称注册

lxrunoffline rg -n <WSL名称> -d <WSL路径> -c <配置文件路径>.xml