自 2025 年 3 月 27 日起，我们建议您使用 android-latest-release 而非 aosp-main 构建 AOSP 并为其做出贡献。如需了解详情，请参阅 AOSP 的变更。
在本地服务器上运行 Cuttlefish
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
本页介绍了如何在本地服务器上运行 Cuttlefish。如需在本地服务器上运行 Cuttlefish，您必须使用 Cuttlefish Docker 映像和 Web 服务“Cloud Orchestrator”。
Cuttlefish Docker 映像包含从容器中启动 Cuttlefish 时所需的所有依赖项。借助此 Docker 映像，您可设置基础架构以在不同的主机环境中远程运行 Cuttlefish 实例，还可独立于主机设置（例如 OS 变体 [Debian、Linux]、OS 版本、架构变体 [x86_64、ARM64] 和其他安装依赖项）来启动 Cuttlefish。
Cloud Orchestrator 是一种 Web 服务，用于托管供您运行 Cuttlefish 的虚拟机或容器。cvdr 是一种客户端命令行界面，用于与 Cloud Orchestrator 进行交互。
运行 Cuttlefish 实例的服务器要求
运行 Cuttlefish 实例的服务器要求（例如 CPU 和内存要求）取决于同时运行的 Cuttlefish 实例数量以及每个实例使用的资源量。例如，如需运行 40 个 Cuttlefish 实例（每个实例使用 4 个 CPU 内核和 8 GB RAM），服务器至少需要 160 个内核和 320 GB RAM。如果使用图形加速，还需要 GPU。
作为参考，Cuttlefish 团队使用本地 ARM 服务器设置来运行 Cuttlefish 混合设备。为了同时运行 40 个 CHD 实例，该团队使用了 128 个核心（我们使用 ARM v8.2，但您可以使用最新版本）和 512 GB 的 RAM。
设置本地服务器以运行 Cuttlefish
如需设置本地服务器以运行 Cuttlefish，请按照在本地服务器上激活 Cloud Orchestrator 中的说明操作。这些说明介绍了如何运行 Cloud Orchestrator 服务，该服务会以主机的身份下载并运行 Cuttlefish Docker 映像。
使用 cvdr 与 Cloud Orchestrator 进行交互，以创建、删除和列出主机和 Cuttlefish 实例。
下载 Cuttlefish Docker 映像
如需下载 Cuttlefish Docker 映像，请按照 GitHub 上 android-cuttlefish/docker/README.md 中的说明操作。
本页面上的内容和代码示例受内容许可部分所述许可的限制。Java 和 OpenJDK 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC)：2025-03-03。
[null,null,["最后更新时间 (UTC)：2025-03-03。"],[],[],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."]]
