> ## Documentation Index
> Fetch the complete documentation index at: https://dragonwingdocs.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-prod/Im5W2pUR5LdqxAI6/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=Im5W2pUR5LdqxAI6&q=85&s=18405ede6b05bac8d053a48ae98204ed" 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-prod/Im5W2pUR5LdqxAI6/Key-Documents/Virtual-Machine-Setup/media/k2c-qli-vm-setup/install-utm-on-mac1-updated.png?fit=max&auto=format&n=Im5W2pUR5LdqxAI6&q=85&s=55e989982a850e7d917a7f17f3cb5872" 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-prod/Im5W2pUR5LdqxAI6/Key-Documents/Virtual-Machine-Setup/media/k2c-qli-vm-setup/install-utm-on-mac2.png?fit=max&auto=format&n=Im5W2pUR5LdqxAI6&q=85&s=6836b202ddd2262f3b3faa30d0c296c5" 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-prod/Im5W2pUR5LdqxAI6/Key-Documents/Virtual-Machine-Setup/media/k2c-qli-vm-setup/install-utm-on-mac3.png?fit=max&auto=format&n=Im5W2pUR5LdqxAI6&q=85&s=3513932633040a3a7dd792d36d1632ca" 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-prod/Im5W2pUR5LdqxAI6/Key-Documents/Virtual-Machine-Setup/media/k2c-qli-vm-setup/create-a-vm-in-utm.png?fit=max&auto=format&n=Im5W2pUR5LdqxAI6&q=85&s=d67c3081a8d9b6f2fbc9450d1abd4b1c" 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-prod/Im5W2pUR5LdqxAI6/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=Im5W2pUR5LdqxAI6&q=85&s=ba0e537dfe568cfea54d9eb321e76bc2" 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-prod/Im5W2pUR5LdqxAI6/Key-Documents/Virtual-Machine-Setup/media/k2c-qli-vm-setup/install-ubuntu-on-vm-on-arm64-based-mac1.png?fit=max&auto=format&n=Im5W2pUR5LdqxAI6&q=85&s=98519c8cf0e4881209a0662e151f3122" 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-prod/Im5W2pUR5LdqxAI6/Key-Documents/Virtual-Machine-Setup/media/k2c-qli-vm-setup/install-ubuntu-on-vm-on-arm64-based-mac2.png?fit=max&auto=format&n=Im5W2pUR5LdqxAI6&q=85&s=59ce8efbc38ca759dc18cf3d80661837" 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-prod/Im5W2pUR5LdqxAI6/Key-Documents/Virtual-Machine-Setup/media/k2c-qli-vm-setup/install-ubuntu-on-vm-on-arm64-based-mac3.png?fit=max&auto=format&n=Im5W2pUR5LdqxAI6&q=85&s=c8b3c6906f1085f7528ebe7350dc0dc6" 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-prod/Im5W2pUR5LdqxAI6/Key-Documents/Virtual-Machine-Setup/media/k2c-qli-vm-setup/install-ubuntu-on-vm-on-arm64-based-mac4.png?fit=max&auto=format&n=Im5W2pUR5LdqxAI6&q=85&s=2ced91a16d52503477bb9f374fdded08" 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-prod/Im5W2pUR5LdqxAI6/Key-Documents/Virtual-Machine-Setup/media/k2c-qli-vm-setup/install-ubuntu-on-vm-on-arm64-based-mac5.png?fit=max&auto=format&n=Im5W2pUR5LdqxAI6&q=85&s=1fda98b061515523fc34d45aa20cf5cf" 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-prod/Im5W2pUR5LdqxAI6/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=Im5W2pUR5LdqxAI6&q=85&s=bfca6ef6a805625b56f9c9560b809ed1" 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-prod/Im5W2pUR5LdqxAI6/Key-Documents/Virtual-Machine-Setup/media/k2c-qli-vm-setup/install-ubuntu-on-vm-on-arm64-based-mac9.png?fit=max&auto=format&n=Im5W2pUR5LdqxAI6&q=85&s=de63c961a6f63b9a86c050bf083c69d4" 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-prod/Im5W2pUR5LdqxAI6/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=Im5W2pUR5LdqxAI6&q=85&s=2f985938c6cb9d8fdf9d4b759a7cd9bb" 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-prod/Im5W2pUR5LdqxAI6/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=Im5W2pUR5LdqxAI6&q=85&s=043d9d6f266146fa75ebf9d4e21cdbdb" 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-prod/Im5W2pUR5LdqxAI6/Key-Documents/Virtual-Machine-Setup/media/k2c-qli-vm-setup/install-ubuntu-on-vm-on-arm64-based-mac10.png?fit=max&auto=format&n=Im5W2pUR5LdqxAI6&q=85&s=2aa6e4af505329a3b7790cada92d0f9c" 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-prod/Im5W2pUR5LdqxAI6/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=Im5W2pUR5LdqxAI6&q=85&s=1090b69fb54f8a821ede94ba3205a231" 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-prod/Im5W2pUR5LdqxAI6/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=Im5W2pUR5LdqxAI6&q=85&s=c357e80d3aafe84dc16adb917c7f9eae" 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-prod/Im5W2pUR5LdqxAI6/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=Im5W2pUR5LdqxAI6&q=85&s=18f252a827ceba7a0f0d7a99c44b8728" 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-prod/Im5W2pUR5LdqxAI6/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=Im5W2pUR5LdqxAI6&q=85&s=8efab792a1616a4142719b40de57ded0" 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)
