# 虛擬機器設定文件

在 Windows^®^ 或 Mac^®^ 主機電腦上設定 Ubuntu 虛擬機器 (VM)，以同步、建置與燒錄 Qualcomm^®^ Linux^®^ 軟體。

## VM 設定概覽

<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewbox="0 0 16 16" fill="none" aria-label="|icon3|">
  <path d="M8 2V14M3.33333 2H12.6667C13.403 2 14 2.59695 14 3.33333V12.6667C14 13.403 13.403 14 12.6667 14H3.33333C2.59695 14 2 13.403 2 12.6667V3.33333C2 2.59695 2.59695 2 3.33333 2Z" stroke="#2A2AEA" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"></path>
</svg> 高階 VM 設定概覽

提供何時應設定 Ubuntu VM 的高階概覽。

https://docs.qualcomm.com/doc/80-70018-41TC/topic/getting-started.html#vm-setup-overview

## 在 Windows 上設定 Ubuntu 虛擬機

<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewbox="0 0 16 16" fill="none" aria-label="|icon3|">
  <path d="M8 2V14M3.33333 2H12.6667C13.403 2 14 2.59695 14 3.33333V12.6667C14 13.403 13.403 14 12.6667 14H3.33333C2.59695 14 2 13.403 2 12.6667V3.33333C2 2.59695 2.59695 2 3.33333 2Z" stroke="#2A2AEA" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"></path>
</svg> 先決條件

在 Windows 主機電腦上設定 Ubuntu VM 前，請先確認硬體與軟體需求。

https://docs.qualcomm.com/doc/80-70018-41TC/topic/set-up-windows-subsystem-for-linux-on-windows-11.html#prereq-windows

<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewbox="0 0 16 16" fill="none" aria-label="|icon3|">
  <path d="M8 2V14M3.33333 2H12.6667C13.403 2 14 2.59695 14 3.33333V12.6667C14 13.403 13.403 14 12.6667 14H3.33333C2.59695 14 2 13.403 2 12.6667V3.33333C2 2.59695 2.59695 2 3.33333 2Z" stroke="#2A2AEA" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"></path>
</svg> 在 WSL 中安裝 Ubuntu

使用 Windows 子系統 Linux (WSL) 在 Windows 主機電腦上驗證並安裝 Ubuntu 22.04。

https://docs.qualcomm.com/doc/80-70018-41TC/topic/set-up-windows-subsystem-for-linux-on-windows-11.html#install-ubuntu-22-04-linux-distribution

<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewbox="0 0 16 16" fill="none" aria-label="|icon3|">
  <path d="M8 2V14M3.33333 2H12.6667C13.403 2 14 2.59695 14 3.33333V12.6667C14 13.403 13.403 14 12.6667 14H3.33333C2.59695 14 2 13.403 2 12.6667V3.33333C2 2.59695 2.59695 2 3.33333 2Z" stroke="#2A2AEA" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"></path>
</svg> 設定 WSL 的全域設定

設定 WSL 的記憶體、處理器與交換空間等設定。

https://docs.qualcomm.com/doc/80-70018-41TC/topic/set-up-windows-subsystem-for-linux-on-windows-11.html#conf-global-sets-for-wsl

<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewbox="0 0 16 16" fill="none" aria-label="|icon3|">
  <path d="M8 2V14M3.33333 2H12.6667C13.403 2 14 2.59695 14 3.33333V12.6667C14 13.403 13.403 14 12.6667 14H3.33333C2.59695 14 2 13.403 2 12.6667V3.33333C2 2.59695 2.59695 2 3.33333 2Z" stroke="#2A2AEA" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"></path>
</svg> 設定 WSL 中的 Ubuntu 設定

設定 WSL 的 DNS、Git 與本機設定。

https://docs.qualcomm.com/doc/80-70018-41TC/topic/set-up-windows-subsystem-for-linux-on-windows-11.html#conf-ubuntu-sets-for-wsl

