zj/BootRepairTool
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

8

Browse Source
This commit is contained in:
zj
2026-02-12 02:32:57 +08:00
parent 69b2a29f6c
commit 44b32045ce
3 changed files with 153 additions and 13 deletions
Download Patch File Download Diff File Expand all files Collapse all files

28
AGENTS.md
View File

@@ -110,11 +110,29 @@ options root=/dev/mapper/cl-root ro crashkernel=auto rd.lvm.lv=cl/root rhgb quie
检测到缺少 EFI 模块时，自动安装相应的包：
| 发行版 | 包名 |
|--------|------|
| CentOS/RHEL/Rocky/Alma/Fedora | `grub2-efi-x64`, `grub2-efi-x64-modules` |
| Debian/Ubuntu | `grub-efi-amd64` |
| Arch/Manjaro | `grub` (已包含 EFI 支持) |
| CentOS/RHEL/Rocky/Alma/Fedora | `grub2-efi-x64`, `grub2-efi-x64-modules`, `shim-x64` |
| Debian/Ubuntu | `grub-efi-amd64`, `shim-signed` |
| Arch/Manjaro | `grub`, `efibootmgr` |
### 7. GRUB 修复 (`backend.py:chroot_and_repair_grub`)
### 7. 手动 EFI 安装 (`backend.py:_manual_install_efi_files`)
**NEW v2.4**: 当 `grub2-install` 因 Secure Boot 不支持时，使用手动方式安装 EFI 文件
#### 问题场景
某些系统（特别是 CentOS/RHEL 8）的 `grub2-install` 会报错：
```
this utility cannot be used for EFI platforms because it does not support UEFI Secure Boot.
```
这是因为标准 `grub2-install` 不支持 Secure Boot，需要使用 `shim` 链式加载。
#### 手动安装方法
当 `grub2-install` 失败时，自动尝试：
1. **查找现有 EFI 文件** - 从 `/boot/efi/EFI/<distro>/` 复制已有的 `grubx64.efi` 或 `shimx64.efi`
2. **使用 shim 链式加载** - 复制 `shimx64.efi` 并配置它加载 `grubx64.efi`
3. **使用 grub-mkimage 生成** - 从模块生成新的 EFI 文件
### 8. GRUB 修复 (`backend.py:chroot_and_repair_grub`)
#### BIOS 模式
- `grub-install --target=i386-pc --recheck --force /dev/sdX`
@@ -123,11 +141,13 @@ options root=/dev/mapper/cl-root ro crashkernel=auto rd.lvm.lv=cl/root rhgb quie
#### UEFI 模式 (参考 Calamares 实现)
- 自动检测系统架构 (x86_64/i386/arm64/loongarch64)
- **NEW**: 自动检测并安装 UEFI GRUB 模块
- **NEW**: 当 grub2-install 因 Secure Boot 失败时，自动使用手动 EFI 安装
- 获取正确的 EFI 参数 (target, grub_file, boot_file)
- **多重安装策略**（自动回退）：
1. 标准安装（带 NVRAM）
2. Live 环境/可移动模式（`--removable`）
3. 无 NVRAM 模式（`--no-nvram`）
4. **NEW**: 手动 EFI 文件复制（针对 Secure Boot 限制）
- **NEW**: EFI Fallback 安装（复制到 `/EFI/Boot/bootx64.efi`）
- **NEW**: 支持自定义 EFI 启动项名称

BIN
__pycache__/backend.cpython-39.pyc
View File

Binary file not shown.

138
backend.py
View File

