libvirt添加NFS存储池本质是将远程NFS共享挂载为本地目录,并作为可管理的逻辑存储池,从中创建卷供虚拟机使用;需先手动验证NFS挂载,XML中type必须为netfs,含host/dir/format字段,挂载点target需提前创建并授权,启动后方可创建qcow2等格式卷。

libvirt 添加 NFS 作为存储池,本质是让 libvirt 在宿主机上挂载一个远程 NFS 共享,并把它当作一块“可管理的本地磁盘区域”来用——不是直接共享文件夹给虚拟机,而是把 NFS 目录变成存储池,再从中创建卷(volume)供虚拟机当磁盘用。
确认 NFS 服务端已导出且能手动挂载
这是最容易卡住的第一步。libvirt 不会帮你排 NFS 服务端的错,它只负责执行 mount。
- 在宿主机上先手动测试:
mount -t nfs 192.168.1.100:/export/vmstore /mnt/test,看是否成功;失败就别急着配 libvirt - 检查服务端
/etc/exports是否包含类似/export/vmstore *(rw,sync,no_root_squash)的条目,且运行了exportfs -ra - 确保防火墙放行 NFS 端口(
rpcbind、nfs、mountd),常见于 CentOS/RHEL 的firewalld或 openEuler 的ufw - 注意:NFS v4 是默认推荐,但若服务端只开 v3,libvirt 挂载时需显式指定版本,比如在 pool XML 的
<source>中加<host name='192.168.1.100' port='2049'/>并确保协议兼容
写对 NFS 存储池 XML 定义
libvirt 的 NFS 存储池类型是 netfs,不是 dir 或 logical。很多人抄错类型导致 virsh pool-define 报 XML error 或启动失败。
- 关键字段必须齐全:
<pool type='netfs'>、<source>下含<host>和<dir>、<format type='nfs'/> - 示例(保存为
nfs_pool.xml):
<pool type='netfs'>
<name>nfs_vmstore</name>
<source>
<host name='192.168.1.100'/>
<dir path='/export/vmstore'/>
<format type='nfs'/>
</source>
<target>
<path>/var/lib/libvirt/nfs_vmstore</path>
</target>
</pool>
-
<target><path>是 libvirt 在本机创建的挂载点,必须提前mkdir -p并确保libvirt用户(通常是root)有读写权限 - 不要把
<dir path>(服务端路径)和<target><path>(本地挂载点)写反,这是新手高频错误
定义、启动并设为自动挂载
顺序不能乱:先定义(register),再启动(mount),最后设 autostart(开机挂载)。中间任意一步失败,virsh pool-info 都会显示 inactive 或报错。
- 定义:
virsh pool-define nfs_pool.xml - 启动:
virsh pool-start nfs_vmstore—— 此时 libvirt 才真正执行mount -t nfs ... - 设自动启动:
virsh pool-autostart nfs_vmstore - 验证:
virsh pool-info nfs_vmstore应显示State: running,且mount | grep nfs_vmstore能看到对应挂载项 - 如果启动失败,查日志:
journalctl -u libvirtd -n 50 -f,常见错误如Failed to mount filesystem或Permission denied,基本都指向 NFS 权限或网络连通性问题
后续使用:卷(volume)才是给虚拟机用的“磁盘”
存储池只是容器,虚拟机实际用的是从池里创建的 volume。NFS 池支持创建 file-based 卷(如 qcow2 镜像),但不支持直接分配裸设备(block device)。
- 创建一个 20G 的 qcow2 卷:
virsh vol-create-as nfs_vmstore vm1_disk.qcow2 20G --format qcow2 - 查看卷路径:
virsh vol-path vm1_disk.qcow2 nfs_vmstore,输出类似/var/lib/libvirt/nfs_vmstore/vm1_disk.qcow2 - 把这个路径填进虚拟机 XML 的
<source file='...'>,或者用virt-install --disk path=...指定 - ⚠️ 注意:NFS 上的 qcow2 性能不如本地存储,且不支持某些高级操作(如 live snapshot),生产环境建议配合
sanlock做并发保护,否则多节点同时写同一镜像会损坏数据
最常被忽略的一点:NFS 存储池本身不提供锁机制。如果用它做迁移或集群虚拟机,必须额外配置 sanlock 或启用 NFSv4.1+ 的 delegations,否则两个节点同时操作同一个 volume 文件,分分钟丢数据。

















