# kvm-cloud
**Repository Path**: cj520120/kvm-cloud
## Basic Information
- **Project Name**: kvm-cloud
- **Description**: KVM Cloud 是一款基于Java实现的轻量级私有云平台，旨在帮助中小企业快速实现计算、存储、网络等资源的管理，让企业拥有自己的云平台。
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 331
- **Forks**: 140
- **Created**: 2021-06-08
- **Last Updated**: 2026-04-30
## Categories & Tags
**Categories**: containers
**Tags**: None
## README
中文 | [English](README-en.md)
### 项目介绍
KVM Cloud 是一款基于Java实现的轻量级私有云平台，旨在帮助中小企业快速实现计算、存储、网络等资源的管理，让企业拥有自己的云平台，包括但不限于如下功能:
- 基于KVM的VM基础功能(创建、启动、停止、重装、webVNC等功能)
- 支持NFS、glusterfs、Ceph RBD磁盘存储池
- 支持磁盘动态添加取消
- 多主机管理
- 支持模版维护，用于快速创建VM
- 虚拟机IP自动管理
- 多网卡支持
- 通过OVS支持Vlan网络划分
- 支持cloud-init配置初始化
- 支持内部dns解析
- 支持nat转发
- 支持密钥管理登录
- 支持主机名定制
### 操作系统
Linux(目前只提供x86_64架构)
### 托管地址
[AtomGit](https://gitcode.com/cj520120/kvm-cloud)
[Gitee](https://gitee.com/cj520120/kvm-cloud)
[Github](https://github.com/cj520120/kvm-cloud)
如果项目对您有帮助，欢迎Star和Fork，您的Star是对我最大的支持。
### 配置说明
文档只提供基于Centos7的配置说明，Ubuntu参考[Ubuntu_README.md](Ubuntu_README.md),其他系统请自行查阅相关资料
### SELinux配置
```sh
setenforce 0
vi /etc/selinux/config
SELINUX=permissive
```
### sysctl配置
```sh
vim /etc/sysctl.conf
net.ipv4.ip_forward=1 # 设置转发并保存
sysctl -p
```
### 防火墙配置
```sh
systemctl stop firewalld
systemctl disable firewalld
systemctl stop iptables
systemctl disable iptables
systemctl stop NetworkManager
systemctl disable NetworkManager
```
### NFS配置
#### 1、安装NFS软件包
```sh
yum -y install nfs-utils rpcbind
```
#### 2、设置开机自启以及启动服务
```sh
systemctl enable rpcbind
systemctl enable nfs-server
systemctl start rpcbind
systemctl start nfs-server
```
#### 3、新建存储文件夹
```sh
mkdir -p /data/nfs
```
#### 4、编辑配置
```sh
vi /etc/exports
/data/nfs *(rw,sync,no_root_squash)
```
#### 5、重新加载exportfs文件
```sh
exportfs -a
```
#### 6、重新服务
```sh
systemctl restart rpcbind
systemctl restart nfs-server
```
#### 7、测试挂载是否正常
```sh
mount -t nfs 127.0.0.1:/data/nfs /mnt
df -h ###查看有了代表成功
umount /mnt
```
### KVM
#### 1、验证主机是否支持虚拟化
```sh
lsmod | grep kvm #查看结果确认是否支持虚拟化
如果是vmware开启的虚拟机，请启用虚拟化技术
```
#### 2、主机安装KVM
```sh
yum install qemu-kvm libvirt bridge-utils
yum install java-1.8.0-openjdk* -y
```
#### 3、配置KVM主机网桥，增加一个网桥
这一步一定注意：使用`ip addr`查看你的`网卡名`，在`CentOS 7`中网卡名可能不是`eth0`，错误的网卡名会导致后期配置的虚拟机无法正常被访问到！
确认网卡名无误后配置网桥：
1)、创建桥接网卡文件/etc/sysconfig/network-scripts/ifcfg-br0
```sh
DEVICE=br0
TYPE=Bridge
ONBOOT=yes
BOOTPROTO=static
IPADDR=192.168.2.130
NATMASK=255.255.255.0
PREFIX=24
GATEWAY=192.168.2.1
DNS1=8.8.4.4
DNS2=8.8.8.8
```
2)、修改默认网卡配置
> **下面这个编辑 注意改成 ifcfg-实际网卡名,例如eth0，对应文件为:/etc/sysconfig/network-scripts/ifcfg-eth0**
```sh
BOOTPROTO=none
NAME=eth0
DEVICE=eth0
ONBOOT=yes
NM_CONTRLLED=no
BRIDGE=br0
```
3)、如需ovs配置，请参考[ovs-bridge-sample.md](scripts/ovs-bridge-sample.md)
#### 4、VNC配置
```sh
vi /etc/libvirt/qemu.conf
vnc_listen="0.0.0.0"
user = "root"
group = "root"
```
#### 5、Libvirtd配置
1)、修改/etc/sysconfig/libvirtd 配置
```sh
vi /etc/libvirt/libvirtd.conf
listen_tls = 0
listen_tcp = 1
unix_sock_group = "root"
unix_sock_rw_perms = "0777"
auth_unix_ro = "none"
auth_unix_rw = "none"
tcp_port = "16509"
listen_addr = "0.0.0.0"
auth_tcp = "none"
vi /etc/sysconfig/libvirtd
LIBVIRTD_ARGS="--listen"
systemctl restart libvirtd
```
#### 项目编译
```$xslt
mvn clean package -Dfile.encoding=UTF-8 -DskipTests=true
```
### 完成配置
1、导入mysql表及相关数据
> **脚本位于scripts下**
2、安装Redis
3、修改配置文件
4、分别启动管理端及Agent端，浏览页面：http://localhost:8080/
```
管理端: java -jar cloud-management-1.0-SNAPSHOT.jar --spring.config.location=server.yaml
Agent: java -jar cloud-agent-1.0-SNAPSHOT.jar --spring.config.location=client.properties
--spring.config.location 是可选项，用于指定配置文件，如果不需要修改，可以去掉,配置文件为各自模块下的src/main/resources/application.properties文件
```
5、平台登陆账号默认用户名/密码:admin/123456
6、创建基础网络
> **采用桥接网络配置，IP地址段与主机主机段需保持一致，可通过起始IP与结束IP和主机网络进行分离，防止IP冲突,Vlan只支持OVS方式**
7、创建主机`
`
8、创建存储池(只支持nfs)
9、下载基础模版
```$xslt
使用基于 RedHat、支持 iptables的官方镜像，示例如下：
> https://yum.oracle.com/templates/OracleLinux/OL10/u1/x86_64/OL10U1_x86_64-kvm-b270.qcow2
请务使用国内发行版镜像，国内版本对 cloud-init 的支持存在差异，可能导致系统初始化失败；若确有使用需求，请自行测试兼容性。
备用下载地址（官方链接失效时）
模版路径：cloud/v5/OL10U1_x86_64-kvm-b270.qcow2
百度网盘链接：https://pan.baidu.com/s/1bOAeuvFj8hG4skDaoZnYtQ?pwd=1bpn 提取码：1bpn
注意事项
1、系统模版初始化过程中需要通过网络下载安装包，需保证网络配置正常；
2、初始化耗时由网络速度决定，可使用virsh console命令登录系统自行查看初始化状态。
模版默认账号信息
默认用户名：kvm-user
默认密码：Kvm@123456
```
10、配置系统模版
11、等待系统模版下载完成，并初始化系统VM成功
12、windows附加磁盘时请安装virtio-win.iso驱动
13、创建VM
### 相关问题
1、关于找不到配置文件问题导致数据库连接问题
```$xslt
server.yaml 和 client.properties 内容分别为management和agent项目下的application.yaml和application.properties的文件，运行时自行修改名称及相关配置
```
2、关于备份与恢复
```$xslt
对数据库和存储池进行完整备份；
数据无价，建议对虚拟机中的数据进行备份
```
3、关于网络隔离
```$xslt
1、目前只支持OVS桥接状态下的Vlan模式，如需使用，请自行安装OVS。
```
4、个别windows系统无法找到引导的问题
```$xslt
1、首先确认创建的ISO系统类型是否正确
2、如果确认系统类型没有问题，可以通过老毛桃做一个PE的ISO镜像，在创建系统的时候可以通过PE镜像创建，然后进入PE系统，在页面上卸载光盘，重新挂载你要安装的操作系统，然后通过PE安装就可以正常安装了
```
5、windows系统磁盘不识别问题
```$xslt
1、windows没有virto的驱动，请安装virtio-win.iso驱动
2、如果是系统盘则需要在磁盘选择页面临时挂载virtio-win.iso驱动后安装或选择ide总线方式
```
6、服务器掉电重启后处理
```$xslt
掉电可能引起虚拟磁盘损坏，如无法启动，可通过qemu-img check检查并进行相应修复
```
7、虚拟机虚拟化嵌套
- 验证KVM 宿主机是否启用了嵌套虚拟化：
```$xslt
基于 Intel 的处理器运行以下命令：cat /sys/module/kvm_intel/parameters/nested
基于 AMD 的处理器运行以下命令： cat /sys/module/kvm_amd/parameters/nested
上述命令输出N /0表示嵌套虚拟化是禁用的。如果我们得到的输出是Y/1 则表示在您的宿主机已启用嵌套虚拟化
```
- 如果需要启用嵌套虚拟化，使用以下内容创建一个文件名为/etc/modprobe.d/kvm-nested.conf 的文件：
```$xslt
options kvm-intel nested=1
options kvm-intel enable_shadow_vmcs=1
options kvm-intel enable_apicv=1
options kvm-intel ept=1
```
- reboot 重启机器
- 现在验证嵌套虚拟化功能是否启用
```$xslt
cat /sys/module/kvm_intel/parameters/nested
```
8、cloud-init相关配置
- cloud-init数据源采用NoCloud,请修改cloud相关配置如下:
```$xslt
datasource:
NoCloud:
seedfrom: http://169.254.169.254/
datasource_list: [ NoCloud ]
```
- 用户模版需要安装qemu-guest-agent，并且启用guest-exec，否则无法配置启动初始化
9、页面删除主机后，如需要重新加入主机，请删除该主机Agent目录下config.json，然后重启Agent
10、关于提示签名错误问题，请确保管理端跟agent端时间同步
11、修改默认machine设置
```$xslt
需要调整系统配置项vm.machine.name和vm.machine.arch
具体支持的配置需要根据操作系统决定,具体查询命令如下:
Centos: /usr/libexec/qemu-kvm -machine help
Ubuntu: qemu-system-i386 -machine help
```
12、UEFI 支持
```$xslt
需要调整系统配置项vm.uefi.loader.path 、vm.uefi.loader.vargs.template.path 、vm.uefi.loader.vargs.base.path
```
13、关于网络不通问题
```$xslt
尽量使用纯净系统安装，如果网络不通，请检查防火墙、iptables等
```
14、关于ubuntu无法启动虚拟机问题
```$xslt
ubuntu 提示qemu-system-x86_64: unable to map backing store for guest RAM: Cannot allocate memory
关闭大页缓存，修改配置vm.memory.huge.pages.enable和vm.memory.huge.pages.size，或在/etc/sysctl.conf 中追加 vm.nr_hugepages=10240 #具体值请根据实际情况修改
```