Unraid 虚拟机添加声卡

413 字
2 分钟
Unraid 虚拟机添加声卡

概述#

本文介绍如何在 Unraid 虚拟机(KVM/QEMU)中添加虚拟声卡,并给出常见报错 XML error: audio ID 1 is used multiple times 的修复方法。

先决条件#

  • Unraid 已启用虚拟机功能(VM Manager)。
  • 目标虚拟机已创建,且你具备编辑其 XML 的权限。

操作步骤#

第一步:关闭虚拟机#

在 Unraid 的虚拟机页面,先停止目标虚拟机。

第二步:进入 XML 编辑模式#

  • 在 Unraid 的虚拟机管理界面中选择目标虚拟机。
  • 点击“编辑”。
  • 切换到“XML 视图/编辑模式”。

第三步:添加声卡设备节点#

  • 建议将声卡设备节点添加在视频节点(<video>)之后的位置,便于管理。
  • ich9 为例,插入如下片段:
<sound model='ich9'>
<address type='pci' domain='0x0000' bus='0x00' slot='0x1b' function='0x0'/>
</sound>
<audio id='1' type='none'/>
TIP
  • Windows 10/11 通常选择 ich9 更兼容;较老系统可尝试 ac97
  • 若同时使用 GPU 音频直通,避免与虚拟声卡冲突,可仅保留其一。

第四步:修复常见错误#

  • 报错:XML error: audio ID 1 is used multiple times
  • 含义:XML 中 audio 节点的 id 与现有设备重复(如已有 id='1')。
  • 解决:将 audioid 改为未使用的编号,例如:
<sound model='ich9'>
<address type='pci' domain='0x0000' bus='0x00' slot='0x1b' function='0x0'/>
</sound>
<audio id='2' type='none'/>
TIP

如果不确定已占用的 id,可在 XML 中搜索 <audio id='...'> 并选择未出现的编号。

第五步:保存与启动#

  • 保存 XML 修改。
  • 启动虚拟机,并在系统内确认设备是否识别(Windows 设备管理器 / aplay -l 等)。

参考#

Unraid 虚拟机添加声卡
https://lunary.cc/posts/unraid虚拟机添加声卡/
作者
鹤望兰
发布于
2025-06-17
许可协议
CC BY-NC-SA 4.0