# Multipass

Canonical 提供的本地 Ubuntu 虚拟机管理工具，支持命令行和图形界面。

> 这是 OpenNavo 上 Multipass 页面的 Markdown 版本，内容与网页相同： <https://opennavo.com/zh/apps/multipass>

- **最新版本**: `1.17.2`
- **开发者**: Canonical Ltd.
- **主页**: <https://github.com/canonical/multipass/>
- **分类**: [虚拟化与容器](https://opennavo.com/zh/categories/virtualization)
- **安装**: `brew install --cask multipass`
- **近 30 天安装**: 3,098
- **Homebrew**: 可以安装，由 Homebrew 更新
- **下载地址**: <https://github.com/canonical/multipass/releases/download/v1.17.2/multipass-1.17.2+mac-Darwin.pkg>
- **SHA-256**: `87bea28b67857eda23d61a5c5133dfd08da6bd082002d44585aa02bbb46dff0a`
- **安装包**: multipass-1.17.2+mac-Darwin.pkg

SHA-256 只用来核对下载的文件是否完整，不代表安全认证。

## 安装与卸载内容

```json
[
  {
    "declaration": {
      "uninstall": [
        {
          "delete": [
            "$HOMEBREW_PREFIX/etc/bash_completion.d/multipass",
            "/Applications/Multipass.app",
            "/Library/Application Support/com.canonical.multipass",
            "/Library/Logs/Multipass",
            "/usr/local/bin/multipass",
            "/usr/local/etc/bash_completion.d/multipass"
          ],
          "launchctl": "com.canonical.multipassd",
          "pkgutil": "com.canonical.multipass.*"
        }
      ]
    },
    "phase": "uninstall",
    "sources": [],
    "type": "uninstall"
  },
  {
    "declaration": {
      "pkg": [
        "multipass-1.17.2+mac-Darwin.pkg"
      ]
    },
    "phase": "install",
    "sources": [
      "multipass-1.17.2+mac-Darwin.pkg"
    ],
    "type": "pkg"
  },
  {
    "declaration": {
      "postflight_steps": [
        {
          "steps": [
            {
              "source": {
                "path": "/Library/Application Support/com.canonical.multipass/Resources/completions/bash/multipass"
              },
              "target": {
                "path": "{{HOMEBREW_PREFIX}}/etc/bash_completion.d/multipass"
              },
              "type": "symlink",
              "uninstall": true
            }
          ]
        }
      ]
    },
    "phase": "install",
    "sources": [],
    "type": "postflight_steps"
  },
  {
    "declaration": {
      "zap": [
        {
          "trash": [
            "~/Library/Application Support/com.canonical.multipassGui",
            "~/Library/Application Support/multipass",
            "~/Library/Application Support/multipass-gui",
            "~/Library/LaunchAgents/com.canonical.multipass.gui.autostart.plist",
            "~/Library/Preferences/multipass",
            "~/Library/Saved Application State/com.canonical.multipassGui.savedState"
          ]
        }
      ]
    },
    "phase": "cleanup",
    "sources": [],
    "type": "zap"
  }
]
```

## 介绍

Multipass 是 Canonical 用于在 macOS、Windows 和 Linux 上启动和管理本地 Ubuntu 虚拟机的工具。它提供命令行客户端和图形客户端，可创建开发环境，无需重新分区电脑或替换其操作系统。实例是一台完整的虚拟机，而不只是容器或远程云账户。

### 功能
- 查找可用的 Ubuntu 镜像并启动命名实例。
- 为每个环境选择虚拟 CPU、内存和磁盘分配。
- 打开 Ubuntu shell，或在实例中执行命令。
- 使用 cloud-init 配置可复现的开发和测试环境。
- 通过 CLI 或 GUI 检查、启动、停止和挂起实例。
- 传输文件，或将选定的主机目录挂载到客户机中。
- 在所选后端允许时，使用受支持的快照和克隆功能。

### 安装和首次使用
使用 `brew install --cask multipass` 安装此 Mac cask cask，或运行 Canonical 官方 Mac PKG 安装程序。安装需要管理员账户，并会安装后台 Multipass 服务和客户端。请查看操作系统针对安装程序和服务显示的提示，不要假设这只是一个便携应用。

安装后，`multipass find` 会列出可用镜像。可以用 `multipass launch --name dev` 创建第一个实例，用 `multipass list` 检查实例，并用 `multipass shell dev` 访问实例。这些是面向用户的操作说明：启动实例时，如有需要会下载镜像、占用本地资源并创建虚拟机存储。不需要实例时使用 `multipass stop dev`；删除或清除实例前请先检查实例。

根据客户机工作负载选择合适的资源分配，同时为 macOS 留出足够的内存和 CPU 容量。cloud-init 配置可以在客户机中安装软件包或运行命令；请使用来自可信来源的配置。将共享主机文件夹视为授予虚拟机的明确访问权限。只挂载客户机所需的数据；执行破坏性客户机操作或永久移除实例前，请备份重要文件。

### Mac 虚拟化和网络
Canonical 文档说明，默认 Mac 后端为使用 Apple Hypervisor 框架的 QEMU。根据所引用的安装指南，运行 macOS 10.15 Catalina 或更高版本的 Intel 和 M 系列 Mac 均受支持。Mac 软件包会处理相应的架构；客户机镜像和后端功能仍须与主机匹配。支持的情况下，VirtualBox 可作为替代后端，但必须单独安装和配置；默认 QEMU 方案不需要它。Windows Hyper-V 和 Linux LXD 的行为因平台而异，并非 Mac 的前置条件。

实例使用虚拟网络，并可建立出站连接。桥接网络和主机文件夹挂载需要有意配置，且可能开放额外访问权限；请根据环境检查网络选项和服务身份验证。Multipass 不是 VPN，也不是能让任意不可信工作负载变安全的安全边界。特权守护进程、其身份验证以及客户机与主机之间的文件共享，都应像其他虚拟化软件一样谨慎处理。

Multipass 运行本地 Ubuntu 虚拟机不需要 Docker Desktop 或付费云账户。需要时，可在合适的客户机中安装 Docker 或其他开发工具；这是单独的安装。即使没有已声明的 cask 冲突，同时运行多个虚拟化工具也可能争用内存、磁盘和网络资源。

### 要求和下载
此 cask 安装 Mac 发行版；Windows 和 Linux 有单独的安装程序。根据官方 GitHub 发行版资源和安装程序 HTTP 元数据，当前 1.16.4 Mac PKG 的大小为 152,440,298 字节。安装程序大小不包括 Ubuntu 镜像、虚拟磁盘、快照和项目数据。没有为所有工作负载统一规定的主机内存或已安装空间最低要求。请为每台虚拟机预留额外存储和内存，并确保网络可用于首次下载镜像和获取更新。

请分别更新 Multipass 本身和客户机操作系统。新的 Multipass 发行版并不意味着每个现有 Ubuntu 实例都已安装自身的安全更新。1.16.3 发行版专门修复了 Mac M4 上的 QEMU 兼容性问题；1.16.2 发行版修复了 macOS Tahoe 26 vmnet 子网冲突。在受影响的系统上使用时，请优先选择当前受支持的发行版。

### 价格和许可
Multipass 是 Canonical 提供的免费开源软件，采用 GPL 版本 3；第三方组件仍遵循其各自的声明和许可。基本的本地虚拟机管理无需购买、订阅或强制使用在线账户。可选的 Ubuntu 支持、外部云服务以及安装在客户机中的软件，可能需要单独的账户、许可并产生费用。安装 Multipass 并不等于购买这些服务。

来源：[官方产品](https://canonical.com/multipass)、[安装和先决条件](https://canonical.com/multipass/docs/stable/how-to-guides/install-multipass/)、[源代码仓库](https://github.com/canonical/multipass)、[官方发行版](https://github.com/canonical/multipass/releases)。

## 系统要求

- macOS 14 起 · 应用版本: 1.17.2 · Intel · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/m/multipass.rb> · 核查于 2026-11-22
  - <https://github.com/canonical/multipass/releases/download/v1.17.2/multipass-1.17.2+mac-Darwin.pkg>
  - SHA-256: `87bea28b67857eda23d61a5c5133dfd08da6bd082002d44585aa02bbb46dff0a`
- macOS 14 起 · 应用版本: 1.17.2 · Apple 芯片 · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/m/multipass.rb> · 核查于 2026-11-22
  - <https://github.com/canonical/multipass/releases/download/v1.17.2/multipass-1.17.2+mac-Darwin.pkg>
  - SHA-256: `87bea28b67857eda23d61a5c5133dfd08da6bd082002d44585aa02bbb46dff0a`

## Multipass 的安全事实

这里只列可以核验的事实，并注明来源和日期，不是安全认证。要检查你下载的文件，可以用 OpenNavo 在本机扫描。

- <https://github.com/canonical/multipass> · 是否开源: 是 — <https://github.com/canonical/multipass> · 核查于 2026-11-13

## 卸载

- `brew uninstall --cask multipass`

普通卸载会删除应用本身，设置和缓存会保留。

### 卸载时还会处理

- 后台服务（launchctl）: `com.canonical.multipassd` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/m/multipass.rb> · 以上条目来自 Homebrew 定义，核查于 2026-11-22；它们只说明定义声明会删除什么，不代表你的 Mac 上都有。
- 安装包收据（pkgutil）: `com.canonical.multipass.*` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/m/multipass.rb> · 以上条目来自 Homebrew 定义，核查于 2026-11-22；它们只说明定义声明会删除什么，不代表你的 Mac 上都有。
- 文件和文件夹: `$HOMEBREW_PREFIX/etc/bash_completion.d/multipass` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/m/multipass.rb> · 以上条目来自 Homebrew 定义，核查于 2026-11-22；它们只说明定义声明会删除什么，不代表你的 Mac 上都有。
- 文件和文件夹: `/Applications/Multipass.app` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/m/multipass.rb> · 以上条目来自 Homebrew 定义，核查于 2026-11-22；它们只说明定义声明会删除什么，不代表你的 Mac 上都有。
- 文件和文件夹: `/Library/Application Support/com.canonical.multipass` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/m/multipass.rb> · 以上条目来自 Homebrew 定义，核查于 2026-11-22；它们只说明定义声明会删除什么，不代表你的 Mac 上都有。
- 文件和文件夹: `/Library/Logs/Multipass` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/m/multipass.rb> · 以上条目来自 Homebrew 定义，核查于 2026-11-22；它们只说明定义声明会删除什么，不代表你的 Mac 上都有。
- 文件和文件夹: `/usr/local/bin/multipass` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/m/multipass.rb> · 以上条目来自 Homebrew 定义，核查于 2026-11-22；它们只说明定义声明会删除什么，不代表你的 Mac 上都有。
- 文件和文件夹: `/usr/local/etc/bash_completion.d/multipass` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/m/multipass.rb> · 以上条目来自 Homebrew 定义，核查于 2026-11-22；它们只说明定义声明会删除什么，不代表你的 Mac 上都有。

### 深度清理（可选）

- `brew uninstall --zap --cask multipass`

`--zap` 还会删除 Homebrew 定义里列出的设置、缓存等文件，其中可能有其他应用共用的数据，删除后无法恢复；它也不保证没有任何残留。请先备份需要保留的数据；如要保留设置和缓存，请不要加 `--zap`。

普通卸载会删除应用本身，设置和缓存会保留。

- 文件和文件夹: `~/Library/Application Support/com.canonical.multipassGui` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/m/multipass.rb> · 以上条目来自 Homebrew 定义，核查于 2026-11-22；它们只说明定义声明会删除什么，不代表你的 Mac 上都有。
- 文件和文件夹: `~/Library/Application Support/multipass` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/m/multipass.rb> · 以上条目来自 Homebrew 定义，核查于 2026-11-22；它们只说明定义声明会删除什么，不代表你的 Mac 上都有。
- 文件和文件夹: `~/Library/Application Support/multipass-gui` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/m/multipass.rb> · 以上条目来自 Homebrew 定义，核查于 2026-11-22；它们只说明定义声明会删除什么，不代表你的 Mac 上都有。
- 文件和文件夹: `~/Library/LaunchAgents/com.canonical.multipass.gui.autostart.plist` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/m/multipass.rb> · 以上条目来自 Homebrew 定义，核查于 2026-11-22；它们只说明定义声明会删除什么，不代表你的 Mac 上都有。
- 文件和文件夹: `~/Library/Preferences/multipass` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/m/multipass.rb> · 以上条目来自 Homebrew 定义，核查于 2026-11-22；它们只说明定义声明会删除什么，不代表你的 Mac 上都有。
- 文件和文件夹: `~/Library/Saved Application State/com.canonical.multipassGui.savedState` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/m/multipass.rb> · 以上条目来自 Homebrew 定义，核查于 2026-11-22；它们只说明定义声明会删除什么，不代表你的 Mac 上都有。

## 最新版本说明

### 2018.12.1 (2018-12-20)

##### Highlights

- On Linux, suspending/resuming the instance to/from disk is now supported. (#374)
- Better handling of delayed shutdown including posting `wall` messages to logged in users and allowing log ins to the instance unless 1 minute or less remains until shutdown. (#461, #501)
- On Linux, all CPU flags should be passed into the running instance on newly created instances. (#516)
- Fixed some races around mount handling. (#514, #520)

##### Bugs fixed:

- make the recover command idempotent (#528)
- explicitly stop mounts when deleting an instance to avoid a race (#520)
- be smarter about what group owns the multipass socket (#513, #523)
- pass through all CPU flags when launching QEMU or libvirt instances (#516)
- use `info` log level for metrics issues (#515)
- fix potential race when starting a mount (#514)
- use `wall` shutdown messages for users logged into VM when delayed shutdown is initiated (#501)
- fix crash if exception during daemon start up (#487)
- refactor CLI code (#468)
- add default uid/gid mapping (#331)
- fix file metadata passthrough
- display uid/gid maps in info command (#439)
- add support for the suspend command (#374)
- shell to machine in delayed stop state (#461)
- improve uid/gid validation (#479)
- avoid leaking the libvirt bridge (#327, #413)
- add a restart command (#217)
- upgrade 3rd-party versions (#471)

## 资料与来源

- <https://opennavo.com/zh/apps/multipass>
- <https://opennavo.com/zh/apps/multipass/versions>
- <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/m/multipass.rb> · 核查于 2026-11-22
- <https://formulae.brew.sh/cask/multipass>
- <https://github.com/canonical/multipass> · 核查于 2026-11-13
