Lima 磁盘管理完全指南：独立数据盘（limactl disk）与主磁盘扩容实战

本指南围绕 Lima 的磁盘管理能力展开：一方面讲解独立于任何实例、可在多个实例间共享且删除实例后依然保留的附加数据盘（additional disks），另一方面讲解通过 limactl edit --disk 扩容虚拟机主磁盘的方法。读完本文，你将掌握磁盘的创建、列出、挂载、扩容、删除、导入、解锁等完整操作，并理解 Lima 在底层如何格式化、挂载和自动扩增文件系统。

磁盘体系概述：主磁盘与附加磁盘

在 Lima 中，“磁盘”分为两类，理解它们的差异是正确使用的前提：

• 主磁盘（primary disk）：每个实例创建时自动生成，对应 YAML 中的顶层 disk 字段，存放根文件系统与全部系统数据，生命周期与实例绑定。
• 附加磁盘（additional disks）：由 limactl disk 子命令管理的独立块设备，数据存储于 Lima 配置目录下，独立于任何实例存在，可以跨实例共享，删除实例也不会影响其内容。

从配置结构看，主磁盘对应 pkg/limatype/lima_yaml.go 中的 Disk *string 字段（默认 100GiB，见 pkg/limayaml/default.yaml），而附加磁盘对应同文件中的 AdditionalDisks []Disk 字段，其元素结构为：

type Disk struct {
    Name   string   `yaml:"name" json:"name"` // REQUIRED
    Format *bool    `yaml:"format,omitempty" json:"format,omitempty"`
    FSType *string  `yaml:"fsType,omitempty" json:"fsType,omitempty"`
    FSArgs []string `yaml:"fsArgs,omitempty" json:"fsArgs,omitempty"`
}

即每个附加磁盘支持 name（必需）、format（是否首次格式化）、fsType（文件系统类型）与 fsArgs（额外格式化参数）四个配置项。

管理独立附加磁盘（limactl disk）

Lima 的 limactl disk 命令组提供对独立数据盘的完整生命周期管理。从源码看，该命令组在 cmd/limactl/disk.go 中注册了六个子命令：create、list、delete、unlock、resize、import，并归入 advancedCommand 分组。

列出磁盘

limactl disk list
# 或使用短别名：
limactl disk ls

list 命令在 cmd/limactl/disk.go 中定义，别名 ls 直接映射到同一命令。它输出 NAME / SIZE / FORMAT / DIR / IN-USE-BY 五列信息，其中：

• FORMAT 显示 qcow2 或 raw；
• DIR 是该磁盘在宿主机上的存储目录；
• IN-USE-BY 标记当前占用该磁盘的实例名，未被占用时为空。

还可以通过 --json 标志获得机器可读的输出，便于脚本化处理。磁盘的元数据（名称、大小、格式、目录、占用实例、挂载点）由 pkg/store/disk.go 中的 InspectDisk 通过读取磁盘镜像头部与 in_use_by 符号链接汇总得到。

创建磁盘

limactl disk create NAME --size SIZE [--format qcow2|raw]

支持的格式为 qcow2（默认）和 raw 两种。--size 是必填参数，接受 go-units 风格的大小字符串（如 20GiB、50G、1048576 字节）。

示例——创建一个名为 data、大小为 20 GiB 的磁盘：

limactl disk create data --size 20GiB

创建流程的源码实现在 cmd/limactl/disk.go：首先用 units.RAMInBytes 解析大小字符串，随后对 --format 做白名单校验（仅接受 qcow2 与 raw，否则直接报错）；接着检查同名磁盘是否已存在（重名会报错）；最后在 Lima 配置目录下创建磁盘目录（权限 0700）并调用 proxyimgutil.NewDiskUtil(ctx).CreateDisk 生成镜像文件。镜像文件在磁盘目录内的实际文件名是 datadisk，相关常量定义见 pkg/limatype/filenames/filenames.go。

磁盘实际存放在 Lima 配置目录下的 _disks/ 子目录中（常量 DisksDir = "_disks"，见 pkg/limatype/filenames/filenames.go），该目录是 Lima 的全局存储目录，不属于任何单个实例。

将磁盘挂载到实例

一个磁盘可以同时（或先后）被多个实例引用。以 data 磁盘为例，挂载方式有两种：

方式一：YAML 配置

