LetRecovery 详细部署教程

项目概述

LetRecovery 是一款免费用于非商业场景、源代码公开的 Windows 系统重装工具，基于 Rust 开发。它将“安装 + 备份 + 镜像下载”集成在同一个程序中，支持 WIM/ESD/SWM/GHO/ISO 五种镜像格式，自动识别 UEFI/Legacy 引导，并具备 BitLocker 自动解密能力。

核心功能：

功能模块 说明
系统安装 支持 WIM/ESD/SWM/GHO/ISO 镜像，含 Windows XP/2003 i386 文本模式安装
系统备份 完整/增量备份系统分区为 WIM/ESD/SWM/GHO
在线下载 系统镜像/常用软件在线获取，Aria2 多线程加速
BitLocker 管理 解锁/解密/挂起保护/查看恢复密钥
密码重置 在线（当前系统）或离线（其他系统）清除账户密码
工具箱 一键分区、分区对拷、批量格式化、无损扩大 C 盘、驱动备份还原等

许可证说明：LetRecovery 采用 PolyForm Noncommercial 1.0.0 许可证。这是一个 source-available（源代码公开） 许可证，不是 OSI 认可的传统开源许可证，禁止商业用途，仅允许个人学习、研究和非商业使用。

部署前准备

系统要求

根据官方 README，运行 LetRecovery 需要满足以下条件：

项目 要求
正常系统端 Windows 7–11（64 位，单一通用版本）
WinPE 端 与项目发布包配套的 64 位 WinPE
权限 管理员权限（必须）
内存 至少 4GB 可用内存
启动模式 支持 UEFI 或 Legacy BIOS 启动

重要说明：可部署的目标镜像范围比运行环境更广，包含 Windows XP/2003 及较新 Windows 版本。旧系统能否正常启动仍取决于硬件、固件模式和驱动支持。

数据备份

⚠️ 警告：安装系统会格式化目标分区，请提前备份重要数据！

在运行 LetRecovery 之前，请务必备份：

  • 目标分区上的所有个人文件
  • 重要的工作文档和项目文件
  • 浏览器书签、密码等个人数据

部署方式：下载官方发布包（唯一推荐方式）

LetRecovery 是一个 Windows 桌面应用程序，不需要“部署”到服务器或进行复杂的安装过程。你只需要下载官方发布的绿色版程序即可使用。

步骤 1：获取发布包

官方渠道（推荐）：

  • 访问 GitHub Releases 页面：https://github.com/NORMAL-EX/LetRecovery/releases
  • 下载最新版本的发布包（通常为 ZIP 压缩包）

重要提醒：LetRecovery 采用 PolyForm Noncommercial 许可证，请仅从官方渠道获取软件。不要从第三方网盘或不明来源下载，以免引入安全风险或被捆绑恶意软件。

步骤 2：解压并放置

将下载的 ZIP 包解压到任意目录（建议路径不含中文和空格），例如：

text

1
C:\LetRecovery\

解压后的目录结构应包含：

text

1
2
3
4
5
LetRecovery/
├── LetRecovery.exe        # 主程序（桌面端）
├── bin/                   # 依赖文件和 PE 相关资源
├── lang/                  # 语言文件
└── ...

注意：不要只单独拷贝 exe 文件，因为它必须依赖同级的 DLL 文件和 bin 文件夹才能正常工作。在 PE 环境下运行时，务必使用完整的安装包。

步骤 3：以管理员身份运行

右键点击 LetRecovery.exe，选择 “以管理员身份运行”。

程序启动后会进入主界面，你可以看到“系统安装”、“系统备份”、“在线下载”、“工具箱”等模块。

使用方法

基础重装流程

  1. 下载软件 — 从 Releases 页面下载最新版本
  2. 以管理员身份运行 — 右键点击程序，选择“以管理员身份运行”
  3. 选择镜像 — 在“系统安装”页面选择本地或在线镜像
  4. 选择目标分区 — 选择要安装系统的目标分区
  5. 开始安装 — 点击“开始安装”按钮

⚠️ 警告：安装系统会格式化目标分区，请提前备份重要数据！

关于 WinPE

社区用户反馈指出，LetRecovery 目前没有内置 PE，首次运行重装流程时需要下载约 800MB 的 PE 环境。开发者表示后续会优化 PE 体积。

