Libvirt 是一个开源的虚拟化管理工具包，它提供了一套标准化的接口（API、命令行工具、守护进程等），用于统一管理多种不同的虚拟化技术（如 KVM、Xen、QEMU、LXC 等）。其核心目标是 简化虚拟化环境的操作和开发，让用户无需直接接触底层虚拟化技术的复杂命令。
DoraCloud是一套多平台、一体化、分布式的桌面虚拟化方案。基于开放架构，支持多种虚拟化平台（Hyper-V，VMware，Proxmox，XenServer），多种桌面协议（RDP，PCoIP，SPICE）。
为了支持国产化和信创，DoraCloud新增了对LibVirt的支持。 DoraCloud可以通过LibVirt API对接国产的操作系统，如麒麟服务器操作系统、OpenEuler。
本文介绍了部署 银河麒麟服务器操作系统V10，并搭建DoraCloud桌面虚拟化系统的过程。
安装前准备：
1、一台服务器，配置为 :CPU i5 以上，内存 ≥8GB，硬盘为 SSD 。
2、网络中开启了 DHCP 服务。
3、银河麒麟服务器操作系统V10 Sp3 2403。
银河麒麟服务器操作系统 Kylin-Server-V10-SP3-2403-Release-20240426-x86_64.iso 官方地址： https://product.kylinos.cn/productCase/42/25
4、U盘制作工具：rufus rufus下载地址
步骤一：安装银河麒麟服务器V10
1、通过U盘启动服务器，进入银河麒麟 V10 Server Sp1 202403的安装程序。
2、启用网卡。
3、选择"带UKUI GUI的服务器"，勾选“虚拟化Hypervisor”、“虚拟化工具”。
4、设置ROOT密码，然后启动安装。
5、服务器启动后，确认 软件协议。
6、登录服务器，进入 shell，执行 nmtui ，选择 自动启动网卡。
步骤二：开启服务器RDP远程、创建虚拟交换机
为了便于登陆服务器，对服务器进行远程管理，我们为麒麟服务器安装安装 xrdp 服务，这样可以通过RDP客户端连接服务器。
1、安装RDP服务器，便于远程登录服务器
# 1. 安装 virt-install 工具
yun install -y virt-install
# 2. 安装 xrdp，便于远程到服务器
yum install -y https://dl.fedoraproject.org/pub/epel/8/Everything/x86_64/Packages/x/xrdp-0.10.3-1.el8.x86_64.rpm
systemctl enable --now xrdp
systemctl status xrdp
# 3. 关闭防火墙，便于远程访问。
systemctl stop firewalld.service
systemctl disable firewalld.service
xrdp 服务安装完毕后，可以通过RDP客户端连接麒麟服务器。
2、创建虚拟机交换机
通过以下脚本，创建一个网桥 bridge0，网桥使用当前的网卡 p2p1
# 1. 创建网桥设备bridge0
sudo nmcli connection add type bridge con-name bridge0 ifname bridge0
# 2. 将物理网卡p2p1添加为网桥的从属接口
sudo nmcli connection add type bridge-slave con-name bridge0-p2p1 ifname p2p1 master bridge0
# 3. 激活网桥配置
sudo nmcli connection up bridge0
通过以下脚本，将网桥添加为虚拟交换机 bridge0
cat >bridge0.xml <<EOF
<network>
<name>bridge0</name>
<forward mode="bridge"/>
<bridge name="bridge0"/>
</network>
EOF
virsh net-define bridge0.xml
virsh net-start bridge0
virsh net-autostart bridge0
脚本执行成功后，通过 ip a 命令检查，可以看到一个名为 bridge0 的设备，并且有IP地址。
登陆麒麟桌面，启动 virt-manager ，可以看到虚拟交换机中有一个 bridge0 的虚拟交换机。
步骤三：下载安装DoraCloud和虚拟机模板
方式1：一键在线安装：
1、通过ssh 登陆麒麟服务器，执行如下一键安装脚本。
cd /var/lib/libvirt/images; curl -o- https://dl.doracloud.cn/libvirt/x86_64/autoinstall.sh --referer https://doracloud.cn |bash
以下是安装过程的记录。
[root@localhost ~]# cd /var/lib/libvirt/images; curl -o- https://dl.doracloud.cn/libvirt/x86_64/autoinstall.sh --referer https://doracloud.cn |bash
% Total % Received % Xferd Average Speed Time Time Time Current
Dload Upload Total Spent Left Speed
100 4465 100 4465 0 0 61164 0 --:--:-- --:--:-- --:--:-- 61164
[2025-06-20 18:43:03] ==========================================
[2025-06-20 18:43:03] 开始DoraCloud自动安装
[2025-06-20 18:43:03] ==========================================
[2025-06-20 18:43:03] 切换到目标目录: /var/lib/libvirt/images
[2025-06-20 18:43:03] 下载安装脚本: https://dl.doracloud.cn/libvirt/x86_64/install.sh
######################################################################## 100.0%
[2025-06-20 18:43:03] 设置安装脚本可执行权限
[2025-06-20 18:43:03] 下载MD5校验文件: https://dl.doracloud.cn/libvirt/x86_64/dpmd5.txt
[2025-06-20 18:43:03] 预期MD5值: 52312e9c85a24560038e493817038601
[2025-06-20 18:43:03] 找到 DoraCloud4.0-20250620.qcow2 的预期MD5值: 52312e9c85a24560038e493817038601
[2025-06-20 18:43:03] 下载镜像文件: https://dl.doracloud.cn/libvirt/x86_64/DoraCloud4.0-20250620.qcow2
######################################################################## 100.0%
[2025-06-20 18:45:27] 验证下载文件大小
[2025-06-20 18:45:27] 文件大小正常: DoraCloud4.0-20250620.qcow2 (1608MB)
[2025-06-20 18:45:27] 计算MD5校验和 (可能需要几分钟，取决于文件大小)...
[2025-06-20 18:45:29] 实际MD5值: 52312e9c85a24560038e493817038601
[2025-06-20 18:45:29] √ MD5校验成功!
[2025-06-20 18:45:29] 开始执行安装脚本
[2025-06-20 18:45:29] =*50
开始安装......
域创建完成。
[2025-06-20 18:45:29] =*50
[2025-06-20 18:45:29] DoraCloud自动安装成功完成!
[2025-06-20 18:45:29] 安装日志已保存至: /var/log/doracloud_autoinstall.log
安装完成!
您可以通过以下命令管理DoraCloud:
virsh list --all # 查看虚拟机状态
virsh start DoraCloud4.0-20250620 # 启动虚拟机
virsh console DoraCloud4.0-20250620 # 连接控制台
virt-viewer DoraCloud4.0-20250620 # 图形界面连接
完整的安装日志: sudo less /var/log/doracloud_autoinstall.log
[2025-06-20 18:45:29] 已清理临时文件
[root@localhost images]# virsh list --all
Id 名称 状态
---------------------------------------
157 DoraCloud4.0-20250620 运行中
[root@localhost images]# virsh domifaddr DoraCloud4.0-20250620 --source agent
名称 MAC 地址 Protocol Address
-------------------------------------------------------------------------------
lo 00:00:00:00:00:00 ipv4 127.0.0.1/8
ens3 52:54:00:cd:89:2a ipv4 192.168.1.165/24
安装完成后，DoraCloud Linux系统自动启动。并获得一个动态IP地址。 在浏览器中，输入IP地址，即可进入DoraCloud 后台。
方式2：下载后离线安装
1、下载 DoraCloud vm的备份 和 安装脚本。
DoraCloud for Libvirt_x64 下载链接
DoraCloud for Libvirt_x64 安装脚本
2、拷贝 qcow2 镜像和安装脚本 install.sh 到 Linux 主机的 /var/lib/libvirt/images 目录。
[root@localhost images]# pwd
/var/lib/libvirt/images
[root@localhost images]# ls -l
总用量 1646988
-rw-r--r-- 1 root root 1686508032 6月 20 14:56 DoraCloud4.0-20250620.qcow2
-rw-r--r-- 1 root root 484 6月 20 14:55 install.sh
[root@localhost images]# chmod +x install.sh
[root@localhost images]# ./install.sh
开始安装......
域创建完成。
[root@localhost images]# virsh list
Id 名称 状态
---------------------------------------
156 DoraCloud4.0-20250620 运行中
[root@localhost images]# virsh domifaddr DoraCloud4.0-20250620 --source agent
名称 MAC 地址 Protocol Address
-------------------------------------------------------------------------------
lo 00:00:00:00:00:00 ipv4 127.0.0.1/8
ens3 52:54:00:cd:89:2a ipv4 192.168.1.165/24
步骤四：DoraCloud系统初始化
1、浏览器输入https://DoraCloudIP（DoraCloud IP上一步看到的IP 本文输入为https://192.168.1.165 ）
注：DoraCloud管理平台默认采用https安全访问协议，在首次访问DoraCloud URL时，需要根据不同的浏览器提示，设置对该链接的信任。
默认的管理员登录账户为：用户名：admin 密码：deskpool
如果产品显示为DoraCloud的版本，默认的管理员登录账户为：用户名：admin 密码：DoraCloud
下图为登陆页面。
3、点击导航提示窗口中的开始按钮，进入系统初始化导航任务，如下图所示，提示用户系统初始化配置的主要内容，点击【继续】，开始系统初始化配置。
配置虚拟化： 选择Proxmox 输入Proxmox 服务器IP地址和用户(root)以及密码、输入完成后点击下一步，进入配置资源池
配置资源池： 桌面存储池选择 default 网络资源池配置 bridge0
如下图所示，配置完成后点击下一步进入集群配置。
配置集群： 选择创建一个新的DoraCloud集群。点击下一步进入配置用户数据库
配置用户数据库： 选择本地用户数据库，点击下一步。
步骤四：在远程镜像仓库下载模板
完成系统初始化设置后退出
1、 点击模板，选择远程镜像仓库
2、 选择如图所示kylinv10模板进行下载，下载完成以后恢复模板
步骤五：创建桌面池
桌面池是DoraCloud自动化管理桌面的基本模型，是指基于相同模板创建的，规格相同，类型相同、维护策略相同的桌面虚拟机集合。 模板创建成功后， DoraCloud导航接着提示用户开始创建桌面池，如下图所示。点击继续进入配置桌面池页面。
基本信息： 输入桌面池的名称，为桌面池选择模板和网络资源 并输入输入虚拟机的命名前缀和后缀。如下图 点击下一步进入配置桌面池策略。
重点强调，需要设置绑定账号。 从模板库下载的模板内置的账号为 administrator 123456
配置桌面池策略： 输入桌面池最大桌面虚拟机数和预创建桌面虚拟机参数，选择桌面类型。点击下一步进入配置存储。
配置存储： 设置是否启用用户数据盘，配置用户数据盘名称和容量。用户数据盘的存储池在系统初始化阶段指定。
步骤六：创建用户
创建桌面池后， DoraCloud导航会直接引导用户进入账户管理页面。
1、创建群组（用户->群组点击新增） 填写群组名称 并选择桌面池
2、批量创建用户（可以单独创建）
步骤七：可以通过多种方式登陆DoraCloud系统，连接桌面。 下面介绍 windows 上通过DoraClient登陆DoraCloud创建的桌面。
DoraClient是DoraCloud的客户端，可以用来登录我们的云桌面。
1.下载完毕，打开DoraClient，提示输入服务器地址，就是DoraCloud管理后台的地址。
2.输入在管理后台创建的用户名：user01，密码：123456,点击登录就会自动下载rdp文件进入云桌面。
