Skip to content

一个轻量级的 Windows WSL 管理工具,提供 GUI 和 CLI 双版本,支持启动、停止、卸载及在线安装分发版。

License

Notifications You must be signed in to change notification settings

furina707/wsl-manager

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 

Repository files navigation

WSL 管理工具 (WSL Manager) 🐧

这是一个专为 Windows 用户设计的轻量级 WSL (Windows Subsystem for Linux) 管理工具,包含 命令行版本 (CLI)图形界面版本 (GUI)。它可以帮助你轻松管理、启动、停止、甚至安装新的 Linux 分发版。


✨ 功能特性

  • 双版本支持:喜欢命令行的极客或喜欢点点点的萌新都能轻松上手。
  • 核心逻辑统一:CLI 和 GUI 使用同一套底层逻辑,功能完全对等。
  • 一键操作:支持启动、停止、注销(卸载)以及全局关机。
  • 在线安装:内置官方分发版列表,一键选择并安装你喜欢的 Linux。
  • 现代适配:GUI 版本支持高清屏幕缩放 (DPI Awareness),界面清晰不模糊。

🛠️ 准备工作 (开发者/萌新编译指南)

如果你想自己动手编译这个工具,你需要安装以下任意一种环境:

  1. 推荐:MSYS2 (GCC)
    • 安装 MSYS2
    • 在 MSYS2 终端运行 pacman -S mingw-w64-x86_64-gcc
  2. 备选:Visual Studio (MSVC)
    • 安装 Visual Studio (包含 C++ 桌面开发组件)。

🚀 如何编译 (一键编译)

  1. 下载本项目到本地。
  2. 双击运行根目录下的 build.bat
  3. 脚本会自动检测你的环境并开始编译。
  4. 编译成功后,你会看到一个新的 bin 文件夹。

📖 如何使用

1. 图形界面版 (GUI) —— 最推荐萌新

  • 进入 bin 文件夹,双击运行 wsl_gui.exe
  • 主界面:列出你电脑上已有的 Linux。
  • 启动/停止:选中一个分发版,点击下方按钮即可。
  • 在线安装:点击“在线安装”按钮,弹出的窗口里有几十种 Linux 供你选择。

2. 命令行版 (CLI) —— 适合效率控

进入 bin 文件夹,在终端运行以下命令:

  • .\wsl_manager.exe list :查看已安装的 Linux。
  • .\wsl_manager.exe online-list :查看可以安装哪些 Linux。
  • .\wsl_manager.exe start <名称> :启动指定的 Linux。
  • .\wsl_manager.exe stop <名称> :停止指定的 Linux。
  • .\wsl_manager.exe install <名称> :安装新的 Linux。
  • .\wsl_manager.exe shutdown :一键关闭所有运行中的 WSL。

📂 项目结构说明

  • bin/:存放编译好的可执行文件(.exe)。
  • src/:存放所有的源代码。
    • wsl_core.c/h:核心逻辑(大脑)。
    • wsl_manager.c:命令行工具源码。
    • wsl_gui.c:图形界面源码。
  • build.bat:自动化编译脚本。

📄 开源协议

本项目采用 MIT License 协议。你可以自由地使用、修改和分发本代码,只需在你的项目中保留原始的版权声明即可。 “随便用,别找我麻烦就行” → MIT

  • “想让这个工具永远保持开源,谁改谁也得开源” → GPL v3
  • “随便用,但要保护专利安全” → Apache 2.0

⚠️ 注意事项

  • 请确保你的 Windows 已开启 WSL 功能(可在“启用或关闭 Windows 功能”中开启)。
  • “卸载”操作是不可逆的,会删除该分发版内的所有数据,请谨慎操作!

希望这个小工具能让你的 WSL 使用体验更加愉快!🎉

About

一个轻量级的 Windows WSL 管理工具,提供 GUI 和 CLI 双版本,支持启动、停止、卸载及在线安装分发版。

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published