> ## Documentation Index
> Fetch the complete documentation index at: https://dragonwingdocs-staging.qualcomm.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 在 Arm64 Mac 上设置 Ubuntu Server VM

UTM 是一款适用于 macOS<sup>®</sup> 的开源 VM 主机软件，可让您在 Mac 上运行其他操作系统，包括 Ubuntu。下图显示了在 Arm64 Mac 上使用 UTM 设置 Ubuntu Server VM 所涉及的任务：

<Frame caption="图：在 Arm64 Mac 上设置 Ubuntu Server VM 的工作流">
  <img src="https://mintcdn.com/qualcomm-staging/uWQLnBcS9sxlZhgB/Key-Documents/Virtual-Machine-Setup/media/k2c-qli-vm-setup/set-up-an-ubuntu-vm-on-an-arm64-based-mac.svg?fit=max&auto=format&n=uWQLnBcS9sxlZhgB&q=85&s=3f55b3e8eb41b1b8c1be4be4bc098738" alt="在基于 Arm64 的 Mac 上设置 Ubuntu VM 的工作流" width="1150" height="240" data-path="Key-Documents/Virtual-Machine-Setup/media/k2c-qli-vm-setup/set-up-an-ubuntu-vm-on-an-arm64-based-mac.svg" />
</Frame>

## **在 Arm64 Mac 上设置 Ubuntu Server VM 的先决条件**