@@ -1176,16 +1176,17 @@ def check_and_install_efi_modules(mount_point: str, distro_type: str, is_uefi: b
chroot_cmd_prefix = ["sudo", "chroot", mount_point]
# 根据发行版选择正确的 EFI 包
# 注意：CentOS/RHEL 8+ 需要 shim 包来支持 UEFI Secure Boot
efi_packages_map = {
"centos": ["grub2-efi-x64", "grub2-efi-x64-modules"],
"rhel": ["grub2-efi-x64", "grub2-efi-x64-modules"],
"fedora": ["grub2-efi-x64", "grub2-efi-x64-modules"],
"rocky": ["grub2-efi-x64", "grub2-efi-x64-modules"],
"almalinux": ["grub2-efi-x64", "grub2-efi-x64-modules"],
"debian": ["grub-efi-amd64"],
"ubuntu": ["grub-efi-amd64"],
"arch": ["grub"], # Arch 的 grub 包包含 EFI 支持
"manjaro": ["grub"],
"centos": ["grub2-efi-x64", "grub2-efi-x64-modules", "shim-x64"],
"rhel": ["grub2-efi-x64", "grub2-efi-x64-modules", "shim-x64"],
"fedora": ["grub2-efi-x64", "grub2-efi-x64-modules", "shim-x64"],
"rocky": ["grub2-efi-x64", "grub2-efi-x64-modules", "shim-x64"],
"almalinux": ["grub2-efi-x64", "grub2-efi-x64-modules", "shim-x64"],
"debian": ["grub-efi-amd64", "shim-signed"],
"ubuntu": ["grub-efi-amd64", "shim-signed"],
"arch": ["grub", "efibootmgr"], # Arch 的 grub 包包含 EFI 支持
"manjaro": ["grub", "efibootmgr"],
}
efi_packages = efi_packages_map.get(distro_type, [])
@@ -1194,6 +1195,8 @@ def check_and_install_efi_modules(mount_point: str, distro_type: str, is_uefi: b
log_warning(f"未知的发行版 '{distro_type}'，无法自动安装 EFI 模块")
return False, f"无法确定 {distro_type} 的 EFI 包名"
log_info(f"将安装以下 EFI 包: {', '.join(efi_packages)}")
# 安装 EFI 包前，先确保网络连接（复制 DNS 配置）
resolv_source = "/etc/resolv.conf"
resolv_target = os.path.join(mount_point, "etc/resolv.conf")
@@ -1244,6 +1247,113 @@ def check_and_install_efi_modules(mount_point: str, distro_type: str, is_uefi: b
return False, "UEFI 模块安装失败"
def _manual_install_efi_files(mount_point: str, efi_target: str, efi_grub_file: str,
efi_boot_file: str, bootloader_id: str = "GRUB") -> bool:
"""
手动安装 EFI 文件（当 grub2-install 因为 Secure Boot 不支持时使用）。
直接从 /boot/efi/EFI/<distro>/ 复制已有的 EFI 文件，或使用 shim 链式加载。
返回: 是否成功
"""
log_step("手动安装 EFI 文件", f"目标: {efi_grub_file}")
efi_firmware_dir = os.path.join(mount_point, "boot/efi/EFI")
# 创建目标目录
target_dir = os.path.join(efi_firmware_dir, bootloader_id)
try:
os.makedirs(target_dir, exist_ok=True)
log_info(f"创建/确认 EFI 目录: {target_dir}")
except Exception as e:
log_error(f"创建 EFI 目录失败: {e}")
return False
# 查找源 EFI 文件
# 可能的源路径：
source_paths = []
# 1. 从 /boot/efi/EFI/centos 或 /boot/efi/EFI/redhat 复制
for subdir in ["centos", "redhat", "fedora", "rocky", "almalinux", "boot"]:
source_paths.append(os.path.join(efi_firmware_dir, subdir, efi_grub_file))
source_paths.append(os.path.join(efi_firmware_dir, subdir, "shimx64.efi"))
source_paths.append(os.path.join(efi_firmware_dir, subdir, "shim.efi"))
# 2. 从 /boot/efi/ 直接查找
source_paths.append(os.path.join(mount_point, "boot/efi", efi_grub_file))
source_paths.append(os.path.join(mount_point, "boot/efi", "shimx64.efi"))
# 3. 从 /usr/lib/grub/x86_64-efi/ 复制 grubx64.efi
grub_modules_dir = os.path.join(mount_point, f"usr/lib/grub/{efi_target}")
source_paths.append(os.path.join(grub_modules_dir, "grubx64.efi"))
# 查找 shim 和 grub
shim_source = None
grub_source = None
for path in source_paths:
if os.path.exists(path):
log_info(f"找到 EFI 文件: {path}")
if "shim" in path.lower():
shim_source = path
elif "grub" in path.lower():
grub_source = path
# 复制文件
try:
if grub_source:
grub_target = os.path.join(target_dir, efi_grub_file)
shutil.copy2(grub_source, grub_target)
log_success(f"✓ 复制 GRUB: {grub_source} -> {grub_target}")
if shim_source:
# 如果使用 shim，复制 shim 并重命名为 grubx64.efi
# 或者保留 shim 文件名并在 NVRAM 中注册
shim_target = os.path.join(target_dir, "shimx64.efi")
shutil.copy2(shim_source, shim_target)
log_success(f"✓ 复制 Shim: {shim_source} -> {shim_target}")
# 同时复制为 bootloader 名称，便于启动
if efi_grub_file != "shimx64.efi":
shutil.copy2(shim_source, os.path.join(target_dir, efi_grub_file))
# 如果没有找到任何文件，尝试从 grub 模块生成
if not grub_source and not shim_source:
log_warning("未找到现有 EFI 文件，尝试使用 grub-mkimage 生成...")
# 构建 grub.efi 路径
grub_efi_output = os.path.join(target_dir, efi_grub_file)
# 获取模块列表（必需模块）
modules = "part_gpt part_msdos fat ext2 xfs btrfs normal boot linux configfile search search_fs_uuid search_fs_file"
# 尝试使用 grub-mkimage 生成 EFI 文件
chroot_cmd_prefix = ["sudo", "chroot", mount_point]
mkimage_cmd = chroot_cmd_prefix + [
"grub2-mkimage",
"-o", grub_efi_output,
"-O", efi_target,
"-p", "/boot/grub2",
] + modules.split()
success, _, stderr = run_command(
mkimage_cmd,
"使用 grub-mkimage 生成 EFI 文件",
timeout=60
)
if success and os.path.exists(grub_efi_output):
log_success(f"✓ 成功生成 EFI 文件: {grub_efi_output}")
else:
log_error(f"生成 EFI 文件失败: {stderr}")
return False
return True
except Exception as e:
log_error(f"手动安装 EFI 文件失败: {e}")
return False
def install_efi_fallback(mount_point: str, efi_target: str, efi_grub_file: str,
efi_boot_file: str, bootloader_id: str = "GRUB") -> bool:
"""
@@ -1920,6 +2030,16 @@ def chroot_and_repair_grub(mount_point: str, target_disk: str,
else:
install_errors.append(f"no-nvram 模式: {stderr}")
# 如果所有 grub2-install 方法都失败，尝试手动复制 EFI 文件（针对 Secure Boot 问题）
if not grub_install_success and "Secure Boot" in str(install_errors):
log_info("grub2-install 不支持 Secure Boot，尝试手动安装 EFI 文件...")
success = _manual_install_efi_files(mount_point, efi_target, efi_grub_file, efi_boot_file, bootloader_id)
if success:
grub_install_success = True
log_success("✓ 手动 EFI 文件安装成功")
else:
log_error("手动 EFI 文件安装失败")
# 安装 EFI fallback（如果启用）
if grub_install_success and use_fallback:
log_info("安装 EFI fallback 文件...")