wslmanager
bostrot/wslmanager加载项目详情…
本应用为开源项目,仅供学习研究,请遵守其开源协议。
加载项目详情…
本应用为开源项目,仅供学习研究,请遵守其开源协议。
图 1:WSL Manager 主界面(Windows 深色主题)
如果你是一名在 Windows 上工作的开发者,十有八九绕不开 WSL(Windows Subsystem for Linux)—— Windows 原生的 Linux 子系统。它让你在不必装双系统的情况下,在 PowerShell 里直接跑 apt install、pip install,在 VS Code 里无缝调试 Linux 环境。
但 WSL 的命令行管理体验并不友好:wsl.exe --install 记不住参数,wsl --import 分区挂载让人头疼,更别提备份、迁移、多 distro 并行管理……每次重装系统前手动导出 distro,简直是一场小型噩梦。
WSL Manager 就是来解决这个问题的——一个图形化界面,让你用鼠标管理 WSL 实例:安装、复制、迁移、备份、删除,一个窗口搞定。与此同时,它还悄悄地在 macOS 上做了同样的事:借助 Apple Virtualization.framework,在 Mac 上跑原生 Linux 和 macOS 虚拟机。
而它的 Pro 版更激进——集成了 AI 助手、MCP Server、Web Dashboard,把 WSL 管理直接接入了 AI Agent 工作流。
WSL Manager(GitHub 曾用名 wsl2-distro-manager,现统一为 wslmanager)由独立开发者 Eric Trenkel(GitHub @bostrot)从 2021 年开始开发,是一个典型的「个人工具解决个人痛点」项目。四年间,他在业余时间持续维护,经历了从简单的 WSL 实例管理到跨平台 VM 管理,再到 AI 集成的多次重大演进。
2025 年初,项目正式推出 Pro 版本(一次性买断,非订阅),引入了 AI Workspace、AI 助手、MCP Server 等功能。这是作者首次尝试商业化,也是项目从工具向平台演进的标志。
项目在 GitHub 上获得了 4,000+ Stars,曾登上 Hacker News 首页,引发 63 条讨论。核心用户群体包括:在 Windows 上开发 Linux 相关项目(Docker、Kubernetes、嵌入式)的工程师,以及需要在 macOS 上管理多个 Linux 测试环境的开发者。
这是 WSL Manager 的基本盘。你可以用它:
.wsl 文件,可在任意 Windows 机器上直接导入,无需 CLI 记忆.wslconfig 手写WSL 的配置文件 .wslconfig 和 systemd 配置长期以来只能通过记事本修改。WSL Manager 提供了可视化配置面板:
在 macOS 上,WSL Manager 改用 Apple 的 Virtualization.framework,实现:
Pro 版是 WSL Manager 最具差异化的部分,也是作者商业化的核心。
AI Assistant:内置聊天机器人,不是简单对话,而是带工具的 AI Agent。它能直接操作 WSL 实例——查询 distro 列表、运行命令、编辑配置文件、创建 snippet、挂载磁盘——所有操作以真实工具调用的形式嵌入对话,结果实时展示。
AI Workspace:在隔离的 WSL distro(Windows)或 VM(macOS)内运行 AI 工具(Hermes Agent、OpenCode、Open WebUI 等),AI 只能访问沙箱内部,无法触及主机或其他实例。
MCP Server:本地 HTTP 服务(http://127.0.0.1:59133/mcp),暴露 WSL 操作工具给任何 MCP 兼容客户端:Claude Desktop、Claude Code、opencode 等。这意味着你在任何 AI 编码工具里,直接用自然语言管理 WSL。
Web Dashboard:Pro 版在 59134 端口提供完整 Web 界面,通过 QR 码一键从手机扫码访问,支持 Cloudflare Tunnel публичный 隧道。
Pro 版还支持从 GUI 内一键将 WSL distro 部署到 Hetzner Cloud 服务器——导出租文件系统、上传、启动,完全自动化。
WSL Manager 主体使用 Dart + Flutter 构建,目标平台为 Windows(Win32 API + Fluent UI)和 macOS(Virtualization.framework)。
核心依赖(pubspec.yaml 关键包):
| 类别 | 技术选型 |
|---|---|
| UI 框架 | flutter + fluent_ui(Windows 风格)+ go_router(路由) |
| 状态管理 | provider |
| 平台交互 | win32 + win32_registry(.wslconfig)+ desktop_window |
| 网络 | dio(HTTP)+ http |
| 文件处理 | archive(打包)+ tar + file_picker |
| 虚拟化 | Apple Virtualization.framework(macOS,Swift 辅助工具 vmctl) |
| 国际化 | flutter_localizations + intl,支持 9 种语言 |
| 容器支持 | chunked_downloader(rootfs 下载) |
macOS 特殊说明:虚拟机管理依赖 Apple 的 Virtualization.framework,Flutter 本身不直接驱动,而是通过一个 Swift 辅助工具 vmctl(位于 macos/vmctl/)实现。辅助工具需要用 Apple 开发者证书签名(com.apple.security.virtualization entitlements)才能正常工作,开发调试时需额外构建步骤(VMCTL_ONLY=1 scripts/build_macos.sh)。
license:实测根目录 LICENSE 文件内容为 GPL-3.0,但 GitHub API 返回 spdx_id: NOASSERTION(文件首行非标准 SPDX 格式)。项目主体为 GPL-3.0 开源。
WSL Manager 的安装渠道极其丰富,对普通用户极其友好:
winget install Bostrot.WSLManagerbrew install --cask wsl-manager.exe / .msix / .zip(Windows)和 .dmg(macOS)对于已有 WSL 基础的用户,安装时间不超过 5 分钟。
# Windows
flutter config --enable-windows-desktop
flutter build windows
# macOS(需额外签名步骤)
flutter config --enable-macos-desktop
VMCTL_ONLY=1 scripts/build_macos.sh
flutter run -d macos
AI 功能被封在 Pro 里,但基础管理功能免费且完整。问题是:WSL Manager 的核心价值是 GUI 管理,对于不需要 AI 集成的用户,Pro 的吸引力有限。作者定位清晰——「Pro 是 AI 层」,但 100 美元左右的定价对个人用户的转化率可能不高。
Virtualization.framework 在 Apple Silicon 上表现较好,但 Intel Mac 支持有限,部分功能处于 Beta 状态。社区反馈中偶有 VM 启动失败的报告,通常与 macOS 版本或 entitlements 配置有关。
作者明确声明「AI 功能运行在你提供的 API Key 上,无第三方服务器介入」,但沙箱(sandbox)的隔离边界是 WSL distro/VM 本身——沙箱内实例有正常的外网访问权限,用户仍需注意不要在沙箱内运行来源不明的命令。
Windows 侧完全依赖 WSL2,若 WSL 本身出现 bug(如之前的 systemd 兼容性问题),WSL Manager 也无能为力。
跨平台 DevOps 工具链的新范式:传统 WSL 管理要么是纯 CLI(wsl.exe),要么是第三方 GUI 工具。WSL Manager 的独特之处在于将 WSL 管理、MCP 协议、云部署串联起来,形成了一个以开发者工作流为中心的闭环工具。
AI + 基础设施的结合:MCP Server 的引入让 WSL 管理跳出了人机交互的范畴,成为 AI Agent 可操作的基础设施工具。这与 Anthropic 的 MCP 协议愿景高度一致——让 AI 不只是聊天,而是能真正操作系统资源。
增长曲线:4,000+ Stars 在开发者工具类中属于中等体量,但考虑到这是一人维护四年的项目,且功能深度远超同类工具,这个成绩相当可观。Hacker News 的讨论(63 条)也显示它在开发者社区有真实口碑。
图 2:WSL Manager 主界面(Windows 浅色主题)
图 3:macOS 版 WSL Manager(深色主题)
图 4:macOS 版 WSL Manager(浅色主题,AI 助手面板已展开)
WSL Manager 是 WSL 和虚拟机管理的「终极 GUI」——它把命令行里的琐碎操作全部图形化,同时通过 AI 集成和 MCP 协议将其升级为 AI Agent 可操控的基础设施工具。对于在 Windows/macOS 上频繁使用 Linux 环境的开发者,它是一个一旦用上就回不去的工具;Pro 版的 AI 功能则为愿意为效率付费的用户提供了差异化价值。
适合人群:在 Windows 上做 Linux 开发的工程师、需要 macOS 多 VM 环境的测试人员、关注 MCP 生态的 AI 应用开发者。