wsl2-distro-manager
跨平台 GUI 管理工具,Windows WSL2 / macOS 原生虚拟机 / Linux 一站式管理,支持 AI 助手和 MCP 服务器
加载项目详情…
本应用为开源项目,仅供学习研究,请遵守其开源协议。
跨平台 GUI 管理工具,Windows WSL2 / macOS 原生虚拟机 / Linux 一站式管理,支持 AI 助手和 MCP 服务器
加载项目详情…
本应用为开源项目,仅供学习研究,请遵守其开源协议。
WSL Manager 运行在 Windows 11 上,深色主题界面
2024 年,如果你是一个 Windows 开发者,WSL2 是你绕不开的工具;如果你是一 macOS 用户,Homebrew + 虚拟机是你管理开发环境的标配。每换一台机器,就要重新配一遍环境——这个痛点,WSL Manager 的作者 bostrot 感同身受。
bostrot 从 2021 年开始用业余时间开发 WSL Manager,最初只是一个让自己少敲命令的脚本工具。如今它已成长为一个支持 Windows WSL2、macOS 原生虚拟机、Linux 三大平台,覆盖从安装到备份全生命周期的开源 GUI 利器。3,971 个 GitHub Stars 和持续更新的版本路线图(目前 v2.0.0),证明了它在开发者社区的实用价值。
WSL Manager 最直接的价值,是把 wsl.exe 那些拗口的参数全部变成鼠标点选。你可以用它:
.wsl 文件,新机器上双击即装不仅如此,它还支持任意 Docker 镜像作为 WSL 发行版——这意味着你可以把生产环境的 Docker 镜像直接跑在 WSL 里,无需安装 Docker Desktop。
WSL 的许多行为靠配置文件控制(systemd 开关、内存限制、DNS 设置、启动命令等),改错一行就会导致 distro 启动失败。WSL Manager 提供了清晰的图形界面来调整这些参数,包括:
Pro 版本(Microsoft Store 一次性购买)引入了开发者最感兴趣的功能:内置 AI 助手和 MCP 服务器。
这些 AI 功能依赖用户自带的 OpenAI 兼容 API Key(OpenAI、Azure、LiteLLM Proxy、Ollama、LM Studio 等均可),所有请求不经过第三方服务器。
项目根目录包含针对 Windows(windows/)、Linux(linux/)、macOS(macos/)的原生代码目录,由 Flutter 框架统一封装不同平台的系统调用。核心业务逻辑在 lib/ 下:
lib/screens/ — 各功能界面(主页、发行版详情、设置等)lib/components/ — 可复用 UI 组件lib/dialogs/ — 弹窗交互逻辑lib/api/ — 底层 API 封装(WSL 命令执行、MCP 协议等)lib/i18n/ — 国际化资源| 分类 | 技术 | 说明 |
|---|---|---|
| 框架 | Flutter 3.x | 跨平台桌面应用基础 |
| 语言 | Dart | Flutter 专用语言 |
| 状态管理 | Provider | 轻量级状态管理方案 |
| 路由 | go_router | Flutter 声明式路由 |
| Windows API | win32 / win32_registry | WSL 系统调用 |
| macOS 虚拟化 | Apple Virtualization.framework | macOS 原生 VM 支持 |
| 打包 | msix | Windows Store 发布格式 |
项目 topics 明确标注 ai、llm、mcp、model-context-protocol,Pro 版的 AI 功能包括:
这些 AI 能力并非离线模型,而是通过 MCP 协议将 WSL 系统操作能力暴露给外部 AI 客户端。
项目没有提供 Dockerfile 或 docker-compose,无法容器化部署。桌面应用本身也不适合容器化场景。标准部署流程:
flutter pub get 安装依赖flutter build windows(或 linux/macos)Windows 用户可以直接从 Microsoft Store 安装或使用 winget:
winget install WSL2DistroManager
macOS 用户需要自行编译,运行 scripts/build_macos.sh 即可。
| 项目 | 要求 |
|---|---|
| GPU | 不需要 |
| 内存 | 4GB+ |
| 磁盘 | 500MB(不含发行版占用空间) |
| 操作系统 | Windows 10/11 (WSL2)、macOS (Apple Silicon 或 Intel)、Linux |
WSL Manager 反映了两个趋势:
WSL Manager 是一款功能完整的跨平台 Linux 环境管理工具,尤其适合需要在 Windows 上管理多个 WSL 实例的开发者。Pro 版的 AI 助手和 MCP 服务器是其差异化亮点,让它超越了传统系统管理工具的范畴。但缺乏容器化支持、对 Flutter 生态的依赖,以及 AI 功能的付费墙,是采用前需要权衡的因素。
适合人群:Windows 开发者、多 WSL 实例管理者、探索 AI Agent + 本地开发环境集成的技术爱好者 不适合:追求容器化部署、需要完全离线 AI 能力的用户