Lima：跨平台的 Linux 虚拟机启动器 #

Lima 是什么？ #

Lima 是一款开源免费的命令行工具，可以在 macOS、Linux 和 Windows 主机上启动 Linux 虚拟机（Linux virtual machines），并自动完成文件共享与端口转发，使用体验与 Windows 上的 WSL2 十分相似。它的全称是 "Linux Machines"，最初围绕 macOS 用户需求设计，如今已扩展为跨平台方案。

Lima 的核心价值在于：让开发者无需复杂的虚拟机配置，就能在本地获得一个贴近原生体验的 Linux 环境，用于运行容器、Kubernetes、Docker、Podman、containerd，或任何需要 Linux 内核的开发工具链。Lima 是 CNCF（云原生计算基金会）孵化项目，已被 Colima、Rancher Desktop 等众多云原生工具作为底层虚拟化引擎采用，是云原生开发者社区的重要基础设施。

Lima 有哪些亮点特色？ #

• 一行命令启动 VM：通过 limactl start 即可拉取模板、下载镜像并自动完成虚拟机初始化，无需手动配置 QEMU 或驱动参数，新手也能快速上手。
• 自动文件共享与端口转发：默认将宿主机的用户目录挂载到虚拟机中（默认只读，可通过 --mount-writable 开启写权限），并自动转发端口，让本地访问虚拟机服务像访问本机服务一样简单。
• 多虚拟机驱动支持：内置 QEMU、macOS 的 VZ（Virtualization.framework）、Windows 的 WSL2 与 HCS，以及基于 KVM 的 Krunkit 等驱动，可在不同平台自动选择最优的虚拟化后端。
• 丰富模板生态：提供 Docker、Podman、Kubernetes、containerd、Apptainer、AI agents、Visual Studio Code、GitHub Actions 等大量开箱即用模板，并支持通过 GitHub 模板 URL 直接引入自定义配置。
• 完善的 CLI 命令集：limactl 提供 start、stop、shell、list、clone、delete、disk、network、snapshot、tunnel、autostart、validate 等完整命令，覆盖虚拟机的全生命周期管理。
• 高级网络与磁盘能力：支持 user-mode 网络、user-v2 网络、VMNet 网络、端口转发自定义，以及独立磁盘的创建、导入、扩容与解锁（limactl disk），满足复杂场景需求。
• 插件与扩展机制：支持 VM 驱动插件、CLI 插件、URL Handler 插件，可与 GPU 加速、AI Agent（含 MCP 工具、Gemini 集成）等生态无缝配合。
• CNCF 孵化开源项目：代码完全开源、社区活跃、文档完备，并被 Colima、Rancher Desktop 等知名项目采用，安全性与长期可维护性有保障。

免费下载 Lima #

以下为官方提供的各平台安装包，点击链接即可下载。

提示：本次提供的为 Lima 2.3.0-beta.1 测试版，如需稳定版本，建议访问 GitHub Releases 页面获取最新正式版。

Lima 如何使用？ #

1. 安装 Lima：根据操作系统选择对应安装方式（详见下文“如何安装”），安装完成后终端会新增 limactl 命令。
2. 启动第一个虚拟机：在终端执行 limactl start，会弹出交互式菜单，选择一个模板（默认 default 模板即可）后回车，Lima 将自动下载镜像并完成初始化。
3. 进入虚拟机：初始化完成后，用 limactl shell <实例名> 进入 Linux 环境，默认实例名通常为 default，可直接在其中执行 apt、dnf 等 Linux 命令。
4. 查看与管理实例：使用 limactl list 查看所有实例的状态与地址；使用 limactl stop <实例名> 停止，limactl start <实例名> 再次启动。
5. 使用容器模板：执行 limactl start template://docker 可快速创建内置 Docker 的虚拟机，Podman、Kubernetes、containerd 等只需替换模板名即可。
6. 配置自动启动（可选）：使用 limactl autostart enable <实例名> 可将实例注册为登录或系统启动时自动运行（macOS 支持 --condition=boot）。
7. 清理资源：使用 limactl delete <实例名> 删除不再需要的虚拟机实例，limactl prune 清理无用缓存。

