热门搜索:

cloudhypervisor/dev

cloudhypervisor

Cloud Hypervisor开发容器，用于构建和测试基于KVM的开源虚拟机监控程序(VMM)，专注于运行现代云工作负载，具备低延迟、低内存占用和高性能特性，支持x86-64和AArch64架构。

下载次数: 0状态：社区镜像维护者：cloudhypervisor仓库类型：镜像最近更新：3 年前

让 AI 帮你使用轩辕镜像？ · 展开查看说明

如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。

只需在 AI 对话中先发送下面这句话即可：

请先完整阅读并严格遵守以下文档中的全部规则与要求：

https://xuanyuan.cloud/agents.md

在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。

查看 agents.md 用法指南与完整示范。国内用户首推元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。若 AI 无法访问外链，可打开说明文档复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。

镜像标签列表与下载命令

Cloud Hypervisor 开发容器

镜像概述和主要用途

Cloud Hypervisor是一个基于KVM的开源虚拟机监控程序(VMM)，专为运行现代云工作负载设计。该项目专注于在有限的硬件架构和平台上运行云工作负载，这些工作负载通常由云服务提供商的客户运行，特点是使用现代操作系统、通过半虚拟化设备（如virtio）处理大部分I/O、无需传统设备支持，且仅支持64位CPU。

Cloud Hypervisor采用Rust语言实现，并基于https://github.com/rust-vmm crates构建。本开发容器提供了构建和测试Cloud Hypervisor的环境，无需手动安装所有依赖项。

核心功能和特性

高层目标

基于KVM
最小化模拟
低延迟
低内存占用
低复杂度
高性能
小***面
仅支持64位
支持CPU、内存、PCI热插拔
支持虚拟机迁移

架构支持

支持x86-64和AArch64架构，两者在功能上存在一些差异（参见#1125）。

客户机操作系统

支持64位Linux，对现代64位Windows客户机的支持正在开发中。

使用场景和适用范围

适用于开发和测试基于KVM的虚拟化解决方案，特别是针对云环境中的现代工作负载。可用于：

构建和测试Cloud Hypervisor本身
运行云镜像（如Ubuntu云镜像）
启动自定义内核和磁盘镜像的虚拟机
验证热插拔、设备模型等功能

详细使用方法和配置说明

环境准备

创建用于构建和运行Cloud Hypervisor的目录：

shell
$ export CLOUDH=$HOME/cloud-hypervisor
$ mkdir $CLOUDH

克隆和构建

常规构建

克隆并构建Cloud Hypervisor仓库：

shell
$ pushd $CLOUDH
$ git clone https://github.com/cloud-hypervisor/cloud-hypervisor.git
$ cd cloud-hypervisor
$ cargo build --release

# 为cloud-hypervisor二进制文件添加NET_ADMIN权限以设置主机TAP接口
$ sudo setcap cap_net_admin+ep ./target/release/cloud-hypervisor

$ popd

构建后的二进制文件位于$CLOUDH/cloud-hypervisor/target/release/cloud-hypervisor。

容器化构建和测试

若不想安装所有依赖项（如Rust工具链、cargo工具等），可使用开发脚本dev_cli.sh进行容器化构建和测试。首次运行时会拉取较大的容器镜像。

构建发布版二进制文件：

shell
$ pushd $CLOUDH
$ cd cloud-hypervisor
$ ./scripts/dev_cli.sh build --release

本地运行单元测试：

shell
$ ./scripts/dev_cli.sh tests --unit

查看所有支持的命令和选项：

shell
$ ./scripts/dev_cli.sh --help

运行虚拟机

可通过现有云镜像或自定义内核和磁盘镜像启动客户机VM。

使用云镜像

依赖https://github.com/cloud-hypervisor/rust-hypervisor-firmware%E6%8F%90%E4%BE%9BELF%E6%A0%BC%E5%BC%8F%E7%9A%84KVM%E5%9B%BA%E4%BB%B6%E3%80%82%E4%BB%A5%E4%B8%8B%E4%BD%BF%E7%94%A8Ubuntu%E4%BA%91%E9%95%9C%E5%83%8F%E7%A4%BA%E4%BE%8B%EF%BC%9A