当重装当前系统盘时，程序会自动写引导、重启进 WinPE 完成部署，中间不需要用户手动插拔 U 盘或换环境。

从源码构建（开发者选项）

如果你需要修改源码或参与开发，可以从源码构建。普通用户无需进行此步骤。

前置条件

根据官方 README，从源码构建需要：

  • Rust 1.88.0 与该工具链的 rust-src 组件（正常端 Win7 构建与 CI 固定使用该版本）
  • Visual Studio Build Tools 2022，并安装“使用 C++ 的桌面开发”和 Windows 10/11 SDK
  • 完整发布打包还需要 7-Zip 与 Windows DISM/ADK 环境

构建步骤

1
2
3
4
5
6
7
8
9
10
# 克隆仓库
git clone https://github.com/NORMAL-EX/LetRecovery.git
cd LetRecovery

# 正常系统端必须使用 Win7 目标重编译标准库
rustup toolchain install 1.88.0 --component rust-src
powershell -ExecutionPolicy Bypass -File .github/scripts/build-win7-normal.ps1

# PE 端仅运行在现代 WinPE，使用普通 Windows MSVC 目标单独构建
cargo +1.88.0 build -p letrecovery-pe --release --locked --target x86_64-pc-windows-msvc

重要：不要用 cargo build --workspace --release 生成要在 Windows 7 上运行的正常端程序。该命令会使用宿主机的 x86_64-pc-windows-msvc 标准库，可能静态导入 Windows 8+ API。

提交前检查

1
2
3
4
5
6
7
cargo fmt --all --check
cargo check --workspace --all-targets --locked
cargo clippy --workspace --all-targets --locked --features "LetRecovery/non-elevated-tests,letrecovery-pe/non-elevated-tests" -- -D warnings -A clippy::uninlined_format_args
cargo test --workspace --no-run --locked --features "LetRecovery/non-elevated-tests,letrecovery-pe/non-elevated-tests"
cargo test -p lr-core --locked
cargo test -p letrecovery-pe --locked --features non-elevated-tests
cargo test -p LetRecovery --locked --features non-elevated-tests

技术栈

根据官方 README，LetRecovery 使用以下技术：

技术 用途
Rust 主要编程语言
原生 Win32 / windows-rs 界面、Windows API 边界
tokio 异步运行时
aria2 高速下载引擎
wimlib / WIMGAPI / DISM 系统镜像部署、捕获与驱动维护
Ghost GHO 镜像恢复

常见问题排查

问题 解决方案
PE 下载速度慢 首次运行需下载约 800MB PE，建议在网络稳定时进行
部署时报“invalid compressed data”/错误码 2 镜像文件损坏或下载不完整（wimlib 解压缩失败）。建议重新下载镜像，并先用工具箱的镜像校验功能检查完整性
PE 环境下只拷贝 exe 无法运行 必须使用完整的安装包（含同级 DLL 和 bin 文件夹）
BitLocker 加密盘无法重装 LetRecovery 会自动检测并解锁/解密 BitLocker 加密的系统盘，然后走正常部署流程
如何切换界面语言 在“关于”页面内置语言选择器，默认简体中文，附带美式英语。添加其他语言只需将 JSON 文件放入 lang 文件夹

法律与使用限制

非常重要，请在使用前仔细阅读：

  1. 非商业用途：LetRecovery 采用 PolyForm Noncommercial 1.0.0 许可证，禁止商业用途
  2. 仅限合规使用：严禁将本项目用于任何违反用户协议的行为。对侵权、违规分发、未经授权的商业定制等，作者保留依法追究责任的权利
  3. 官方渠道获取：请仅从官方渠道（GitHub Releases）获取软件，不要从第三方网盘下载
  4. 作者保留权利：作者保留在适用法律及既有许可约束允许的范围内，随时调整后续版本授权方式或停止公开后续版本源代码的权利

总结

LetRecovery 是一个无需复杂部署的 Windows 桌面工具。你只需要：

  1. 从 GitHub Releases 下载发布包（唯一官方渠道）
  2. 解压到本地目录（不要只拷贝 exe）
  3. 右键“以管理员身份运行”

即可开始使用。核心使用流程为“选择镜像 → 选择目标分区 → 开始安装”，非常简单直接。

再次提醒：

  • 安装系统会格式化目标分区，请提前备份数据
  • 禁止商业用途
  • 请从官方渠道获取软件