外观
安装程序报错或找不到硬盘
适用范围
安装向导正在运行的时候出问题：界面异常、某一步报错终止、卡住不动，或者磁盘选择那一屏根本看不到目标硬盘。
不适用于：安装顺利完成、重启后引导失败，那是装完无法引导。
开始排查前
记下这几件事：
- 卡在哪一屏、报错的原始文字是什么（拍照或抄下来，别凭印象复述）。
- 用的哪个版本的安装 ISO，是不是已经校验过 SHA-256。
- 目标机器的存储控制器类型：板载 SATA、NVMe，还是带 RAID 功能的 HBA/RAID 卡。
- 这块硬盘之前是否装过别的系统、跑过 RAID 或者是二手盘。
排查步骤
1. 先确认镜像本身没问题
镜像下载不完整或写盘方式不对，是安装报错最常见的原因，而且现象五花八门（卡住、报奇怪的 Python 报错、分区失败）。
在另一台电脑上重新计算 SHA-256，和官网公布的值比对：
sh
shasum -a 256 proxmox-ve_9.x-x.iso校验值不一致 → 重新下载，重新按 DD 模式写盘，不要跳过这一步直接排查下面的内容。
校验值一致 → 镜像没问题，继续下一步。
2. 安装程序完全看不到任何硬盘
这种情况几乎总是存储控制器的工作模式问题，不是硬盘坏了：
| 现象 | 常见原因 | 处理方向 |
|---|---|---|
| NVMe 或 SATA 盘完全不显示 | 主板把控制器设成了 Intel RST / VMD 之类的私有 RAID 模式 | 进 BIOS 把该控制器改回 AHCI 模式 |
| 企业级 HBA/RAID 卡下没有盘 | 卡上没有配置任何逻辑盘(Virtual Disk) | 进 RAID 卡自己的配置界面（开机时的热键）先建立逻辑盘 |
| 软件 RAID(主板集成的伪 RAID) | Linux 内核不直接支持这类"假 RAID" | 关掉主板 RAID 功能，改用真正的硬件 RAID 卡或者不做硬件 RAID，交给 ZFS |
拿不准就先用 AHCI
Proxmox VE 自己的存储方案(ZFS、LVM)已经提供了软件层面的冗余和管理能力，不需要依赖主板的伪 RAID。遇到不确定的 RAID/AHCI 选项，优先选 AHCI，把冗余交给 PVE 自己的存储层去做。
3. 能看到部分硬盘，但看不到目标盘
先用系统日志确认硬件层面是否识别到了这块盘。安装程序的某些界面提供进入 Shell 的选项：
sh
# 在安装程序的调试 Shell 里(如果有)
dmesg | grep -i -E "nvme|sd[a-z]|ata"完全没有相关输出，说明这是硬件识别问题，可能是控制器太新、安装 ISO 内置的内核还不支持。可以尝试：
- 换一个更新的 Proxmox VE 安装 ISO 版本。
- 如果硬件确实太新，考虑走在 Debian 上安装 Proxmox VE的路线——用更新的 Debian 内核先把系统装起来，再叠加 PVE 软件源。
4. 分区或格式化阶段报错
如果程序能看到盘，选完盘之后在格式化/分区步骤报错，常见原因是盘上残留的旧 RAID 元数据或分区签名，和安装程序的分区工具冲突，尤其是二手盘或者之前跑过软件 RAID 的盘。
先只读确认：
sh
# 在安装程序或临时启动的 Live 环境里
wipefs -n /dev/sdX-n 是模拟运行，只显示会清除哪些签名，不会真的执行。看到 linux_raid_member、旧的 LVM2_member 之类的残留，基本能确认问题所在。
清除签名会让这块盘上的旧数据彻底不可读
真正执行(去掉 -n)会清空磁盘的分区表和文件系统/RAID 签名，而且不可撤销。确认这块盘上没有你还需要的数据之后再做：
sh
wipefs -a /dev/sdX执行前务必用 lsblk -o NAME,SIZE,MODEL,SERIAL 按容量、型号、序列号三重确认目标设备，不要只看 /dev/sdX 这种可能漂移的名字。
5. 界面花屏、黑屏或鼠标无响应
显卡兼容性问题。安装启动菜单里通常有一个**终端模式(Terminal UI)**的安装选项，功能和图形界面完全一样，只是渲染方式不同，绕开显卡驱动问题。
6. 长时间停在某个进度条不动
区分两种情况：
- 停在写盘验证/拷贝文件阶段超过合理时间（几分钟以上）：大概率是 U 盘本身读写慢或者接口问题，换个 USB 口（优先主板背后的口，前置面板口和 USB 集线器容易出问题）。
- 停在网络配置测试（比如 DHCP 探测）阶段：检查网线是否插好、交换机口是否正常，或者干脆先不接网线跳过网络自动配置，装完再手动配置。
7. 硬件太新，装完基础功能有问题（非硬盘识别类）
如果磁盘能装，但网卡、显卡等其他硬件在安装完成后表现异常，这已经不属于"安装程序报错"的范畴，属于装完之后的硬件兼容排查，可以参考硬件选型里对应的兼容性文章。
确认恢复
顺利走完安装向导的全部步骤，机器重启后：
- 按安装过程逐屏讲解的「检查结果」清单逐项核对。
- 能看到启动提示里显示的 Web UI 地址，并在浏览器里打开。
节点 → Disks里能看到全部物理磁盘，状态正常。
仍未解决
带上以下信息求助：
- 安装程序报错的原始文字或截图。
- 主板型号和存储控制器型号（板载 SATA/NVMe，或具体的 RAID 卡型号）。
- BIOS 里存储控制器当前的工作模式(AHCI/RAID/VMD)。
- 如果能进调试 Shell，附上
dmesg里和存储相关的部分。