shell
$ pushd $CLOUDH
$ wget https://cloud-images.ubuntu.com/focal/current/focal-server-cloudimg-amd64.img
$ qemu-img convert -p -f qcow2 -O raw focal-server-cloudimg-amd64.img focal-server-cloudimg-amd64.raw
$ wget https://github.com/cloud-hypervisor/rust-hypervisor-firmware/releases/download/0.2.8/hypervisor-fw
$ popd

启动虚拟机：

shell
$ pushd $CLOUDH
$ sudo setcap cap_net_admin+ep ./cloud-hypervisor/target/release/cloud-hypervisor
$ ./cloud-hypervisor/target/release/cloud-hypervisor \
    --kernel ./hypervisor-fw \
    --disk path=focal-server-cloudimg-amd64.raw \
    --cpus boot=4 \
    --memory size=1024M \
    --net "tap=,mac=,ip=,mask=" \
    --rng
$ popd

--disk参数可指定多个磁盘。

使用自定义内核和磁盘镜像

构建内核

支持直接引导vmlinux ELF内核或bzImage。以下使用Cloud Hypervisor开发分支内核：

shell
$ pushd $CLOUDH
$ git clone --depth 1 https://github.com/cloud-hypervisor/linux.git -b virtio-fs-virtio-iommu-virtio-mem-5.6-rc4 linux-cloud-hypervisor
$ pushd linux-cloud-hypervisor

# 使用Cloud Hypervisor内核配置构建
$ cp $CLOUDH/cloud-hypervisor/resources/linux-config-x86_64 .config
$ make bzImage -j `nproc`
$ popd

内核镜像位于linux-cloud-hypervisor/arch/x86/boot/compressed/vmlinux.bin。

准备磁盘镜像

使用包含根分区的Ubuntu云镜像：

shell
$ pushd $CLOUDH
$ wget https://cloud-images.ubuntu.com/focal/current/focal-server-cloudimg-amd64.img
$ qemu-img convert -p -f qcow2 -O raw focal-server-cloudimg-amd64.img focal-server-cloudimg-amd64.raw
$ popd

启动客户机VM

使用4个vCPU和1024MB内存启动：

shell
$ pushd $CLOUDH
$ sudo setcap cap_net_admin+ep ./cloud-hypervisor/target/release/cloud-hypervisor
$ ./cloud-hypervisor/target/release/cloud-hypervisor \
    --kernel ./linux-cloud-hypervisor/arch/x86/boot/compressed/vmlinux.bin \
    --disk path=focal-server-cloudimg-amd64.raw \
    --cmdline "console=hvc0 root=/dev/vda1 rw" \
    --cpus boot=4 \
    --memory size=1024M \
    --net "tap=,mac=,ip=,mask=" \
    --rng

如需更早的内核调试信息，可使用传统串口控制台：

shell
$ ./cloud-hypervisor/target/release/cloud-hypervisor \
    --kernel ./linux-cloud-hypervisor/arch/x86/boot/compressed/vmlinux.bin \
    --console off \
    --serial tty \
    --disk path=focal-server-cloudimg-amd64.raw \
    --cmdline "console=ttyS0 root=/dev/vda1 rw" \
    --cpus boot=4 \
    --memory size=1024M \
    --net "tap=,mac=,ip=,mask=" \
    --rng

项目状态

Cloud Hypervisor处于活跃开发中，不保证API或功能稳定性。截至2020-07-02，支持以下云镜像：

Ubuntu Bionic (cloudimg)
Ubuntu Focal (cloudimg)

直接内核引导至用户空间可与大多数发行版的rootfs配合使用。

热插拔

支持CPU、直通设备（VFIO）、virtio-{net,block,pmem,fs,vsock}的热插拔及内存调整。详细操作参见https://github.com/cloud-hypervisor/cloud-hypervisor/blob/master/docs/hotplug.md%E3%80%82

设备模型

设备模型详情参见https://github.com/cloud-hypervisor/cloud-hypervisor/blob/master/docs/device_model.md%E3%80%82

TODO

通过https://github.com/cloud-hypervisor/cloud-hypervisor/issues/new%E8%B7%9F%E8%B8%AA%E5%BE%85%E5%8A%9E%E4%BA%8B%E9%A1%B9%E3%80%82

