Proxmox VE 硬盘直通完全指南 💾

🚀 本指南详细介绍在 PVE 中将物理硬盘直通给虚拟机的三种主流方法，涵盖 RDM 直通、控制器直通和 NVMe 直通，适用于各种使用场景和性能需求。无论您是家庭用户还是企业环境，都能找到适合的方案！

📋 导航目录

✨ 指南特点

  • ✅ 三种直通方法全面覆盖
  • 🔧 详细命令示例和参数说明
  • ⚡ 性能优化建议
  • 🛡️ 安全注意事项
  • 🎯 实际应用场景推荐

参考教程： https://foxi.buduanwang.vip/virtualization/1754.html/

🎯 方法一：简单硬盘直通

1. 📦 更新环境并安装工具

1
2
3
# 更新软件源并安装必要工具
apt-get update && apt-get install lshw
# 安装硬件信息查看工具，帮助识别磁盘设备

2. 🔍 查看硬盘信息

1
2
3
4
# 列出所有硬盘的 ID 信息
ls -l /dev/disk/by-id/
# 查找 ata- 开头的硬盘 ID（适用于 SATA 硬盘）
# 查找 nvme- 开头的硬盘 ID（适用于 NVMe 硬盘）

3. 🎯 直通硬盘到虚拟机

1
2
3
4
5
6
# 将硬盘直通到指定虚拟机
qm set 101 --sata4 /dev/disk/by-id/ata-WDC_WD10EZEX-08RKKA0_WD-WCC1S4752100
# 参数说明：
# 101: 虚拟机ID
# sata4: SATA接口位置(0-5)
# ata-...: 硬盘的唯一标识ID

💡 提示：

  • 使用 /dev/disk/by-id/ 下的设备标识，而不是 /dev/sdX，避免设备名变化导致的问题
  • 可以通过 qm config <VMID> 查看当前虚拟机配置

🔧 方法二：映射直通单块硬盘

1. 📋 查看磁盘 ID 信息

1
2
3
4
# 详细查看所有磁盘标识信息
ls -l /dev/disk/by-id/
# 过滤显示物理硬盘（排除分区和逻辑卷）
ls -l /dev/disk/by-id/ | grep -v part | grep -v wwn

2. 📝 直通命令语法

1
2
# 通用直通命令格式
qm set <vm_id> --<disk_type>[n] /dev/disk/by-id/<disk_identifier>

3. ✅ 实际示例

1
2
3
4
5
# 示例：直通希捷硬盘到虚拟机 102 的 sata2 接口
qm set 102 --sata2 /dev/disk/by-id/ata-ST4000VX000-2AG166_ZGY163KG

# 示例：直通 NVMe 硬盘到虚拟机 103 的 scsi0 接口
qm set 103 --scsi0 /dev/disk/by-id/nvme-Samsung_SSD_970_EVO_Plus_1TB_S5GXNS0N123456

4. 📊 接口类型说明

接口类型 最大设备数 性能等级 推荐用途 特点
--scsiX 13 🚀 最佳 高性能需求 支持 TRIM，最佳性能
--sataX 6 ⚡ 良好 普通存储 兼容性好
--ideX 4 🐢 一般 兼容旧系统 传统接口，性能较低

⚡ 方法三：高级直通方式

1. 🔄 RDM (裸磁盘映射)

特点：

  • ✅ 不需要开启 IOMMU
  • 🔧 纯软件实现，兼容性好
  • 💾 虚拟机内识别为 VirtIO 或 SCSI 设备
1
2
# 列出可用物理硬盘（排除 LVM 和分区）
ls -la /dev/disk/by-id/ | grep -v dm | grep -v lvm | grep -v part

2. 🎯 RDM 直通示例

1
2
3
4
5
# NVMe 硬盘直通为 VirtIO 设备（性能最佳）
qm set 101 --virtio2 /dev/disk/by-id/nvme-INTEL_SSDPE2KX020T8_BTLJ039307142P0BGN

# SATA 硬盘直通为 SCSI 设备
qm set 101 --scsi3 /dev/disk/by-id/ata-WDC_WD10EZEX-08RKKA0_WD-WCC1S4752100

3. ❌ 取消直通配置

1
2
3
# 删除直通的硬盘设备
qm set 101 --delete scsi1
# 成功返回: update VM 101: -delete scsi1

4. 🎛️ 控制器直通（高级）

特点：

  • 🎯 直通整个磁盘控制器
  • 💡 获得完整的硬盘属性（包括 SMART）
  • ⚠️ 需要多个磁盘控制器和支持 IOMMU
1
2
3
# 查看可用磁盘控制器
lspci | grep -i "sata\|scsi\|nvme"
# 示例输出: 01:00.0 SATA controller: Intel Corporation C610/X99 series chipset sSATA Controller

5. 🔗 查看硬盘与控制器关系

1
2
3
4
# 查看硬盘设备路径和控制器的关联
ls -la /sys/block/sd*/device
# 使用 tree 命令查看更清晰的层次结构
apt install tree && tree /sys/block/sda/device/

🔥 NVMe 直通特殊配置

1. 💾 普通 NVMe 直通

1
2
3
4
# 查看 NVMe 设备信息
lspci | grep -i nvme
nvme list
# 显示详细的 NVMe 设备信息和命名空间

2. ⚙️ 特殊固件处理

对于某些 OEM NVMe 设备，可能需要额外配置：

1
2
3
# 在虚拟机配置文件(/etc/pve/qemu-server/XXX.conf)中添加参数
args: -set device.hostpci0.x-msix-relocation=bar2
# 这可以解决某些 NVMe 设备的 MSI-X 中断问题

