One-KVM Rust（基于 RK3566）扩展存储教程：加装硬盘存放系统镜像
为什么要装硬盘
本设备自带的存储空间约 8G（实际可用 5G 左右），用来装 Windows、Ubuntu 等系统镜像（ISO 文件）很快就会放不下。
给设备外接一块大硬盘后，就能在设备的网页管理界面里，把几个 GB 甚至几十 GB 的镜像都存上去、随时挂载使用。
本教程只需在设备终端里敲几条命令，不改系统、不动原有配置，约 3 分钟完成。
准备与提醒
- 需要一块硬盘（机械盘或固态盘均可），容量越大能存的镜像越多
- 第一次用这台设备？请先阅读新手教程：（含接线、登录网页后台、打开网页终端、设置静态 IP）
本教程的所有命令都在网页后台的终端里执行：
- 浏览器打开
http://<设备IP>:8080，用账号密码登录（初始为admin/admin） - 进入左侧 终端 Terminal 页面（网页自带终端，进去就是管理员权限，无需电脑端 SSH）
- 在终端里逐条复制执行下面的命令
- 浏览器打开
- 如果你的硬盘是已经用过的旧盘，格式化会清空里面所有数据，操作前请确认数据已备份
- 本教程以硬盘被识别为
sda为例；若你的盘显示为sdb等，把命令里的sda换成对应的名字即可（第 1 步能看到）
术语小抄（先看 30 秒）
| 术语 | 含义 |
|---|---|
| ISO | 系统镜像文件，如 ubuntu.iso、win11.iso，本质就是一张"虚拟光盘" |
| MSD | 设备网页里的"镜像存储/挂载"功能，把 ISO 模拟成 U 盘或光驱插给被控电脑 |
| 被控机 | 被你这台 KVM 设备远程控制的电脑 |
| 挂载 | 把硬盘"接到"系统某个目录上；接好后，往该目录放文件 = 存进硬盘 |
| eMMC | 设备自带的板载小存储，不用管它 |
第 1 步：确认硬盘已被识别
在终端执行：
lsblk对照输出，会出现两种情况：
情况 A —— 硬盘已经能用（看到类似下面的行，sda1 那行 FSTYPE 是 ext4）：
sda 238.5G
└─sda1 238.5G ext4→ 跳过格式化，直接去第 2 步。
情况 B —— 新盘 / 没格式化的盘（只能看到 sda，没有 sda1，或 sda1 那行没有 ext4）：
→ 需要先分区并格式化，见下面的"红色警告"和命令。
红色警告（只有情况 B 才执行，会清空整块盘）
下列命令会把
/dev/sda这块盘彻底清空。执行前务必：
- 用上面的
lsblk再看一眼，确认sda就是你要装的那块外接新盘- 系统盘是
mmcblk0（型号那串），永远不要对mmcblk0执行下面的命令- 确定盘里没有任何要保留的数据
# 第一步：给整块盘建一个分区
echo -e "n\np\n1\n\n\nw" | fdisk /dev/sda
# 第二步：格式化成设备能识别的格式（ext4）
mkfs.ext4 /dev/sda1第 2 步：把硬盘挂载到镜像存储目录
mount /dev/sda1 /etc/one-kvm/msd这一步做什么：把硬盘接到 one-kvm 存放镜像的目录上。接好后，你在网页上传的镜像就会存进这块大硬盘，不再占用设备的板载小空间。
验证一下是否成功（看到 MOUNTPOINT 那一列出现 /etc/one-kvm/msd 即成功）：
lsblk /dev/sda
df -h /etc/one-kvm/msd # 容量应显示为硬盘的实际大小，如 200G第 3 步：设为开机自动挂载（必做）
不设置的话，设备一重启硬盘就"掉线"，需要重新手动挂载。以下命令会自动完成设置，无需手抄：
echo "UUID=$(blkid -s UUID -o value /dev/sda1) /etc/one-kvm/msd ext4 defaults,nofail 0 0" >> /etc/fstab说明：UUID是这块硬盘的唯一身份证，系统靠它认出硬盘；nofail表示万一硬盘没接好，设备开机也不会卡住，能正常启动。
验证配置正确：
umount /etc/one-kvm/msd && mount -a && lsblk /dev/sda第 4 步：重启功能并确认
systemctl restart one-kvm
systemctl is-active one-kvm # 显示 active 即正常想要彻底确认开机自挂：重启整台设备（在网页终端输入 reboot 即可）。注意：重启后网页会断开，属正常现象，等一两分钟重新打开网页后台即可。起来后执行：
findmnt /etc/one-kvm/msd # 有输出 = 硬盘自动挂上了
systemctl is-active one-kvm # active = 功能正常开始使用
浏览器打开设备的网页管理地址：http://<设备IP>:8080（设备 IP 以实际为准，不知道可问交付方；找不到设备 IP 可参考
进入左侧 MSD 页面，即可：
- 上传镜像：把本地的 ISO 文件传上去，会自动存进新硬盘
- 选择/挂载镜像：选一个 ISO 模拟成 U 盘或光驱，"插"给被控电脑
之后可以上传几个 GB 的大镜像，不会再受板载 8G 空间限制。
补充：通过网页上传的镜像会存在硬盘的images/目录下（首次上传时自动创建）。如果你想用文件传输工具直接拷 ISO，也请放进这个images/目录，网页里才能看到。
常见问题
Q：重启后硬盘没自动挂上？
A：多半是第 3 步没执行成功。执行 mount -a 看报错信息，或重新执行第 3 步的命令。确认命令里的分区名是 sda1（不是 sda）。
Q：MSD 页面看不到我拷进去的 ISO？
A：确认文件在 /etc/one-kvm/msd/images/ 目录下（不是根目录），且文件名以 .iso 结尾。直接网页上传最省事。
Q：这块盘之前装过镜像功能，现在加新硬盘会不会冲突？
A：不会。挂载只是把新硬盘接到镜像目录，原数据仍保留在设备板载存储里；拔掉新硬盘即可恢复原样。
Q：以后想不装这块硬盘了，怎么恢复？
A：执行 umount /etc/one-kvm/msd，再把第 3 步写入的那一行从系统配置里删掉即可。
Q：装完发现硬盘里没有我想要的空间？
A：df -h /etc/one-kvm/msd 查看剩余空间。如果显示的是设备自带的小容量，说明挂载没生效，回到第 2 步重新挂载。
