Terraform部署KVM虚拟机时qcow2文件权限拒绝问题解决

问题根源 #

Terraform下载的qcow2镜像文件默认属于执行Terraform的用户，但libvirt服务是用libvirt-qemu用户和用户组运行的，所以会出现权限不匹配导致的文件无法访问错误。

具体修复步骤 #

1. 修正现有镜像文件的权限 #

直接调整已下载的debian.qcow2文件权限，让libvirt-qemu组拥有读写权限：

sudo chgrp libvirt-qemu /var/lib/libvirt/images/debian.qcow2
sudo chmod g+rw /var/lib/libvirt/images/debian.qcow2

如果想让后续Terraform下载的镜像自动继承正确权限，给镜像目录设置默认ACL：

sudo setfacl -d -m g:libvirt-qemu:rw /var/lib/libvirt/images/

2. 把Terraform执行用户加入libvirt-qemu组 #

将运行Terraform的用户添加到libvirt-qemu组，确保后续操作生成的文件能自动适配权限：

sudo usermod -aG libvirt-qemu $USER
# 注销后重新登录才能生效

3. 验证libvirt服务配置（可选） #

检查/etc/libvirt/qemu.conf文件，确认以下配置项正确：

user = "libvirt-qemu"
group = "libvirt-qemu"
dynamic_ownership = 1

修改后重启libvirt服务：

sudo systemctl restart libvirtd

额外说明 #

• dynamic_ownership = 1配置会让libvirt自动调整虚拟机相关文件的权限，但如果Terraform下载文件时绕开了这个机制，还是需要手动调整权限或组归属。
• 确保/var/lib/libvirt/images/目录本身允许libvirt-qemu组访问，默认权限通常没问题，若有异常可执行：

sudo chmod g+rx /var/lib/libvirt/images/

内容的提问来源于stack exchange，提问作者HochWieBreit