在启动实例前，将磁盘名写入实例 YAML 的 additionalDisks 字段：

additionalDisks:
- name: data
  format: true     # 首次使用时格式化磁盘
  fsType: ext4     # format 为 true 时创建的文件系统类型

方式二：CLI 动态挂载

实例处于停止状态时，用 limactl edit 通过 YQ 表达式动态追加：

limactl edit <instance> --set '.additionalDisks += [{"name":"data"}]'

additionalDisks 的完整语义在 pkg/limayaml/default.yaml 中有说明：

• 列表元素既可以是纯字符串（磁盘名，等价于 - name: "data"），也可以是带参数的磁盘对象；
• 磁盘在实例内部以 lima-${VOLUME} 作为卷标（label），例如名为 data 的磁盘卷标为 lima-data；
• 磁盘在实例内部统一挂载到 /mnt/lima-${VOLUME}，例如 /mnt/lima-data。

从源码看，additionalDisks 的校验规则是：磁盘名必须通过 identifiers.Validate 校验（不能为空），见 pkg/limayaml/validate.go。format、fsType、fsArgs 三个字段均可选，缺省时 format 默认为 true、文件系统默认为 ext4；这一默认逻辑在 pkg/cidata/cidata.go 生成 cloud-init 参数时体现——format 为空则视为 true，fsType 为空则透传为空字符串，由后续启动脚本兜底为 ext4。

实例内部：格式化、挂载与自动扩增

附加磁盘在首次启动时由 Lima 注入的 cloud-init 启动脚本处理，核心逻辑在 pkg/cidata/cidata.TEMPLATE.d/boot.Linux/05-lima-disks.sh：

1. 首次格式化：若磁盘尚未打上 lima-${NAME} 卷标（即 [[ ! -b "/dev/disk/by-label/lima-${DISK_NAME}" ]]），且 format 为 true，则用 sfdisk 创建 GPT 分区表，再用 mkfs.$FSTYPE $FSARGS -L "lima-${DISK_NAME}" 格式化第一个分区。若 fsType 为 swap，则走 swap 专用分支：写入 type=swap 分区并用 mkswap 初始化，随后直接 swapon。
2. 挂载：普通文件系统场景下，创建挂载点 mkdir -p /mnt/lima-${DISK_NAME} 并以 mount -t $FSTYPE 挂载。
3. 自动扩增：脚本会尝试 growpart 扩充分区，再根据文件系统类型调用 resize2fs（ext2/ext3/ext4）或 xfs_growfs（xfs）自动扩展文件系统——这意味着你在宿主机上执行 limactl disk resize 后，实例重启即自动完成分区与文件系统层面的扩容，无需手工干预。

因此 fsType 的可用值至少包括常见 Linux 文件系统（ext4、xfs 等）以及特殊的 swap；文件系统工具必须存在于镜像内，否则格式化会失败。fsArgs 会原样传给 mkfs 命令，例如 -i size=512 可用于调节 inode 大小（pkg/limayaml/load_test.go 的测试用例正是用 xfs + fsArgs: ["-i", "size=512"] 验证这一透传行为）。

调整附加磁盘大小

limactl disk resize NAME --size NEW-SIZE

例如将 data 磁盘扩到 40 GiB：

limactl disk resize data --size 40GiB

resize 的实现在 cmd/limactl/disk.go，有几个关键约束值得注意：

• 只允许增大，不允许缩小：当目标大小小于当前大小时，直接报错 Disk shrinking is currently unavailable，因为收缩磁盘可能导致数据损坏；
• 运行中的实例不能调整：若磁盘正被某个运行中实例占用（disk.Instance 非空且实例状态为 Running），命令会拒绝执行并提示先停止 VM；
• 调整通过 proxyimgutil 的 ResizeDisk 完成，只修改磁盘镜像的元数据尺寸，文件系统的实际扩展由实例内的 05-lima-disks.sh 在下一次启动时自动完成（前文已述）。

删除磁盘

limactl disk delete NAME [NAME...]

可以一次删除多个磁盘，例如 limactl disk delete disk1 disk2。delete 命令还注册了 remove、rm 两个别名，并支持 -f/--force 强制删除标志，见 cmd/limactl/disk.go。

删除的保护机制值得注意（cmd/limactl/disk.go）：