rust-vmm项目依赖

为实现高性能、安全的虚拟化目标，Cloud Hypervisor采用Rust语言开发，其内存和线程安全特性使其成为VMM实现的理想选择。

Cloud Hypervisor不从头实现VMM组件，而是导入https://github.com/rust-vmm crates，与Amazon的https://fire***er-microvm.github.io/%E5%92%8CGoogle%E7%9A%84crosvm%E7%AD%89VMM%E5%85%B1%E4%BA%AB%E4%BB%A3%E7%A0%81%E5%92%8C%E6%9E%B6%E6%9E%84%E3%80%82

Cloud Hypervisor与rust-vmm项目的关系：

尽可能使用rust-vmm代码，相关新crate将尽快集成
对rust-vmm中缺失的特性（如ACPI、VFIO、vhost-user等），将在Cloud Hypervisor中实现测试并贡献回rust-vmm

Fire***er和crosvm

Cloud Hypervisor的部分代码基于Fire***er或crosvm的实现，这两个均为Rust编写的VMM，注重安全。但Cloud Hypervisor既非两者的分支也非重实现，其目标是支持云工作负载（即云服务提供商租户运行的现代完整Linux发行版镜像），而非客户端或无服务器场景，因此代码库已开始分化，并将通过rust-vmm共享基础虚拟化代码。

社区

Cloud Hypervisor项目遵循https://github.com/cloud-hypervisor/community%E4%BB%93%E5%BA%93%E4%B8%AD%E6%8F%8F%E8%BF%B0%E7%9A%84%E6%B2%BB%E7%90%86%E5%92%8C%E7%A4%BE%E5%8C%BA%E6%8C%87%E5%8D%97%E3%80%82

贡献

我们致力于围绕Cloud Hypervisor构建全球、多元化、协作的社区。任何对贡献感兴趣的人都欢迎参与。贡献不仅包括代码提交，还包括测试、文档、PR审查、bug报告、功能请求、项目改进建议等。详见贡献文档。

加入我们

获取Slack频道邀请，并加入Slack。

镜像拉取方式

您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问标签列表页面。

轩辕镜像加速拉取命令点我查看更多 dev 镜像标签

docker pull docker.xuanyuan.run/cloudhypervisor/dev:<标签>

使用方法：

DockerHub 原生拉取命令

docker pull cloudhypervisor/dev:<标签>

轩辕镜像配置手册

按平台快速找到配置文档

Docker

登录仓库拉取

登录认证 · 私有仓库

专属域名拉取

免登录 · 高速拉取

Linux

Docker 镜像配置

Windows / Mac

Docker Desktop 配置

MacOS OrbStack

OrbStack 容器

Docker Compose

Compose 项目配置

NAS

群晖

Synology 配置

飞牛

fnOS 镜像配置

绿联

绿联 NAS

威联通

QNAP 配置

极空间

极空间 NAS

企业仓库

其他仓库

ghcr · Quay · nvcr

Harbor 镜像源

Proxy Repository 对接

Portainer 镜像源

Registries 配置

Nexus 镜像源

Docker Proxy 缓存

开发工具

Dev Containers

VS Code 开发容器

Podman

Podman 配置指南

Singularity / Apptainer

HPC 科学计算容器

Kubernetes

K8s Containerd

Kubernetes · Containerd

K3s

轻量级集群

面板 / 网络

爱快路由

iKuai 镜像加速

宝塔面板

一键配置镜像源

AI

用 AI 使用轩辕镜像

agents.md · AI 对话 · 提示词

一键安装

一键安装 Docker

Linux Docker 一键安装

需要其他帮助？请查看我们的常见问题Docker 镜像访问常见问题解答或提交工单

镜像拉取常见问题

功能

免费版与专业版区别

功能对比 · 版本选择

支持的镜像仓库

Docker Hub · GCR · GHCR

新手拉取配置

docker search 限制

专属域名 · Hub 搜索

不支持 push

仅支持 pull · 不支持

拉取速度原因

带宽 · 缓存 · 冷热镜像

错误码

402 与流量用尽

402 · 流量包 · 充值

401 认证失败

401 · docker login

manifest unknown

