Skip to main content

Easy to deploy WSL.

Project description

EasyWSL

让部署WSL更轻松!

使用环境

操作系统:Windows 10 1803以上版本

Python版本:>= 3.5

注意:该工具只能运行在Windows系统上,不支持在WSL中运行!

使用帮助

查看已安装的WSL系统列表

> ezwsl ls
Microsoft Windows 10 专业版 2004 Version 10.0.19041
WSL distribution installed:
 => Ubuntu-20.04(WSL2)

安装WSL发行版

> ezwsl install -d Ubuntu-20.04

目前只能安装官方支持的几款发行版:Ubuntu-20.04,Ubuntu-18.04,Ubuntu-16.04,Debian,Kali-Linux,OpenSUSE-42,SLES-12,FedoraRemix

如果尚未开启WSL,执行该命令会先开启WSL,用户需要在开启后重启一次系统,然后再次执行该命令。

卸载WSL发行版

> ezwsl uninstall -d Ubuntu-20.04

设置默认的发行版

> ezwsl set-default -d Ubuntu-20.04

默认情况下第一次安装的发行版会自动成为默认系统,如果想设置为其它系统,可以使用该命令。

设置默认的WSL版本

> ezwsl set-default-version -v 2

WSL默认使用的是WSL1,可以使用该命令修改默认的WSL版本。

升级WSL2需要开启VirtualMachinePlatform特性,如果尚未开启,工具会自动开启并提示重启系统。请在重启后再次执行该命令。

设置发行版使用的WSL版本

> ezwsl set-dist-version -d Ubuntu-20.04 -v 2

set-default-version命令相比,该命令只是设置指定的发行版WSL版本,不会修改默认的WSL版本。使用该命令也需要开启VirtualMachinePlatform特性。

安装zsh

zsh是目前使用非常广泛的shell,这里提供了一键安装zsh的命令,并且会安装oh-my-zsh以及Noto Mono for Powerline字体。

> ezwsl install-zsh -p password -d Ubuntu-20.04 --theme agnoster --set-default-shell

-p是Linux系统的当前用户密码(必选)

-d是要安装的发行版名字,不指定则使用当前发行版(可选)

--theme是使用zsh主题,默认是agnoster(可选)

--set-default-shell表示设置默认的shell为zsh(可选)

安装命令行终端

> ezwsl install-terminal -n wsl-terminal -p password --install-path C:\ --default-shell /bin/zsh

-n是terminal名称,目前只支持wsl-terminalwindows-terminal(必选)

-p是当前Linux系统的当前用户密码(必选)

--install-path是安装路径,默认为%APPDATA%(可选,只对wsl-terminal有效)

--default-shell是终端默认使用的shell,默认是bash(可选)

端口转发

WSL2中,WSL中不能通过回环地址访问Windows中创建的TCP服务。因此,easywsl提供了端口转发能力,允许在WSL中像访问本地服务一样访问Windows上的服务。

> ezwsl forward -p password --ports 80;443

-p是当前Linux系统的当前用户密码(必选)

--ports是要转发的端口列表,端口间使用;分割

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

easywsl-0.1.2.tar.gz (14.4 kB view hashes)

Uploaded Source

Built Distribution

easywsl-0.1.2-py3-none-any.whl (14.2 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page