213 lines
6.1 KiB
Markdown
213 lines
6.1 KiB
Markdown
# BootRepairTool - Linux GRUB 引导修复工具
|
||
|
||
[](LICENSE)
|
||
[](https://www.python.org/)
|
||
|
||
> 一个简单易用的 Linux GRUB 引导修复工具，提供图形化界面，适用于 Live USB/CD 环境。
|
||
|
||
## 📖 项目介绍
|
||
|
||
**BootRepairTool** 是一个用于修复 Linux 系统 GRUB 引导加载器的图形化工具。当你的系统因为 GRUB 损坏、分区调整、重装 Windows 等原因导致无法启动时，此工具可以帮助你快速修复引导问题。
|
||
|
||
### 主要功能
|
||
|
||
- 🔍 **自动扫描分区** - 自动检测系统中的 Linux 分区和 EFI 分区
|
||
- 🐧 **多发行版支持** - 支持 Arch、Debian/Ubuntu、CentOS/RHEL/Fedora、openSUSE 等主流发行版
|
||
- 🧬 **多架构支持** - 支持 x86_64、i386、arm64、loongarch64 等架构
|
||
- 💾 **多种文件系统** - 支持 ext4、btrfs、xfs、lvm、luks 等
|
||
- 🔧 **一键修复** - 自动挂载、chroot 环境、重装 GRUB、更新配置
|
||
- 🖥️ **图形界面** - 基于 tkinter 的直观图形界面
|
||
- 🔒 **Secure Boot 检测** - 自动检测并提示 Secure Boot 状态
|
||
|
||
## 🚀 使用方法
|
||
|
||
### 场景一：系统无法启动（Live USB 环境）
|
||
|
||
1. 使用 Linux Live USB/CD 启动电脑
|
||
2. 连接网络（可选，用于在线安装）
|
||
3. 打开终端，运行安装命令
|
||
4. 启动 BootRepairTool 进行修复
|
||
|
||
### 场景二：已安装系统的维护
|
||
|
||
直接在已安装的 Linux 系统中运行（需要 root 权限）。
|
||
|
||
## 📦 安装方法
|
||
|
||
### Arch Linux（推荐）
|
||
|
||
#### 方式一：一键安装脚本（自动从 Git 克隆）
|
||
|
||
```bash
|
||
# 下载安装脚本
|
||
wget https://raw.githubusercontent.com/yourusername/BootRepairTool/main/arch-install.sh
|
||
|
||
# 运行安装（默认从 Git 克隆最新版本）
|
||
sudo bash arch-install.sh
|
||
|
||
# 或使用本地文件安装
|
||
sudo bash arch-install.sh local
|
||
```
|
||
|
||
安装脚本会自动：
|
||
- 安装依赖（git、tk、python）
|
||
- 克隆/复制项目到 `/opt/boot-repair-tool`
|
||
- 创建启动脚本 `/bin/boot-repair`
|
||
- 创建桌面快捷方式
|
||
|
||
#### 方式二：手动安装
|
||
|
||
```bash
|
||
# 1. 安装依赖
|
||
sudo pacman -S git tk python
|
||
|
||
# 2. 克隆项目
|
||
sudo git clone https://github.com/yourusername/BootRepairTool.git /opt/boot-repair-tool
|
||
|
||
# 3. 创建启动脚本
|
||
sudo ln -s /opt/boot-repair-tool/arch-install.sh /bin/boot-repair
|
||
|
||
# 4. 运行
|
||
sudo boot-repair
|
||
```
|
||
|
||
### 其他发行版（Debian/Ubuntu/CentOS 等）
|
||
|
||
#### 方式一：打包安装
|
||
|
||
```bash
|
||
# 1. 确保有 Python 3.9+
|
||
python3 --version
|
||
|
||
# 2. 安装 PyInstaller
|
||
pip3 install pyinstaller
|
||
|
||
# 3. 打包
|
||
python3 build.py
|
||
|
||
# 4. 安装
|
||
sudo bash install.sh
|
||
```
|
||
|
||
#### 方式二：直接运行源码
|
||
|
||
```bash
|
||
# 1. 安装依赖
|
||
# Debian/Ubuntu:
|
||
sudo apt-get install git python3 python3-tk
|
||
|
||
# CentOS/RHEL/Fedora:
|
||
sudo yum install git python3 tkinter
|
||
|
||
# 2. 克隆项目
|
||
git clone https://github.com/yourusername/BootRepairTool.git
|
||
cd BootRepairTool
|
||
|
||
# 3. 直接运行
|
||
sudo python3 frontend.py
|
||
```
|
||
|
||
## 🎮 启动程序
|
||
|
||
安装完成后，可以通过以下方式启动：
|
||
|
||
```bash
|
||
# 命令行启动
|
||
sudo boot-repair
|
||
|
||
# 或使用 pkexec
|
||
pkexec boot-repair
|
||
```
|
||
|
||
或在应用程序菜单中搜索 "Linux GRUB 引导修复工具"。
|
||
|
||
## 🔧 修复步骤
|
||
|
||
1. **选择根分区 (/)** - 选择你的 Linux 根分区
|
||
2. **选择 /boot 分区**（可选）- 如果 /boot 是独立分区
|
||
3. **选择 EFI 分区**（UEFI 模式）- 通常是 FAT32 格式的 ESP 分区
|
||
4. **选择目标磁盘** - 要安装 GRUB 的磁盘（如 /dev/sda）
|
||
5. **点击"开始修复"** - 工具会自动完成挂载、chroot、修复、卸载
|
||
|
||
## 🖼️ 界面预览
|
||
|
||
```
|
||
+--------------------------------------------------+
|
||
| Linux GRUB 引导修复工具 v2.0 |
|
||
+--------------------------------------------------+
|
||
| 系统信息: x86_64 | 64位EFI | Live环境 |
|
||
+--------------------------------------------------+
|
||
| 1. 选择目标系统分区 |
|
||
| 根分区 (/) *: [/dev/sda1 ▼] |
|
||
| /boot 分区: [可选 ▼] |
|
||
| EFI 分区: [/dev/sda2 ▼] |
|
||
+--------------------------------------------------+
|
||
| 2. 选择目标磁盘 |
|
||
| 磁盘: [/dev/sda ▼] |
|
||
| [✓] UEFI 模式 |
|
||
+--------------------------------------------------+
|
||
| 3. 高级选项 |
|
||
| [ 开始修复 ] [ 刷新 ] |
|
||
+--------------------------------------------------+
|
||
| [日志窗口...] |
|
||
+--------------------------------------------------+
|
||
```
|
||
|
||
## 📋 支持的发行版
|
||
|
||
| 发行版 | 状态 |
|
||
|--------|------|
|
||
| Arch Linux / Manjaro / EndeavourOS | ✅ 完全支持 |
|
||
| Debian / Ubuntu / Linux Mint | ✅ 完全支持 |
|
||
| CentOS / RHEL / Rocky Linux / AlmaLinux | ✅ 完全支持 |
|
||
| Fedora | ✅ 完全支持 |
|
||
| openSUSE Leap / Tumbleweed | ✅ 完全支持 |
|
||
| Void Linux | ✅ 完全支持 |
|
||
| Gentoo | ✅ 完全支持 |
|
||
| NixOS | ✅ 完全支持 |
|
||
|
||
## ⚠️ 注意事项
|
||
|
||
1. **需要 root 权限** - 所有磁盘操作需要 `sudo`
|
||
2. **Live 环境** - 设计为在 Live USB/CD 中运行
|
||
3. **数据备份** - 建议操作前备份重要数据
|
||
4. **Secure Boot** - 某些情况下需要先在 BIOS 中禁用 Secure Boot
|
||
5. **UEFI/BIOS 模式** - 确保 Live USB 以正确的模式启动（与待修复系统一致）
|
||
|
||
## 🐛 故障排除
|
||
|
||
### 启动后黑屏/界面不显示
|
||
|
||
Arch Linux 可能出现 X11 字体渲染问题，尝试：
|
||
```bash
|
||
export XLIB_SKIP_ARGB_VISUALS=1
|
||
sudo boot-repair
|
||
```
|
||
|
||
### 找不到 EFI 分区
|
||
|
||
确保以 UEFI 模式启动 Live USB，而非 Legacy BIOS 模式。
|
||
|
||
### 修复后仍然无法启动
|
||
|
||
1. 检查 BIOS 启动顺序
|
||
2. 尝试禁用 Secure Boot
|
||
3. 手动选择 EFI 文件启动测试
|
||
|
||
## 🤝 贡献
|
||
|
||
欢迎提交 Issue 和 Pull Request！
|
||
|
||
## 📄 许可证
|
||
|
||
MIT License
|
||
|
||
## 🙏 致谢
|
||
|
||
- 参考 [Calamares](https://calamares.io) 引导安装模块实现
|
||
- 感谢所有贡献者和测试者
|
||
|
||
---
|
||
|
||
**提示**: 如果使用过程中遇到问题，请在终端运行 `sudo boot-repair` 查看详细日志信息。
|