## 在 Arm64 Mac 上設定 Ubuntu Server 虛擬機

<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewbox="0 0 16 16" fill="none" aria-label="|icon3|">
  <path d="M8 2V14M3.33333 2H12.6667C13.403 2 14 2.59695 14 3.33333V12.6667C14 13.403 13.403 14 12.6667 14H3.33333C2.59695 14 2 13.403 2 12.6667V3.33333C2 2.59695 2.59695 2 3.33333 2Z" stroke="#2A2AEA" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"></path>
</svg> 先決條件

在 Arm64 Mac 主機電腦上設定 Ubuntu VM 前，請先確認硬體與軟體需求。

https://docs.qualcomm.com/doc/80-70018-41TC/topic/set-up-an-ubuntu-vm-on-an-arm64-based-mac.html#arm64-based-mac-host-system-and-software-requirements

<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewbox="0 0 16 16" fill="none" aria-label="|icon3|">
  <path d="M8 2V14M3.33333 2H12.6667C13.403 2 14 2.59695 14 3.33333V12.6667C14 13.403 13.403 14 12.6667 14H3.33333C2.59695 14 2 13.403 2 12.6667V3.33333C2 2.59695 2.59695 2 3.33333 2Z" stroke="#2A2AEA" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"></path>
</svg> 在 Arm64 Mac 上安裝 UTM

在 Arm64 Mac 主機上安裝 UTM 虛擬化軟體。

https://docs.qualcomm.com/doc/80-70018-41TC/topic/set-up-an-ubuntu-vm-on-an-arm64-based-mac.html#install-utm-on-mac-on-arm64-based-mac

<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewbox="0 0 16 16" fill="none" aria-label="|icon3|">
  <path d="M8 2V14M3.33333 2H12.6667C13.403 2 14 2.59695 14 3.33333V12.6667C14 13.403 13.403 14 12.6667 14H3.33333C2.59695 14 2 13.403 2 12.6667V3.33333C2 2.59695 2.59695 2 3.33333 2Z" stroke="#2A2AEA" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"></path>
</svg> 在 Arm64 Mac 上使用 UTM 建立虛擬機器

在 Arm64 Mac 主機上設定並配置 UTM 虛擬機器。

https://docs.qualcomm.com/doc/80-70018-41TC/topic/set-up-an-ubuntu-vm-on-an-arm64-based-mac.html#create-a-vm-in-utm-on-an-arm64-based-mac

<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewbox="0 0 16 16" fill="none" aria-label="|icon3|">
  <path d="M8 2V14M3.33333 2H12.6667C13.403 2 14 2.59695 14 3.33333V12.6667C14 13.403 13.403 14 12.6667 14H3.33333C2.59695 14 2 13.403 2 12.6667V3.33333C2 2.59695 2.59695 2 3.33333 2Z" stroke="#2A2AEA" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"></path>
</svg> 在 Arm64 Mac 上使用 UTM 安裝 Ubuntu Server

使用 Ubuntu ISO 映像檔在 Arm64 Mac 主機的虛擬機器中安裝 Ubuntu Server。

https://docs.qualcomm.com/doc/80-70018-41TC/topic/set-up-an-ubuntu-vm-on-an-arm64-based-mac.html#install-ubuntu-on-vm-on-arm64-based-mac

<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewbox="0 0 16 16" fill="none" aria-label="|icon3|">
  <path d="M8 2V14M3.33333 2H12.6667C13.403 2 14 2.59695 14 3.33333V12.6667C14 13.403 13.403 14 12.6667 14H3.33333C2.59695 14 2 13.403 2 12.6667V3.33333C2 2.59695 2.59695 2 3.33333 2Z" stroke="#2A2AEA" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"></path>
</svg> 存取 Qualcomm Linux 開發套件

將 Qualcomm Linux 開發套件連接至 Arm64 Mac 並從 Ubuntu Server 虛擬機器中存取。

