概述

本教程介绍如何在 FnOS（飞牛NAS）上使用 virtio-9p（Plan 9）协议将宿主机目录共享到 KVM 虚拟机中。9p 是一种轻量级的文件共享协议，无需网络配置，通过 virtio 总线直接在宿主机和虚拟机之间传输文件，性能优于 NFS/Samba 等网络共享方案。

适用场景

• 宿主机与虚拟机之间共享文件/模板
• 虚拟机访问宿主机上的大容量存储
• 多台虚拟机共享同一目录（如模板库、ISO 仓库等）

环境要求

操作步骤

第一步：确认宿主机共享目录存在

确保要共享的目录已创建，以 /vol1/1000/templates 为例：

ls -ld /vol1/1000/templates

如果目录不存在，先创建：

sudo mkdir -p /vol1/1000/templates

第二步：修复目录权限

QEMU 进程以 libvirt-qemu 用户运行，需要确保从根目录到共享目录的整条路径链都有可访问权限：

sudo chmod 755 /vol1 /vol1/1000 /vol1/1000/templates

⚠️ 关键：即使共享目录本身权限正确，如果上级目录（如 /vol1 或 /vol1/1000）缺少 o+x 权限，QEMU 仍然无法访问，会报 Permission denied 错误。

第三步：关闭虚拟机

9p 设备需要在虚拟机配置中添加，修改配置前必须先关闭虚拟机：

sudo virsh shutdown <虚拟机名称>

如果虚拟机未响应 shutdown，可以强制关闭：

sudo virsh destroy <虚拟机名称>

确认已关闭：

sudo virsh list --all | grep <虚拟机名称>

第四步：添加 9p 共享设备（一键命令）

使用以下一键命令将 9p 文件系统设备注入到虚拟机 XML 配置中：

VM_NAME="ubuntu24-clone-01"
SHARE_DIR="/vol1/1000/templates"
SHARE_TAG="templates_share"

virsh dumpxml $VM_NAME > /tmp/${VM_NAME}.xml && \
sed -i "/<\/devices>/i \    <filesystem type=\"mount\" accessmode=\"passthrough\">\n      <driver type=\"path\"\/>\n      <source dir=\"${SHARE_DIR//\//\\/}\"\/>\n      <target dir=\"${SHARE_TAG}\"\/>\n    <\/filesystem>" /tmp/${VM_NAME}.xml && \
virsh define /tmp/${VM_NAME}.xml && \
rm -f /tmp/${VM_NAME}.xml

输出：

Domain 'ubuntu24-clone-01' defined from /tmp/ubuntu24-clone-01.xml

参数说明：

XML 配置解读：

添加到 <devices> 内的配置如下：

<filesystem type="mount" accessmode="passthrough">
  <driver type="path"/>
  <source dir="/vol1/1000/templates"/>
  <target dir="templates_share"/>
</filesystem>

第五步：启动虚拟机

sudo virsh start <虚拟机名称>

第六步：虚拟机内挂载共享目录

通过 SSH 或 VNC 进入虚拟机，执行以下操作：

1. 加载 9p 内核模块（通常已自动加载）：

sudo modprobe 9p
sudo modprobe 9pnet
sudo modprobe 9pnet_virtio

2. 创建挂载点：

sudo mkdir -p /mnt/templates

3. 挂载共享目录：

sudo mount -t 9p -o trans=virtio,version=9p2000.L templates_share /mnt/templates

⚠️ 注意：templates_share 是第四步中设置的 SHARE_TAG 标签名，必须与配置中的 <target dir="..."/> 完全一致，否则会报 no channels available 错误。

4. 验证挂载：

ls /mnt/templates
df -h /mnt/templates
mount | grep 9p

正常输出示例：

templates_share on /mnt/templates type 9p (rw,relatime,sync,dirsync,access=client,trans=virtio)

第七步：设置开机自动挂载（可选）

将挂载配置写入 /etc/fstab，实现开机自动挂载：

