# 虛擬機器設定說明文件

在 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-70020-41TC/topic/getting-started.html#vm-setup-overview

## 在 Windows 上設定 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> 在 Windows 上建立 Ubuntu VM 的必要條件

在 Windows 主機電腦上建立 Ubuntu VM 之前，請先確認硬體和軟體要求。

https://docs.qualcomm.com/doc/80-70020-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-70020-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-70020-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-70020-41TC/topic/set-up-windows-subsystem-for-linux-on-windows-11.html#conf-ubuntu-sets-for-wsl

## 設定 Arm64 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> 在 Arm64 Mac 上建立 Ubuntu Server VM 的必要條件

在 Arm64 Mac 主機電腦上建立 Ubuntu VM 之前，請先確認硬體和軟體要求。

https://docs.qualcomm.com/doc/80-70020-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-70020-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 中建立 VM

在 Arm64 Mac 主機電腦上的 UTM 中設定 VM。

https://docs.qualcomm.com/doc/80-70020-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

在 Arm64 Mac 主機電腦上的 VM 中使用 Ubuntu ISO 影像檔安裝 Ubuntu Server。

https://docs.qualcomm.com/doc/80-70020-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 伺服器虛擬機器中存取。

https://docs.qualcomm.com/doc/80-70020-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 伺服器虛擬機器因閒置而進入睡眠狀態。

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

## 在 x86\_64 Mac 上設定 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> 在 x86\_64 Mac 上建立 Ubuntu VM 的必要條件

在 x86\_64 Mac 主機電腦上建立 Ubuntu VM 之前，請先確認硬體和軟體要求。

https://docs.qualcomm.com/doc/80-70020-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-70020-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 中建立 VM

在 x86\_64 Mac 主機電腦上的 UTM 中設定 VM。

https://docs.qualcomm.com/doc/80-70020-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

在 x86\_64 Mac 主機電腦上的 VM 中使用 Ubuntu ISO 影像檔安裝 Ubuntu。

https://docs.qualcomm.com/doc/80-70020-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 VM 中存取。

https://docs.qualcomm.com/doc/80-70020-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 VM 因閒置而進入睡眠狀態。

https://docs.qualcomm.com/doc/80-70020-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 VM 中的網路故障

解決 Ubuntu VM 中的間歇性網路問題，這些問題可能會導致正在進行的建置編譯失敗。

https://docs.qualcomm.com/doc/80-70020-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 VM 是否使用所有資源、Mac 主機電腦是否反應緩慢。

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

Last Published: Dec 23, 2025

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