https://docs.qualcomm.com/doc/80-70018-41TC/topic/set-up-an-ubuntu-vm-on-an-arm64-based-mac.html#access-rb3-gen-2-device-from-the-utm-vm-for-arm64-based-mac

<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewbox="0 0 16 16" fill="none" aria-label="|icon3|">
  <path d="M8 2V14M3.33333 2H12.6667C13.403 2 14 2.59695 14 3.33333V12.6667C14 13.403 13.403 14 12.6667 14H3.33333C2.59695 14 2 13.403 2 12.6667V3.33333C2 2.59695 2.59695 2 3.33333 2Z" stroke="#2A2AEA" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"></path>
</svg> 設定 Arm64 Mac 與 Ubuntu Server 的電源選項

設定以防止 Arm64 Mac 與 Ubuntu Server 虛擬機器因閒置而進入睡眠模式。

https://docs.qualcomm.com/doc/80-70018-41TC/topic/set-up-an-ubuntu-vm-on-an-arm64-based-mac.html#configure-power-settings-arm64

## 在 x86\_64 Mac 上設定 Ubuntu 虛擬機

<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewbox="0 0 16 16" fill="none" aria-label="|icon3|">
  <path d="M8 2V14M3.33333 2H12.6667C13.403 2 14 2.59695 14 3.33333V12.6667C14 13.403 13.403 14 12.6667 14H3.33333C2.59695 14 2 13.403 2 12.6667V3.33333C2 2.59695 2.59695 2 3.33333 2Z" stroke="#2A2AEA" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"></path>
</svg> 先決條件

在 x86\_64 Mac 主機上設定 Ubuntu 虛擬機器前，請先確認硬體與軟體需求。

https://docs.qualcomm.com/doc/80-70018-41TC/topic/set-up-an-ubuntu-vm-on-an-intel-based-x86-64-mac.html#intel-based-x86-64-mac-host-system-and-software-requirements

<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewbox="0 0 16 16" fill="none" aria-label="|icon3|">
  <path d="M8 2V14M3.33333 2H12.6667C13.403 2 14 2.59695 14 3.33333V12.6667C14 13.403 13.403 14 12.6667 14H3.33333C2.59695 14 2 13.403 2 12.6667V3.33333C2 2.59695 2.59695 2 3.33333 2Z" stroke="#2A2AEA" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"></path>
</svg> 在 x86\_64 Mac 上安裝 UTM

在 x86\_64 Mac 主機上安裝 UTM 虛擬化軟體。

https://docs.qualcomm.com/doc/80-70018-41TC/topic/set-up-an-ubuntu-vm-on-an-intel-based-x86-64-mac.html#install-utm-x8664-mac

<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewbox="0 0 16 16" fill="none" aria-label="|icon3|">
  <path d="M8 2V14M3.33333 2H12.6667C13.403 2 14 2.59695 14 3.33333V12.6667C14 13.403 13.403 14 12.6667 14H3.33333C2.59695 14 2 13.403 2 12.6667V3.33333C2 2.59695 2.59695 2 3.33333 2Z" stroke="#2A2AEA" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"></path>
</svg> 在 x86\_64 Mac 上使用 UTM 建立虛擬機器

在 x86\_64 Mac 主機上設定並配置 UTM 虛擬機器。

https://docs.qualcomm.com/doc/80-70018-41TC/topic/set-up-an-ubuntu-vm-on-an-intel-based-x86-64-mac.html#create-a-vm-in-utm-x8664-mac

<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewbox="0 0 16 16" fill="none" aria-label="|icon3|">
  <path d="M8 2V14M3.33333 2H12.6667C13.403 2 14 2.59695 14 3.33333V12.6667C14 13.403 13.403 14 12.6667 14H3.33333C2.59695 14 2 13.403 2 12.6667V3.33333C2 2.59695 2.59695 2 3.33333 2Z" stroke="#2A2AEA" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"></path>
