自 2025 年 3 月 27 日起，我們建議您使用 android-latest-release 而非 aosp-main 建構及貢獻 AOSP。詳情請參閱「Android 開放原始碼計畫變更」。
在內部伺服器上執行 Cuttlefish
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
本頁面說明如何在內部部署伺服器上執行 Cuttlefish。如要在內部伺服器上執行 Cuttlefish，您必須使用 Cuttlefish Docker 映像檔和 Cloud Orchestrator 網路服務。
Cuttlefish Docker 映像檔包含在容器中啟動 Cuttlefish 所需的所有依附元件。這個 Docker 映像檔可讓您設定基礎架構，以便在不同的主機環境中遠端執行 Cuttlefish 執行個體，並讓您獨立於主機機器的設定啟動 Cuttlefish，例如作業系統變體 (Debian、Linux)、作業系統版本、架構變體 (x86_64、ARM64) 和其他安裝依附元件。
Cloud Orchestrator 是一種網路服務，可用於代管可執行 Cuttlefish 的 VM 或容器。cvdr 是用於與 Cloud Orchestrator 互動的用戶端指令列介面。
執行 Cuttlefish 執行個體的伺服器需求
執行 Cuttlefish 執行個體的伺服器需求 (例如 CPU 和記憶體需求) 取決於同時執行的 Cuttlefish 執行個體數量，以及每個執行個體使用的資源數量。舉例來說，如要執行 40 個 Cuttlefish 執行個體，每個執行個體使用 4 個 CPU 核心和 8 GB RAM，則伺服器至少需要 160 個核心和 320 GB RAM。如果使用圖形加速功能，也需要 GPU。此外，伺服器的 CPU 應採用與 Cuttlefish 例項建構作業所用的 ARM 架構相同或更高的 ARM 架構。
請注意，Cuttlefish 團隊使用的是內部部署的 ARM 伺服器設定，用於執行 Cuttlefish 混合裝置。為了同時執行 40 個 CHD 執行個體，團隊使用 128 個核心 (我們使用 ARM v8.2，但您可以使用最新版本) 和 512 GB RAM。
設定執行 Cuttlefish 的地端伺服器
如要設定用於執行 Cuttlefish 的內部伺服器，請按照「在內部伺服器上啟用雲端管控器」一文中的操作說明進行。本操作說明說明如何執行 Cloud Orchestrator，該工具會下載並以主機的形式執行 Cuttlefish Docker 映像檔。
使用 cvdr 與 Cloud 管控器互動，建立、刪除及列出主機和 Cuttlefish 執行個體。
下載 Cuttlefish Docker 映像檔
如要下載 Cuttlefish Docker 映像檔，請按照 GitHub 上的 android-cuttlefish/docker/README.md 中的操作說明進行。
這個頁面中的內容和程式碼範例均受《內容授權》中的授權所規範。Java 與 OpenJDK 是 Oracle 和/或其關係企業的商標或註冊商標。
上次更新時間：2025-07-27 (世界標準時間)。
[[["容易理解","easyToUnderstand","thumb-up"],["確實解決了我的問題","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["缺少我需要的資訊","missingTheInformationINeed","thumb-down"],["過於複雜/步驟過多","tooComplicatedTooManySteps","thumb-down"],["過時","outOfDate","thumb-down"],["翻譯問題","translationIssue","thumb-down"],["示例/程式碼問題","samplesCodeIssue","thumb-down"],["其他","otherDown","thumb-down"]],["上次更新時間：2025-07-27 (世界標準時間)。"],[],[],null,["# Run Cuttlefish on an on-premise server\n\nThis page describes how to run Cuttlefish on an on-premise server. To run\nCuttlefish on an on-premise server, you must use the Cuttlefish\n[Docker](https://docs.docker.com/get-started/overview/) image and the Cloud\nOrchestrator web service.\n\nThe Cuttlefish Docker image includes all the required dependencies for launching\nCuttlefish in a container. This Docker image lets you set up the infrastructure\nfor running Cuttlefish instances remotely on different host environments and\nlets you launch Cuttlefish independently from your host machine's setup, for\nexample OS variant (Debian, Linux), OS version, architecture variant (x86_64,\nARM64), and other installation dependencies.\n\nThe\n[Cloud Orchestrator](https://github.com/google/cloud-android-orchestration/blob/main/docs/cloud_orchestrator.md)\nis a web service for hosting VMs or containers that you can run Cuttlefish on.\n[`cvdr`](https://github.com/google/cloud-android-orchestration/blob/main/docs/cvdr.md)\nis a client-side command line interface for interacting with the Cloud\nOrchestrator.\n\nServer requirements for running Cuttlefish instances\n----------------------------------------------------\n\nThe server requirements (for example, CPU and memory requirements) for\nrunning Cuttlefish instances depends on the number of Cuttlefish\ninstances running at the same time and the amount of resources each instance\nuses. For example, to run 40 Cuttlefish instances, which each use 4 CPU cores\nand 8 GB of RAM, the server requires at least 160 cores and 320 GB of\nRAM. If using graphical acceleration, GPUs are also required. Also, the server's\nCPU should have an ARM architecture equal to or higher than that used by a\nCuttlefish instance for its build.\n\nFor reference, the Cuttlefish team uses an on-premise ARM server setup for\nrunning Cuttlefish hybrid devices. To run 40 CHD instances at the same time, the\nteam uses 128 cores (we use ARM v8.2 but you can use the latest version) and\n512 GB of RAM.\n\nSet up an on-premise server for running Cuttlefish\n--------------------------------------------------\n\nTo set up an on-premise server for running Cuttlefish, follow the instructions\nin\n[Activate cloud orchestrator at on-premise server](https://github.com/google/cloud-android-orchestration/blob/main/scripts/on-premises/single-server/README.md).\nThese instructions describe how to run Cloud Orchestrator, which downloads\nand runs the [Cuttlefish Docker image](#download-docker-image) as a host.\n\nUse\n[`cvdr`](https://github.com/google/cloud-android-orchestration/blob/main/docs/cvdr.md)\nto interact with Cloud orchestrator to create, delete, and list hosts and\nCuttlefish instances.\n\nDownload the Cuttlefish Docker image\n------------------------------------\n\nTo download the Cuttlefish Docker image, follow the instructions in\n[android-cuttlefish/docker/README.md](https://github.com/google/android-cuttlefish/blob/main/README.md)\non GitHub."]]
