diff --git a/AGENTS.md b/AGENTS.md index e22fe2b..05bc938 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -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//` 复制已有的 `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 启动项名称 diff --git a/__pycache__/backend.cpython-39.pyc b/__pycache__/backend.cpython-39.pyc index 2345c4b..367ec55 100644 Binary files a/__pycache__/backend.cpython-39.pyc and b/__pycache__/backend.cpython-39.pyc differ diff --git a/backend.py b/backend.py index 5ab4f82..988870d 100644 --- a/backend.py +++ b/backend.py @@ -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// 复制已有的 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 文件...")