</svg> 在 x86\_64 Mac 上使用 UTM 安裝 Ubuntu

使用 Ubuntu ISO 映像檔在 x86\_64 Mac 主機的虛擬機器中安裝 Ubuntu。

https://docs.qualcomm.com/doc/80-70018-41TC/topic/set-up-an-ubuntu-vm-on-an-intel-based-x86-64-mac.html#install-ubuntu-on-vm-on-intel-based-x86-64-mac

<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewbox="0 0 16 16" fill="none" aria-label="|icon3|">
  <path d="M8 2V14M3.33333 2H12.6667C13.403 2 14 2.59695 14 3.33333V12.6667C14 13.403 13.403 14 12.6667 14H3.33333C2.59695 14 2 13.403 2 12.6667V3.33333C2 2.59695 2.59695 2 3.33333 2Z" stroke="#2A2AEA" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"></path>
</svg> 存取 Qualcomm Linux 開發套件

將 Qualcomm Linux 開發套件連接至 x86\_64 Mac 並從 Ubuntu 虛擬機器中存取

https://docs.qualcomm.com/doc/80-70018-41TC/topic/set-up-an-ubuntu-vm-on-an-intel-based-x86-64-mac.html#access-rb3-gen-2-device-from-x86-64-based-mac

<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewbox="0 0 16 16" fill="none" aria-label="|icon3|">
  <path d="M8 2V14M3.33333 2H12.6667C13.403 2 14 2.59695 14 3.33333V12.6667C14 13.403 13.403 14 12.6667 14H3.33333C2.59695 14 2 13.403 2 12.6667V3.33333C2 2.59695 2.59695 2 3.33333 2Z" stroke="#2A2AEA" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"></path>
</svg> 設定 x86\_64 Mac 與 Ubuntu 的電源選項

設定以防止 x86\_64 Mac 與 Ubuntu 虛擬機器因閒置而進入睡眠模式。

https://docs.qualcomm.com/doc/80-70018-41TC/topic/set-up-an-ubuntu-vm-on-an-intel-based-x86-64-mac.html#configure-power-settings-x8664

## 排解主機電腦與虛擬機器的問題

<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewbox="0 0 16 16" fill="none" aria-label="|icon3|">
  <path d="M8 2V14M3.33333 2H12.6667C13.403 2 14 2.59695 14 3.33333V12.6667C14 13.403 13.403 14 12.6667 14H3.33333C2.59695 14 2 13.403 2 12.6667V3.33333C2 2.59695 2.59695 2 3.33333 2Z" stroke="#2A2AEA" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"></path>
</svg> 修復 Ubuntu 虛擬機器中的網路故障

處理 Ubuntu 虛擬機器中間歇性的網路問題，這些問題可能導致建置過程中失敗。

https://docs.qualcomm.com/doc/80-70018-41TC/topic/troubleshoot.html#fix-network-failures-in-the-ubuntu-vm

<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewbox="0 0 16 16" fill="none" aria-label="|icon3|">
  <path d="M8 2V14M3.33333 2H12.6667C13.403 2 14 2.59695 14 3.33333V12.6667C14 13.403 13.403 14 12.6667 14H3.33333C2.59695 14 2 13.403 2 12.6667V3.33333C2 2.59695 2.59695 2 3.33333 2Z" stroke="#2A2AEA" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"></path>
</svg> 最佳化反應緩慢或無回應的 Mac 主機電腦

檢查 UTM 虛擬機器是否佔用所有資源，導致 Mac 主機變慢。

https://docs.qualcomm.com/doc/80-70018-41TC/topic/troubleshoot.html#slow-or-unresponsive-host

Last Published: Aug 31, 2025

[Next Topic
虛擬機器設定概述](https://docs.qualcomm.com/bundle/publicresource/80-70018-41TC/topics/getting-started.md)