安装器报错与找不到磁盘

适用范围

用 ISO 安装 OMV 时遇到下面这些情况，看这一篇：

• U 盘插上后电脑不从它启动，或者启动后停在黑屏、报错。
• 安装器选择磁盘的步骤里看不到你要装系统的那块盘。
• 安装器联网失败、下载组件失败，或者长时间卡在某个进度条上。
• 安装快结束时弹出 Unable to install GRUB in /dev/sda。

不适用：在已有的 Debian 上用命令安装 OMV，见在 Debian 13 上安装 OMV；系统已经装好、只是起不来，见系统无法启动。

开始排查前

安装器会清空所选的磁盘

影响范围：安装器占用所选磁盘的全部空间，并清空上面所有数据。OMV 的系统盘也不能同时存放数据。

前置条件：官方要求安装前断开除系统盘以外的所有磁盘。只要还有一块带数据的盘连着，就多一次选错的机会。下面的排查都先关机，拔掉数据盘的数据线或电源，只留要装系统的那一块。

回退办法：选错并确认写入之后无法撤销，只能从备份恢复。冗余不是备份，RAID 里的盘同样会被清空。

另外几个前提：

• 安装过程必须联网。官方提醒离线安装会在之后引发问题。
• ISO 已按下载、校验并制作安装 U 盘校验过。
• 记下主板、CPU、磁盘和网卡的型号，求助时要用。

排查步骤

1. U 盘不引导

1. 进 BIOS（UEFI）设置，把 U 盘设为第一启动项；有的主板用开机时的启动菜单键临时选择更方便。
2. 换一个 USB 口、换一个 U 盘，或者重新写盘。校验没通过的 ISO 写出来的盘，可能时好时坏。
3. 引导方式（UEFI 与传统 BIOS）：官方的系统要求页（8.x 版文档）写着，官网下载的 ISO 目前只支持 AMD64 的 BIOS 模式引导，要用别的引导方式，需要先装 Debian 再手动装 OMV。官方的系统要求表还建议关闭 Secure Boot；omv-extras 的新手指南给出的办法是：关闭 Secure Boot，并在 BIOS 里启用传统（Legacy / CSM）启动。主板只有 UEFI 时，改走在 Debian 13 上安装 OMV。有用户报告在 UEFI 下也装上过，但这不在官方支持范围内。
4. 都不行时，改走「先装 Debian 13，再装 OMV」的路线，见在 Debian 13 上安装 OMV。

2. 安装器里看不到磁盘

先判断：BIOS 里能不能看到这块盘？

现象	常见原因	处理
BIOS 里就看不到	数据线或电源没插好、接口坏、盘本身故障	换线、换接口，或把盘接到另一台电脑上确认
BIOS 能看到，安装器看不到	SATA 模式不是 AHCI；NVMe 或控制器需要安装器里没有的驱动	官方文档提到，SATA 要在 BIOS 里启用 AHCI（而不是 IDE）才能被正确识别，新电脑默认就是 AHCI，老机器可能是 IDE，把它改成 AHCI；仍不行见下面的说明
接在硬件 RAID 卡或带 RAID 功能的控制器上	控制器把磁盘包成了逻辑卷	改用 HBA 的直通（IT）模式，让系统看到每块物理盘，见硬盘接口、HBA 与 USB 硬盘盒
只看到 U 盘，没有别的盘	目标盘没接好，或者你只看到了安装介质本身	确认选的不是安装用的 U 盘

安装器的内核认不出你的 NVMe 盘或网卡时，官方安装页把 debootstrap 方式列为「最后手段」（步骤在论坛指南里，属于高阶操作）。先考虑「先装 Debian 13，再装 OMV」，那条路线可以自己选 Debian 的安装介质。

OMV 的安装器在检测到不止一块存储设备时，会弹出提示 More than one storage device has been detected，要求你核对为操作系统选的设备，认不出就关机拔掉其他磁盘。按容量和型号核对，不要只凭设备名。

3. 联网失败或下载卡住

1. 没有拿到地址：检查网线、交换机和路由器的 DHCP。
2. 卡在 Configuring apt 或 Retrieving ...：多半是镜像站慢或不可达。等几分钟；仍然卡住，就回到上一步换一个镜像站。
3. 需要代理的网络：在安装器的 HTTP proxy 一步填 http://用户名:密码@主机:端口/（用户名和密码可省），不需要就留空。
4. 装好之后还要改国内镜像、配置代理，见软件源、国内镜像与第一次更新。

4. Unable to install GRUB in /dev/sda

这是官方文档收录的已知问题。处理办法是在安装器自带的 shell 里手动安装引导程序：

1. 在报错窗口选 Continue，下一个提示 Installation step failed 同样选 Continue。
2. 回到安装器主菜单后，选 Execute a shell，再选 Continue。
3. 在这个 shell 里执行（这是安装器的 shell，不是装好的 OMV）：

# 在安装器的 shell 里执行
chroot /target
# 把 <系统盘> 换成你选来安装 OMV 的那块盘，例如 /dev/sda
grub-install /dev/<系统盘>
update-grub
exit
exit

4. 回到主菜单，选 Continue without boot loader，再选 Continue，安装就能继续完成。

引导程序只能装在系统盘上

<系统盘> 必须是你选来安装 OMV 的那块盘。写到数据盘上，会改动它开头的引导区域，可能破坏那块盘上的分区或引导信息。不确定哪块是系统盘时，先 exit 回到菜单，关机拔掉其他磁盘再重来。

5. 装完重启又回到安装界面

安装完成后要拔掉安装介质，并在 BIOS 里把启动盘改回系统盘，否则会再次从 U 盘启动。装好之后的启动问题见系统无法启动。

确认恢复

1. 拔掉 U 盘重启，系统能从系统盘启动，控制台登录提示上方显示了 IP 地址。
2. 浏览器打开 http://<IP 地址> 能看到登录页，默认账号信息见第一次登录：修改默认密码。
3. 确认能正常登录之后，再关机接回数据盘。接回后在 存储器 → 磁盘（Storage → Disks）里能看到所有数据盘。
4. 已有数据的盘用 存储器 → 文件系统（Storage → File Systems）里的挂载（Mount），不要点创建。见挂载已有数据的硬盘。

仍未解决

求助时说明：停在安装器的哪一屏（尽量拍照）、BIOS 的启动模式（UEFI 还是传统）、主板、磁盘和网卡型号、U 盘的写入方式。请先读如何有效求助。安装器阶段没有 omv-sysinfo，把这些信息逐条写清楚即可。

参考资料

• OMV 官方文档：Installation via ISO image、系统要求
• omv-extras wiki：OMV 8 新手指南，其中有 UEFI 与首次启动的说明
• 本站：用 ISO 安装 OMV、系统盘坏了：重装并接回数据盘