Lima 的常见问题？ #

Lima 和 WSL2 有什么区别？ Lima 与 WSL2 在体验上类似，都会自动提供文件共享与端口转发，但 Lima 面向 macOS、Linux、Windows 多平台，且使用真正的 Linux 虚拟机（通过 QEMU/VZ/HCS 等驱动），而 WSL2 是微软为 Windows 提供的 Linux 子系统方案。

Lima 和 Docker Desktop、Colima 是什么关系？ Lima 本身是虚拟化引擎，Docker Desktop 在某些平台会使用 Lima，Colima 也是基于 Lima 构建的 Docker/容器的第三方封装工具。你可以直接使用 Lima，也可以使用 Colima 这类上层工具简化操作。

运行 Lima 需要安装 QEMU 吗？ 在 macOS 上默认可使用 VZ（Virtualization.framework），不一定需要 QEMU；但若使用 QEMU 驱动或在 Linux 上运行，则需要预先安装 QEMU。具体依平台与驱动选择而定。

默认挂载的目录为什么是只读的？ 出于安全考虑，Lima 默认以只读方式挂载宿主机用户目录，避免虚拟机内部误改宿主机文件。可通过 --mount-writable 或 --mount 参数指定可写目录。

Lima 是否支持中文或图形界面？ Lima 以命令行使用为主，支持的 guest OS 包括 Linux、macOS、Windows、FreeBSD，可通过 --video 参数开启视频输出（对 QEMU 有性能影响）。中文支持依赖 guest 系统本身的 locale 配置。

为什么有时启动很慢或卡在下载镜像？ 首次启动需下载 cloud 镜像，速度受网络影响。可提前设置镜像源，或在 default 模板中指定本地缓存路径，以加快后续启动速度。

Lima 如何安装？ #

macOS

1. 使用 Homebrew 安装：在终端执行 brew install lima。
2. 或从 GitHub Releases 下载对应架构的 .tar.gz 包，解压后将 limactl 等二进制文件放入 PATH 目录。
3. 安装完成后执行 limactl --version 验证是否成功。

Linux

1. 使用 Homebrew（Linux 版）安装：brew install lima。
2. 或从 GitHub Releases 下载 Linux 对应架构的压缩包，解压后把二进制文件放入 /usr/local/bin。
3. 部分发行版也提供社区包，可通过 apt、dnf 等安装（以官方文档为准）。

Windows

1. 推荐使用包管理器安装：winget install Lima，或使用 Scoop、Chocolatey 等。
2. 也可下载本次提供的 lima-2.3.0-beta.1-Windows-AMD64.zip 或 Windows-ARM64.zip，解压后把目录加入 PATH。
3. 安装后打开 PowerShell 或 Windows Terminal，执行 limactl --version 验证。

通用注意事项

• 安装前请确认已安装对应平台的虚拟化驱动（如 QEMU、WSL2 组件）。
• 若使用 beta 版本，遇到问题建议切换到 GitHub Releases 的稳定版。
• 首次运行 limactl start 需联网下载 guest 镜像，请确保网络通畅。

Lima 如何卸载？ #

macOS

1. 若通过 Homebrew 安装：执行 brew uninstall lima。
2. 若为手动解压安装：删除 limactl 等二进制文件，并清理 ~/Library/Caches/lima、~/.lima 等配置与虚拟机数据目录。
3. 如需彻底清理，可一并删除 ~/.cache/lima。

Linux

1. 使用包管理器卸载：brew uninstall lima 或对应发行版的卸载命令。
2. 手动安装的：删除 /usr/local/bin 下的 limactl 等文件。
3. 清理残留数据：rm -rf ~/.lima ~/.cache/lima。

Windows

1. 通过 winget uninstall Lima 卸载，或在“设置 → 应用”中找到 Lima 后卸载。
2. 手动解压安装的：直接删除对应目录及 PATH 中相关配置。
3. 清理残留：删除 %USERPROFILE%\.lima 与 %LOCALAPPDATA%\lima 等目录中的实例数据与缓存。

注意：卸载前请确认虚拟机中无重要数据；删除 ~/.lima 会一并清除所有实例与快照，操作前建议先备份。