Skip to content

安装 ​

发布版本说明 ​

WSL Dashboard 提供三种不同形式的发布文件,以满足不同的使用场景:

版本类型文件名示例说明
便携版 (EXE)WSLDashboard.vX.Y.Z.Portable.x64.exe推荐方式。单文件绿色版,无需安装,直接运行。配置保存在 ~\.wsldashboard。
便携版 (ZIP)WSLDashboard.vX.Y.Z.Portable.x64.zip压缩后的便携版,适合手动部署或集成到其他工具集中。
安装版 (Setup)WSLDashboard.vX.Y.Z.Setup.x64.exe标准安装程序。运行后会创建开始菜单快捷方式、桌面图标,并注册系统卸载项。

TIP

如何选择?

  • 如果您追求简单快捷,请选择 便携版 (EXE)。
  • 如果您希望像普通软件一样在“开始菜单”中找到它,请选择 安装版 (Setup)。

安装方式 ​

WSL Dashboard 提供四种安装方式,您可以根据喜好任选其一:

方式一:官网下载(推荐) ​

访问 官网下载页面 选择适合您所在地区的镜像。

方式二:winget 安装 ​

通过 Windows 包管理器 (winget) 直接安装:

powershell
winget search wsl-dashboard
winget install wsl-dashboard

winget 包标识符为 Owu.WSLDashboard,别名 wsl-dashboard(不区分大小写),两者均可使用。

方式三:GitHub Releases 预编译 ​

前往 GitHub Releases 页面下载最新版。若下载的是压缩包,解压后直接运行 wsldashboard.exe 即可,无需安装。

方式四:从源码构建 ​

如果您希望自行编译,请确保您的开发环境满足以下要求:

  • Rust 工具链: 版本 1.92 或更高。
  • 构建目标: x86_64-pc-windows-msvc。

编译步骤 ​

  1. 克隆仓库:

    bash
    git clone https://github.com/owu/wsl-dashboard.git
    cd wsl-dashboard
  2. 开发运行:

    bash
    cargo run .
  3. 生产构建(使用提供的脚本):

    powershell
    .\build\portable\build.ps1

编译产物将位于 target/release 目录下。

便携版使用指南 ​

便携版无需安装:直接运行 wsldashboard.exe 即可使用,配置保存在 ~\.wsldashboard。卸载只需删除文件即可,不留系统残留。便携版与安装版功能完全一致,仅缺少开始菜单快捷方式、桌面图标与系统卸载项等系统集成。