配置说明：

  • hostpci0: PCIe 设备编号（根据实际情况调整）
  • x-msix-relocation=bar2: MSI-X 中断重定位到 BAR2
  • 需要先启用 IOMMU 支持

3. 🛠️ IOMMU 配置

1
2
3
4
5
6
7
8
9
# 编辑 GRUB 配置启用 IOMMU
nano /etc/default/grub
# 在 GRUB_CMDLINE_LINUX_DEFAULT 中添加：
# Intel: intel_iommu=on iommu=pt
# AMD: amd_iommu=on iommu=pt

# 更新 GRUB
update-grub
reboot

🚀 从直通硬盘引导系统

1. 🪟 Windows 系统引导

UEFI 引导配置

1
2
3
4
# 虚拟机配置要求
bios: ovmf
efidisk0: local-lvm:vm-101-disk-0,size=4M
tpmstate0: local-lvm:vm-101-disk-1,size=4M

Legacy BIOS 引导

1
2
3
# 传统 BIOS 引导配置
bios: seabios
boot: order=sata0

2. 🎯 驱动程序配置

1
2
3
4
# 对于 Windows 系统，建议使用 VirtIO 驱动
scsihw: virtio-scsi-single
# 下载 VirtIO 驱动镜像并加载
ide2: local:iso/virtio-win.iso,media=cdrom

3. 📋 引导顺序设置

1
2
3
4
# 修改引导顺序，从直通硬盘启动
qm set 101 --boot order='scsi0'
# 设置启动超时
qm set 101 --boot timeout=5000

4. 🐧 Linux 系统引导

1
2
3
4
5
# Linux 通常对直通硬盘支持更好
# 确保内核包含必要的驱动模块
# 检查驱动加载
lsmod | grep nvme
lsmod | grep ahci

⚠️ 重要注意事项

1. 🛡️ 安全警告

1
2
3
# 切勿直通包含 PVE 系统的硬盘控制器！
lsblk -f | grep -E "(pve-root|pve-data)"
# 确认系统所在硬盘，避免直通后导致主机无法启动

2. ⚡ 性能优化

1
2
3
4
5
6
7
8
9
# 使用 VirtIO SCSI 接口获得最佳性能
qm set 101 --scsihw virtio-scsi-single

# 启用 IO 线程和写入缓存
qm set 101 --iothread 1
qm set 101 --cache writeback

# 启用 discard（TRIM）支持
qm set 101 --discard on

3. 💾 备份策略

1
2
3
4
5
6
# 直通前务必备份重要数据
# 使用 dd 或 rsync 进行完整备份
dd if=/dev/disk-id of=/path/to/backup.img bs=4M status=progress

# 或者使用专业备份工具
apt install clonezilla

4. 🔧 故障排除

1
2
3
4
5
6
7
8
# 检查直通状态和配置
qm config 101 | grep -E "(scsi|sata|virtio)"

# 查看虚拟机日志和错误信息
journalctl -u pvedaemon --since "10 minutes ago"

# 检查磁盘健康状态
smartctl -a /dev/disk/by-id/your-disk-id

📊 方法对比总结

特性 RDM 直通 控制器直通 NVMe 直通
配置难度 🟢 简单 🟡 中等 🟡 中等
性能 🟢 优秀 🟢 优秀 🟢 最佳
功能完整性 🟡 部分 🟢 完整 🟢 完整
系统要求 🟢 无特殊要求 🟡 需要IOMMU 🟡 需要IOMMU
推荐场景 单硬盘直通 多硬盘阵列 高性能NVMe存储
SMART支持 ❌ 不支持 ✅ 支持 ✅ 支持

💡 最佳实践建议

1. 🏭 生产环境部署

1
2
3
4
# 1. 先在测试环境充分验证
# 2. 确保有完整的数据备份和恢复方案
# 3. 逐步迁移，先非关键业务后关键业务
# 4. 建立监控和告警机制

2. 📈 性能监控

1
2
3
4
5
6
7
8
# 安装性能监控工具
apt install iotop htop nvme-cli

# 监控磁盘 IO 性能
iostat -x 1

# NVMe 特定监控
nvme smart-log /dev/nvme0n1

3. 🤖 自动化脚本示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
#!/bin/bash
# 自动直通脚本示例
VM_ID=$1
DISK_ID=$2
INTERFACE=$3

# 验证参数
if [ -z "$VM_ID" ] || [ -z "$DISK_ID" ] || [ -z "$INTERFACE" ]; then
    echo "用法: $0 <虚拟机ID> <磁盘ID> <接口>"
    exit 1
fi

# 执行直通操作
if qm set $VM_ID --$INTERFACE /dev/disk/by-id/$DISK_ID; then
    echo "✅ 硬盘 $DISK_ID 已成功直通到虚拟机 $VM_ID 的 $INTERFACE 接口"
else
    echo "❌ 直通失败，请检查参数和权限"
    exit 1
fi

4. 🔄 迁移策略

1
2
3
4
5
6
7
8
# 对于正在使用的硬盘，建议：
# 1. 先创建完整备份
# 2. 在低负载时段进行迁移
# 3. 验证数据完整性
# 4. 更新文档和监控配置

# 使用 rsync 进行在线迁移
rsync -av --progress /source/path/ /destination/path/

🎯 总结建议： 通过以上三种方法，您可以根据实际需求选择最适合的硬盘直通方案。对于大多数用户，建议从简单的 RDM 直通开始，逐步尝试更高级的配置方式。记得始终遵循”先测试后生产”的原则，确保数据安全和系统稳定。

📞 需要帮助？

祝您在 PVE 虚拟化环境中使用愉快！🎉