PiKVM项目中的Mass Storage Drive功能详解-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00252/article/details/148419311

PiKVM项目中的Mass Storage Drive功能详解

pikvm Open and inexpensive DIY IP-KVM based on Raspberry Pi 项目地址: https://gitcode.com/gh_mirrors/pi/pikvm

概述

PiKVM的Mass Storage Drive（MSD）功能是一项强大的虚拟存储设备模拟技术，适用于所有PiKVM V2及以上版本的设备。该功能允许PiKVM为目标主机模拟虚拟CD/DVD或闪存驱动器，即使在BIOS/UEFI环境下也能使用，非常适合系统恢复或重装操作系统的场景。

功能特性

PiKVM的MSD功能提供以下核心能力：

多格式支持：可模拟CD/DVD或Flash Drive两种存储设备类型
远程管理：通过Web界面完成镜像上传、下载和连接管理
写入支持：Flash Drive模式下可允许目标主机写入数据
兼容性强：支持在BIOS/UEFI环境下使用

使用指南

基本操作流程

通过Web界面的"Drive"菜单上传镜像文件
选择需要连接的镜像
设置设备类型（CD/DVD或Flash）和写入模式
连接设备到目标主机
使用完成后断开连接

重要安全提示：

镜像上传过程中或目标主机以写入模式连接时，切勿切断PiKVM电源
其他情况下断电是安全的，因为PiKVM文件系统默认处于只读模式

设备类型切换注意事项

设备类型（CD/DVD与Flash）的切换需要重新连接设备才能生效：

PiKVM V3/V4：使用Web UI中的"System -> Connect main USB"开关
其他版本：需要重启目标主机或重新初始化驱动器

高级应用

手动上传镜像

PiKVM将镜像存储在专门的内存卡分区中，路径为/var/lib/kvmd/msd。该分区通常为只读模式，会在需要时自动重新挂载为可写模式。

手动上传步骤：

将内部存储重新挂载为读写模式：
```
kvmd-helper-otgmsd-remount rw
```
使用scp等工具上传镜像到/var/lib/kvmd/msd
将内部存储恢复为只读模式：
```
kvmd-helper-otgmsd-remount ro
```

可写闪存驱动器配置

要创建可写的Flash Drive镜像，需要预先准备文件系统镜像：

在PiKVM上创建FAT32镜像

创建空白镜像文件：

dd if=/dev/zero of=/var/lib/kvmd/msd/flash.img bs=1M count=512 status=progress

分区并格式化为FAT32：

loop=$(losetup -f)
echo -e 'o\nn\np\n1\n\n\nt\nc\nw\n' | fdisk /var/lib/kvmd/msd/flash.img
losetup -P $loop /var/lib/kvmd/msd/flash.img
mkfs.vfat ${loop}p1
losetup -d $loop
chmod 666 /var/lib/kvmd/msd/flash.img

在macOS上创建镜像

使用"磁盘工具"创建新镜像
设置格式为"MS-DOS(FAT)"，分区为"主引导记录"
保存后将.dmg重命名为.img
上传到PiKVM

使用时可启用"Writable"选项，目标主机写入的文件可在断开连接后下载镜像获取。

网络存储集成

NFS存储配置

安装NFS客户端工具：
```
pacman -S nfs-utils
```
创建挂载点：
```
mkdir -p /var/lib/kvmd/msd/NFS_Primary
```

编辑/etc/fstab添加NFS共享：

server:/srv/nfs/NFS_Primary /var/lib/kvmd/msd/NFS_Primary nfs vers=3,timeo=1,retrans=1,soft,nolock 0 0

重启应用更改

Samba/CIFS存储配置

安装CIFS工具：
```
pacman -S cifs-utils
```
创建挂载点：
```
mkdir -p /var/lib/kvmd/msd/isos
```

编辑/etc/fstab添加Samba共享：

//192.168.0.1/isos /var/lib/kvmd/msd/isos cifs guest,_netdev,nofail 0 0

重启应用更改

注意：使用exFAT格式的USB驱动器时，需在fstab中添加umask=0000选项确保可写权限。

多驱动器配置

PiKVM默认创建一个虚拟驱动器，但可通过配置添加更多驱动器：

编辑/etc/kvmd/override.yaml：

otg:
    devices:
        drives:
            enabled: true
            count: 1  # 额外驱动器数量
            default:
                cdrom: false
                rw: false