echo 'templates_share /mnt/templates 9p trans=virtio,version=9p2000.L,_netdev 0 0' | sudo tee -a /etc/fstab

验证 fstab 配置是否正确（不会实际挂载，只检查语法）：

sudo mount -a

fstab 参数说明：

accessmode 模式对比

如果使用 passthrough 模式遇到权限问题，可以切换为 mapped-xattr：

VM_NAME="ubuntu24-clone-01"

virsh dumpxml $VM_NAME > /tmp/${VM_NAME}.xml && \
sed -i 's/accessmode="passthrough"/accessmode="mapped-xattr"/' /tmp/${VM_NAME}.xml && \
virsh define /tmp/${VM_NAME}.xml && \
rm -f /tmp/${VM_NAME}.xml

共享多个目录

可以同时共享多个目录，每个目录使用不同的标签名。重复第四步，修改变量即可：

# 共享第二个目录
VM_NAME="ubuntu24-clone-01"
SHARE_DIR="/vol1/1000/isos"
SHARE_TAG="isos_share"

virsh dumpxml $VM_NAME > /tmp/${VM_NAME}.xml && \
sed -i "/<\/devices>/i \    <filesystem type=\"mount\" accessmode=\"passthrough\">\n      <driver type=\"path\"\/>\n      <source dir=\"${SHARE_DIR//\//\\/}\"\/>\n      <target dir=\"${SHARE_TAG}\"\/>\n    <\/filesystem>" /tmp/${VM_NAME}.xml && \
virsh define /tmp/${VM_NAME}.xml && \
rm -f /tmp/${VM_NAME}.xml

虚拟机内挂载：

sudo mkdir -p /mnt/isos
sudo mount -t 9p -o trans=virtio,version=9p2000.L isos_share /mnt/isos

删除 9p 共享

如果不再需要共享，执行以下步骤：

1. 虚拟机内卸载：

sudo umount /mnt/templates

如果设置了自动挂载，还需删除 fstab 中对应行：

sudo sed -i '/templates_share/d' /etc/fstab

2. 宿主机上移除 9p 设备：

VM_NAME="ubuntu24-clone-01"

virsh dumpxml $VM_NAME > /tmp/${VM_NAME}.xml && \
sed -i '/<filesystem type="mount"/,/<\/filesystem>/d' /tmp/${VM_NAME}.xml && \
virsh define /tmp/${VM_NAME}.xml && \
rm -f /tmp/${VM_NAME}.xml

⚠️ 注意：上面的命令会删除所有 9p 共享。如果只想删除特定的共享，建议使用 virsh edit 手动编辑。

常见问题

Q1: 挂载时报 no channels available for device xxx

原因：标签名不匹配或拼写错误。

解决：确认虚拟机 XML 中 <target dir="..."/> 的值与 mount 命令中的设备名完全一致：

# 查看配置中的标签名
virsh dumpxml <虚拟机名称> | grep "target dir"

Q2: 启动虚拟机报 Permission denied

原因：QEMU 进程无权访问共享目录或其上级目录。

解决：确保整条路径链都有可执行权限：

sudo chmod 755 /vol1 /vol1/1000 /vol1/1000/templates

或者改用 mapped-xattr 模式（参见上方 accessmode 模式对比章节）。

Q3: 虚拟机内无法写入共享目录

原因：passthrough 模式下，虚拟机内用户的 UID/GID 需与宿主机上文件的权限匹配。

解决方案：

• 方案一：在宿主机上对共享目录设置宽松权限 chmod 777
• 方案二：确保虚拟机内用户 UID 与宿主机目录 owner 一致
• 方案三：改用 mapped-xattr 模式

Q4: 9p 性能不如预期

优化建议：

• 挂载时添加 cache=loose 选项提升读取性能（适合只读场景）：

  sudo mount -t 9p -o trans=virtio,version=9p2000.L,cache=loose templates_share /mnt/templates
  

• 挂载时添加 msize=262144 增大传输块大小：

  sudo mount -t 9p -o trans=virtio,version=9p2000.L,msize=262144 templates_share /mnt/templates