标签错误 · 镜像不存在

410 Gone 排查

410 · Docker 升级

429 限流

免费版 · 请求频率

其他报错

DNS 超时

DNS 解析 · 网络超时

TLS 证书失败

no matching manifest（架构）

账号

失败是否计费

manifest · blob · 计费

申请开发票（企业 / 个人）

企业 · 个人 · 工单

修改登录密码

网站 · 仓库 · 重置

注销账户

工单 · 数据 · 注销

原理

mirrors 不生效

daemon.json · 重启

去掉域名前缀

docker tag · 重命名

指定架构拉取

ARM64 · AMD64 · 多架构

latest 与「最新」

digest · 版本号 · 标签

查看全部问题→

用户好评

来自真实用户的反馈，见证轩辕镜像的优质服务

oldzhang

运维工程师

Linux服务器

"Docker访问体验非常流畅，大镜像也能快速完成下载。"

请先完整阅读并严格遵守以下文档中的全部规则与要求： https://xuanyuan.cloud/agents.md 在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。

shell

$ pushd $CLOUDH
$ git clone https://github.com/cloud-hypervisor/cloud-hypervisor.git
$ cd cloud-hypervisor
$ cargo build --release

# 为cloud-hypervisor二进制文件添加NET_ADMIN权限以设置主机TAP接口
$ sudo setcap cap_net_admin+ep ./target/release/cloud-hypervisor

$ popd

shell

$ pushd $CLOUDH
$ wget https://cloud-images.ubuntu.com/focal/current/focal-server-cloudimg-amd64.img
$ qemu-img convert -p -f qcow2 -O raw focal-server-cloudimg-amd64.img focal-server-cloudimg-amd64.raw
$ wget https://github.com/cloud-hypervisor/rust-hypervisor-firmware/releases/download/0.2.8/hypervisor-fw
$ popd

shell

$ pushd $CLOUDH
$ sudo setcap cap_net_admin+ep ./cloud-hypervisor/target/release/cloud-hypervisor
$ ./cloud-hypervisor/target/release/cloud-hypervisor \
    --kernel ./hypervisor-fw \
    --disk path=focal-server-cloudimg-amd64.raw \
    --cpus boot=4 \
    --memory size=1024M \
    --net "tap=,mac=,ip=,mask=" \
    --rng
$ popd

shell

$ pushd $CLOUDH
$ git clone --depth 1 https://github.com/cloud-hypervisor/linux.git -b virtio-fs-virtio-iommu-virtio-mem-5.6-rc4 linux-cloud-hypervisor
$ pushd linux-cloud-hypervisor

# 使用Cloud Hypervisor内核配置构建
$ cp $CLOUDH/cloud-hypervisor/resources/linux-config-x86_64 .config
$ make bzImage -j `nproc`
$ popd

shell

$ pushd $CLOUDH
$ wget https://cloud-images.ubuntu.com/focal/current/focal-server-cloudimg-amd64.img
$ qemu-img convert -p -f qcow2 -O raw focal-server-cloudimg-amd64.img focal-server-cloudimg-amd64.raw
$ popd

shell

$ pushd $CLOUDH
$ sudo setcap cap_net_admin+ep ./cloud-hypervisor/target/release/cloud-hypervisor
$ ./cloud-hypervisor/target/release/cloud-hypervisor \
    --kernel ./linux-cloud-hypervisor/arch/x86/boot/compressed/vmlinux.bin \
    --disk path=focal-server-cloudimg-amd64.raw \
    --cmdline "console=hvc0 root=/dev/vda1 rw" \
    --cpus boot=4 \
    --memory size=1024M \
    --net "tap=,mac=,ip=,mask=" \
    --rng

shell

$ ./cloud-hypervisor/target/release/cloud-hypervisor \
    --kernel ./linux-cloud-hypervisor/arch/x86/boot/compressed/vmlinux.bin \
    --console off \
    --serial tty \
    --disk path=focal-server-cloudimg-amd64.raw \
    --cmdline "console=ttyS0 root=/dev/vda1 rw" \
    --cpus boot=4 \
    --memory size=1024M \
    --net "tap=,mac=,ip=,mask=" \
    --rng

镜像拉取方式

您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问标签列表页面。