• 磁盘被运行中实例占用时，非 --force 模式下会直接报错拒绝删除；
• 磁盘虽未被占用、但被某些非运行中实例在 YAML 中引用时，命令会跳过并警告这些引用实例，提示改用 limactl disk delete --force <NAME> 强制删除；
• --force 会绕过上述全部检查。

磁盘与实例的占用关系通过磁盘目录下的 in_use_by 符号链接记录：实例启动时 Lock 写入指向实例目录的符号链接，停止时 Unlock 移除，详见 pkg/store/disk.go。

导入与解锁（进阶操作）

limactl disk 还提供两个进阶子命令：

导入已有磁盘镜像：

limactl disk import DISK DISKPATH

将宿主机上现成的 qcow2/raw 镜像文件导入为 Lima 磁盘。实现见 cmd/limactl/disk.go：先用 qcow2reader.Open 探测镜像的类型与大小，仅接受 qcow2 与 raw，然后复制到磁盘目录下的 datadisk 文件。

解锁磁盘：

limactl disk unlock DISK [DISK...]

这是应急恢复命令：如果实例被强制停止（force stop），磁盘可能残留 in_use_by 锁而未真正被使用。unlock 会检查关联实例是否仍存在且处于运行状态，确认安全后才移除锁，见 cmd/limactl/disk.go。

调整虚拟机主磁盘大小

Lima 从 v1.1 起支持通过 limactl edit 的 --disk 标志直接修改已有实例的主磁盘大小，这是官方推荐的最简单方式：

limactl edit <vm-name> --disk <new-size>

示例——将 default 实例的主磁盘设为 20 GB：

limactl edit default --disk 20

该标志在 cmd/limactl/editflags/editflags.go 中定义：类型为 Float32，单位是 GiB，即 --disk 20 表示 20 GiB；同时注册了 shell 补全候选值 10 / 30 / 50 / 100 / 200。底层实现上，该标志会被翻译为 YQ 表达式 .disk = "20GiB" 写入实例配置（见 cmd/limactl/editflags/editflags.go），因此最终效果与直接编辑 YAML 顶层 disk 字段一致。

注意事项：

• 只支持增大，不支持缩小：减小磁盘尺寸不在支持范围内，且官方不推荐，存在数据损坏风险；
• 编辑前建议停止实例：实例可能需要在调整磁盘大小前处于停止状态；
• 主磁盘在实例内部同样存在文件系统扩展环节：启动脚本 pkg/cidata/cidata.TEMPLATE.d/boot.Linux/04-persistent-data-volume.sh 会通过 growpart + e2fsck + resize2fs 在引导阶段自动扩增数据卷（/mnt/data 及绑定挂载的持久化目录），保证扩容后的空间真正可用。

实践建议与典型工作流

基于上述机制，推荐以下实践模式：

1. 数据与系统分离：把数据库、容器卷、缓存等持久数据放进 additionalDisks 管理的独立磁盘，删除或重建实例不影响数据，多个实例还能按需共享同一块数据盘。
2. 共享磁盘注意并发：多个实例共享同一磁盘时，请务必停止其他实例再操作，避免多写者场景损坏文件系统；in_use_by 锁只保证“一个实例占用”，不提供并发写入一致性。
3. 扩容三步曲：先 limactl disk resize <disk> --size <new>（附加盘）或 limactl edit <vm> --disk <new>（主盘），再停止并重启实例，由实例内的启动脚本自动完成分区与文件系统扩增，最后通过 df -h 验证容量生效。
4. 删除前先确认引用：直接执行 limactl disk delete，若输出引用实例警告，说明该盘仍在某实例的 additionalDisks 中；先 limactl edit 移除引用，或确认数据无价值后用 --force。

总结

Lima 的磁盘体系将“实例”与“数据”解耦：limactl disk 提供独立数据盘的创建（create）、查看（list/ls）、挂载（YAML additionalDisks 或 limactl edit --set）、扩容（resize）、删除（delete，含 --force）、导入（import）与解锁（unlock）全生命周期管理；limactl edit --disk 则解决主磁盘扩容问题。二者在实例内部都由 cloud-init 启动脚本（05-lima-disks.sh 与 04-persistent-data-volume.sh）完成格式化、挂载与文件系统自动扩增，形成宿主机操作与客户机生效的闭环。希望本文能帮助你安全、高效地管理 Lima 虚拟机的存储资源。