* 确保您的主机满足[Arm64 Mac 主机要求](#host-computer-requirements-for-arm64-mac)中列出的系统要求。
* 下载[Arm64 Mac 的 Ubuntu Server VM 软件要求](#ubuntu-server-vm-software-requirements-for-arm64-mac)中列出的所需软件。

### **Arm64 Mac 主机要求**

下表列出了在 Arm64 Mac 上设置 Ubuntu Server VM 的主机要求：

**表：Arm64 主机系统要求**

| **要求** | **规格**                                                          |
| ------ | --------------------------------------------------------------- |
| 处理器架构  | Arm64<br /><br />要验证您的 Mac 架构是否为 Arm64，请在终端窗口中运行 `uname -a` 命令。 |
| CPU 核心 | 8 个或更多                                                          |
| RAM    | 8 GB 或更多                                                        |
| 存储     | 为 UTM VM 预留 400 GB 可用空间                                         |
| 操作系统   | macOS 14                                                        |

### **Arm64 Mac 的 Ubuntu Server VM 软件要求**

下表列出了在 Arm64 Mac 上设置 Ubuntu Server VM 的软件要求：

**表：Arm64 Mac 的软件要求**

| **软件**                       | **描述**                                                                                                                                                                                                                      |
| ---------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| UTM 虚拟化软件                    | 从 [UTM 网站](https://mac.getutm.app/)下载 UTM 虚拟化软件。                                                                                                                                                                            |
| Ubuntu Server 国际标准化组织（ISO）镜像 | 使用 Ubuntu 22.04 64 位 Arm<sup>®</sup>（ARMv8/AArch64）Server LTS 版本之一。Qualcomm 建议您从 [Ubuntu 网站](https://cdimage.ubuntu.com/releases/22.04/release/)下载最新版本的 Ubuntu Server 22.04 ISO（例如 `ubuntu-22.04.5-live-server-arm64.iso`）。 |

## **在 Arm64 Mac 上安装 UTM**

要安装 UTM 虚拟化软件，请执行以下操作：

1. 双击之前下载的 `UTM.dmg` 文件，并将 **UTM** 图标拖动到 **Applications** 图标上。

   <img src="https://mintcdn.com/qualcomm-staging/uWQLnBcS9sxlZhgB/Key-Documents/Virtual-Machine-Setup/media/k2c-qli-vm-setup/install-utm-on-mac1-updated.png?fit=max&auto=format&n=uWQLnBcS9sxlZhgB&q=85&s=933044756bce21d0202f648e51a93d16" alt="将 UTM 图标拖动到 Applications" style={{width: '60%'}} width="682" height="435" data-path="Key-Documents/Virtual-Machine-Setup/media/k2c-qli-vm-setup/install-utm-on-mac1-updated.png" />

2. 安装 UTM 时，如果看到以下对话框，请选择 **Open**：

   <img src="https://mintcdn.com/qualcomm-staging/uWQLnBcS9sxlZhgB/Key-Documents/Virtual-Machine-Setup/media/k2c-qli-vm-setup/install-utm-on-mac2.png?fit=max&auto=format&n=uWQLnBcS9sxlZhgB&q=85&s=3c4593246873583067d901585ccb13db" alt="UTM 安装打开对话框" style={{width: '45%'}} width="368" height="373" data-path="Key-Documents/Virtual-Machine-Setup/media/k2c-qli-vm-setup/install-utm-on-mac2.png" />

3. 打开 Launchpad，搜索 **UTM**，然后选择 **UTM**。

   将显示 UTM 主窗口。

   <img src="https://mintcdn.com/qualcomm-staging/uWQLnBcS9sxlZhgB/Key-Documents/Virtual-Machine-Setup/media/k2c-qli-vm-setup/install-utm-on-mac3.png?fit=max&auto=format&n=uWQLnBcS9sxlZhgB&q=85&s=bea1b67d2240b43115dc13d4ef83e96b" alt="UTM 主窗口" style={{width: '60%'}} width="769" height="605" data-path="Key-Documents/Virtual-Machine-Setup/media/k2c-qli-vm-setup/install-utm-on-mac3.png" />

## **在 Arm64 Mac 上的 UTM 中创建 VM**

要在 UTM 中为 Ubuntu Server 创建 VM 并配置 VM 设置，请执行以下操作：

1. 在 UTM 主窗口中，选择 **Create a New Virtual Machine**。
2. 在 **Start** 屏幕上，选择 **Virtualize**。
3. 在 **Operating System** 屏幕上，选择 **Linux** 操作系统。
4. 在 **Hardware** 屏幕上，指定要分配给 Ubuntu VM 的内存和 CPU 核心，然后选择 **Continue**。推荐值如下：
   * 内存：约为可用内存的 70%
   * CPU 核心：至少为可用核心的 50%
     如果将 **CPU Cores** 字段留空或设置为 `0`，UTM 会将主机的所有核心分配给 VM。将所有 CPU 核心分配给 VM 可能会导致主机运行缓慢或无响应。
     要查看 Mac 主机的内存大小和 CPU 核心数量，请参阅 [macOS 使用手册](https://support.apple.com/en-in/guide/mac-help/syspr35536/mac)中的说明。
5. 在 **Linux** 屏幕上，浏览并选择您下载的 Ubuntu ISO 镜像，然后选择 **Continue**。
6. 在 **Storage** 屏幕上，指定 VM 的驱动器大小，然后选择 **Continue**。Qualcomm 建议为 VM 分配至少 400 GB 的存储空间。
7. 如果要在主机和 VM 之间共享目录，请在 **Shared Directory** 屏幕上执行以下操作：
   1. 浏览并选择目录。
   2. 选择 **Continue**。
8. 在 **Summary** 屏幕上，执行以下操作：
   1. 检查您正在创建的 VM 的配置摘要。
   2. 为 VM 提供一个名称。
   3. 选择 **Save**。UTM 主窗口会列出新创建的 VM。

      <img src="https://mintcdn.com/qualcomm-staging/uWQLnBcS9sxlZhgB/Key-Documents/Virtual-Machine-Setup/media/k2c-qli-vm-setup/create-a-vm-in-utm.png?fit=max&auto=format&n=uWQLnBcS9sxlZhgB&q=85&s=be491822493a502c1def82207b7f36c5" alt="显示新创建 VM 的 UTM 主窗口" width="1012" height="119" data-path="Key-Documents/Virtual-Machine-Setup/media/k2c-qli-vm-setup/create-a-vm-in-utm.png" />

## **在 Arm64 Mac 上的 UTM 中安装 Ubuntu Server**

要在您创建的 VM 中安装 Ubuntu Server，请执行以下操作：

1. 在 UTM 主窗口中，选择 **Play** 图标，通过虚拟化运行 Ubuntu ISO 镜像。

   <img src="https://mintcdn.com/qualcomm-staging/uWQLnBcS9sxlZhgB/Key-Documents/Virtual-Machine-Setup/media/k2c-qli-vm-setup/install-ubuntu-on-vm-on-intel-based-x86-64-mac1.png?fit=max&auto=format&n=uWQLnBcS9sxlZhgB&q=85&s=3c2b775ec1ead6acbf562e052bdf4ab0" alt="带有 Play 图标的 UTM 主窗口" width="1010" height="117" data-path="Key-Documents/Virtual-Machine-Setup/media/k2c-qli-vm-setup/install-ubuntu-on-vm-on-intel-based-x86-64-mac1.png" />

2. 使用方向键选择 **Try or Install Ubuntu Server**，然后按 **Enter**。

   <img src="https://mintcdn.com/qualcomm-staging/uWQLnBcS9sxlZhgB/Key-Documents/Virtual-Machine-Setup/media/k2c-qli-vm-setup/install-ubuntu-on-vm-on-arm64-based-mac1.png?fit=max&auto=format&n=uWQLnBcS9sxlZhgB&q=85&s=fbd4d61e35c9493496bf10f450d7b67a" alt="Try or Install Ubuntu Server 选项" width="290" height="98" data-path="Key-Documents/Virtual-Machine-Setup/media/k2c-qli-vm-setup/install-ubuntu-on-vm-on-arm64-based-mac1.png" />

3. 选择语言并按 **Enter**。

4. 可选：您可能会看到更新安装程序的屏幕。选择以下选项之一并按 **Enter**：
   * **Update to the new installer**
   * **Continue without updating**

5. 执行以下操作：
   1. 选择键盘布局。
   2. 选择 **Ubuntu Server** 安装基础。
   3. 选择适当的网络接口。
   4. 选择适当的代理配置。

6. 如有必要，配置镜像地址并等待镜像位置通过所有测试，然后选择 **Done** 并按 **Enter**。

   <img src="https://mintcdn.com/qualcomm-staging/uWQLnBcS9sxlZhgB/Key-Documents/Virtual-Machine-Setup/media/k2c-qli-vm-setup/install-ubuntu-on-vm-on-arm64-based-mac2.png?fit=max&auto=format&n=uWQLnBcS9sxlZhgB&q=85&s=64e446b8f829e1c41cfcd34d8fad65d6" alt="镜像地址配置" style={{width: '85%'}} width="889" height="552" data-path="Key-Documents/Virtual-Machine-Setup/media/k2c-qli-vm-setup/install-ubuntu-on-vm-on-arm64-based-mac2.png" />

7. 选择 **Use an entire disk** > **Set up this disk as an LVM group**，选择 **Done**，然后按 **Enter**。

   <img src="https://mintcdn.com/qualcomm-staging/uWQLnBcS9sxlZhgB/Key-Documents/Virtual-Machine-Setup/media/k2c-qli-vm-setup/install-ubuntu-on-vm-on-arm64-based-mac3.png?fit=max&auto=format&n=uWQLnBcS9sxlZhgB&q=85&s=09cedba5aef64faaad3549b733b82c2e" alt="使用 LVM 组的存储配置" style={{width: '85%'}} width="852" height="527" data-path="Key-Documents/Virtual-Machine-Setup/media/k2c-qli-vm-setup/install-ubuntu-on-vm-on-arm64-based-mac3.png" />

8. 按如下方式配置存储空间：
   1. 在 **USED DEVICES** 部分下，选择 **ubuntu-lv**，然后按 **Enter** 查看更多选项。

      <img src="https://mintcdn.com/qualcomm-staging/uWQLnBcS9sxlZhgB/Key-Documents/Virtual-Machine-Setup/media/k2c-qli-vm-setup/install-ubuntu-on-vm-on-arm64-based-mac4.png?fit=max&auto=format&n=uWQLnBcS9sxlZhgB&q=85&s=44bb052e1718823e1932b4a57a1634f9" alt="包含 ubuntu-lv 的 USED DEVICES 部分" width="3024" height="1964" data-path="Key-Documents/Virtual-Machine-Setup/media/k2c-qli-vm-setup/install-ubuntu-on-vm-on-arm64-based-mac4.png" />

   2. 选择 **Edit**，然后按 **Enter**。

      <img src="https://mintcdn.com/qualcomm-staging/uWQLnBcS9sxlZhgB/Key-Documents/Virtual-Machine-Setup/media/k2c-qli-vm-setup/install-ubuntu-on-vm-on-arm64-based-mac5.png?fit=max&auto=format&n=uWQLnBcS9sxlZhgB&q=85&s=2352c1e9c202df44fe886878879992ec" alt="ubuntu-lv 的 Edit 选项" width="2032" height="310" data-path="Key-Documents/Virtual-Machine-Setup/media/k2c-qli-vm-setup/install-ubuntu-on-vm-on-arm64-based-mac5.png" />

   3. 在 **Size** 字段中，输入 `396.000G`，选择 **Save**，然后按 **Enter**。更新后的大小现在应反映在 ubuntu-lv 条目中。

   4. 选择 **Done** 并按 **Enter**。

9. 要设置您的配置文件，请指定所需的详细信息，选择 **Save**，然后按 **Enter**。

10. 跳过 **Ubuntu Pro** 升级选项，选择 **Continue**，然后按 **Enter**。

11. 可选：选择 **Install OpenSSH Server** 以设置 SSH，选择 **Done**，然后按 **Enter**。
    **注意**
    同步、编译和烧录 Qualcomm Linux 并不需要 OpenSSH。仅当您希望允许对 Ubuntu VM 进行安全远程访问时，才安装 OpenSSH 服务器。

12. 安装成功后，选择 **Power** 图标以关闭并停止 VM，然后选择 **OK**。

    <img src="https://mintcdn.com/qualcomm-staging/uWQLnBcS9sxlZhgB/Key-Documents/Virtual-Machine-Setup/media/k2c-qli-vm-setup/install-ubuntu-on-vm-on-intel-based-x86-64-mac2.png?fit=max&auto=format&n=uWQLnBcS9sxlZhgB&q=85&s=06be261068d9e6d4981605ceb7503d9f" alt="用于关闭 VM 的 Power 图标" width="1044" height="33" data-path="Key-Documents/Virtual-Machine-Setup/media/k2c-qli-vm-setup/install-ubuntu-on-vm-on-intel-based-x86-64-mac2.png" />

13. VM 停止后，关闭窗口。

## **在 Arm64 Mac 上运行 Ubuntu Server VM**

要运行 Ubuntu Server VM，请执行以下操作：

1. 在 UTM 主窗口中，在 **CD/DVD** 下拉列表中选择 **Clear**。

   <img src="https://mintcdn.com/qualcomm-staging/uWQLnBcS9sxlZhgB/Key-Documents/Virtual-Machine-Setup/media/k2c-qli-vm-setup/install-ubuntu-on-vm-on-arm64-based-mac9.png?fit=max&auto=format&n=uWQLnBcS9sxlZhgB&q=85&s=b8876f3fd862dc45dae6b1cf50b6738c" alt="选择了 Clear 的 CD/DVD 下拉列表" style={{width: '80%'}} width="549" height="258" data-path="Key-Documents/Virtual-Machine-Setup/media/k2c-qli-vm-setup/install-ubuntu-on-vm-on-arm64-based-mac9.png" />

2. 确保 CD/DVD 选项对应的 ISO 镜像关联为空。

   <img src="https://mintcdn.com/qualcomm-staging/uWQLnBcS9sxlZhgB/Key-Documents/Virtual-Machine-Setup/media/k2c-qli-vm-setup/install-ubuntu-on-vm-on-intel-based-x86-64-mac4.png?fit=max&auto=format&n=uWQLnBcS9sxlZhgB&q=85&s=c179312b3ded64e7ee338762ac750f5e" alt="空的 ISO 镜像关联" width="1020" height="67" data-path="Key-Documents/Virtual-Machine-Setup/media/k2c-qli-vm-setup/install-ubuntu-on-vm-on-intel-based-x86-64-mac4.png" />

3. 要运行 Ubuntu VM，请选择 **Play** 图标。

   <img src="https://mintcdn.com/qualcomm-staging/uWQLnBcS9sxlZhgB/Key-Documents/Virtual-Machine-Setup/media/k2c-qli-vm-setup/install-ubuntu-on-vm-on-intel-based-x86-64-mac5.png?fit=max&auto=format&n=uWQLnBcS9sxlZhgB&q=85&s=524f24ee50eb139d06cd7f6809bf5cf4" alt="用于运行 Ubuntu VM 的 Play 图标" width="1020" height="120" data-path="Key-Documents/Virtual-Machine-Setup/media/k2c-qli-vm-setup/install-ubuntu-on-vm-on-intel-based-x86-64-mac5.png" />

4. Ubuntu 操作系统成功启动后，输入凭据登录并访问 shell。

   <img src="https://mintcdn.com/qualcomm-staging/uWQLnBcS9sxlZhgB/Key-Documents/Virtual-Machine-Setup/media/k2c-qli-vm-setup/install-ubuntu-on-vm-on-arm64-based-mac10.png?fit=max&auto=format&n=uWQLnBcS9sxlZhgB&q=85&s=d73ff564799ddb06b51f23db5a44f0f9" alt="Ubuntu 登录屏幕" width="252" height="55" data-path="Key-Documents/Virtual-Machine-Setup/media/k2c-qli-vm-setup/install-ubuntu-on-vm-on-arm64-based-mac10.png" />

5. 运行以下命令来更新 Ubuntu 操作系统并安装图形桌面环境，然后重启：
   ```text theme={null}
   sudo apt update && sudo apt upgrade -y
   ```
   ```text theme={null}
   sudo apt install ubuntu-desktop -y
   ```
   ```text theme={null}
   reboot
   ```

6. 登录您创建的 Ubuntu Server VM。

## **访问 Qualcomm Linux 开发套件**

要从 Ubuntu Server VM 访问 Qualcomm Linux 开发套件，请执行以下操作：

1. 将 Qualcomm Linux 开发套件连接到主机。

   UTM 软件可能会要求您确认 Ubuntu 操作系统是否应有权访问 Qualcomm Linux 开发套件。

   a. 如果看到如下对话框，请选择 **Confirm**：

   <img src="https://mintcdn.com/qualcomm-staging/uWQLnBcS9sxlZhgB/Key-Documents/Virtual-Machine-Setup/media/k2c-qli-vm-setup/access-rb3-gen-2-device-from-the-utm-vm1.png?fit=max&auto=format&n=uWQLnBcS9sxlZhgB&q=85&s=d72fecafd05ed0560228b790bc5e4e94" alt="Qualcomm Linux 开发套件访问确认对话框" width="258" height="297" data-path="Key-Documents/Virtual-Machine-Setup/media/k2c-qli-vm-setup/access-rb3-gen-2-device-from-the-utm-vm1.png" />

   b. 选择 **Confirm** 后，如果看到以下 USB 断开连接错误，请选择 **OK** 忽略它：

   <img src="https://mintcdn.com/qualcomm-staging/uWQLnBcS9sxlZhgB/Key-Documents/Virtual-Machine-Setup/media/k2c-qli-vm-setup/access-rb3-gen-2-device-from-the-utm-vm3.png?fit=max&auto=format&n=uWQLnBcS9sxlZhgB&q=85&s=56ddb75cb857b9f3c425331ac25e466d" alt="USB 断开连接错误对话框" width="516" height="434" data-path="Key-Documents/Virtual-Machine-Setup/media/k2c-qli-vm-setup/access-rb3-gen-2-device-from-the-utm-vm3.png" />

2. 要验证 Ubuntu VM 是否可以访问 Qualcomm Linux 开发套件，请在 Ubuntu 终端窗口中运行 `lsusb` 命令。

   输出会如下显示 Qualcomm Linux 开发套件：

   <img src="https://mintcdn.com/qualcomm-staging/uWQLnBcS9sxlZhgB/Key-Documents/Virtual-Machine-Setup/media/k2c-qli-vm-setup/access-rb3-gen-2-device-from-the-utm-vm2.png?fit=max&auto=format&n=uWQLnBcS9sxlZhgB&q=85&s=5c796f3a2e61249b41e0e4b6abec7307" alt="显示 Qualcomm Linux 开发套件的 lsusb 输出" width="605" height="205" data-path="Key-Documents/Virtual-Machine-Setup/media/k2c-qli-vm-setup/access-rb3-gen-2-device-from-the-utm-vm2.png" />

   如果在 Ubuntu VM 中未检测到 Qualcomm Linux 开发套件，请执行以下操作：

   a. 在 UTM VM 窗口的工具栏中选择 **USB Devices**。

   b. 选择 **QCMXXXX\_xxxxxxxx**。

   <img src="https://mintcdn.com/qualcomm-staging/uWQLnBcS9sxlZhgB/Key-Documents/Virtual-Machine-Setup/media/k2c-qli-vm-setup/access-rb3-gen-2-device-from-the-utm-vm4.png?fit=max&auto=format&n=uWQLnBcS9sxlZhgB&q=85&s=03aaaea1edd28e48bc4e237bf4ab4c7f" alt="包含 QCMXXXX 设备的 USB Devices 菜单" width="542" height="244" data-path="Key-Documents/Virtual-Machine-Setup/media/k2c-qli-vm-setup/access-rb3-gen-2-device-from-the-utm-vm4.png" />

如果在 USB 设备列表中未看到 Qualcomm Linux 开发套件，请执行以下操作：

1. 在 UTM 设置中，选择左侧面板中的 **Input**。
2. 在 **Maximum Shared USB Devices** 字段中，将值设置为 `10`。

## **为 Arm64 Mac 和 Ubuntu Server 配置电源设置**

为确保 Mac 主机和 Ubuntu Server VM 不会因不活动而进入睡眠状态，请执行以下操作：

* 要为 Mac 主机配置睡眠和唤醒设置，请参阅 [macOS 使用手册](https://support.apple.com/en-in/guide/mac-help/mchle41a6ccd/mac)。
* 要为 Ubuntu Server 配置电源设置，请执行以下操作：
  1. 在 Ubuntu 的 **System Settings** 中，选择 **Power**。
  2. 关闭 **Automatic Suspend**。

## **后续步骤**

* [同步、构建和烧录 Qualcomm Linux](https://dragonwingdocs.qualcomm.com/Key-Documents/Flash-Guide/flash-with-qdl)
* [修复 Ubuntu VM 中的网络故障](./troubleshoot-host-computers-and-virtual-machines#fix-network-failures-in-the-ubuntu-vm)
* [优化缓慢或无响应的 Mac 主机](./troubleshoot-host-computers-and-virtual-machines#optimize-slow-or-unresponsive-mac-host-computer)
