Kimchi项目：基于HTML5的KVM管理工具详解

Kimchi项目：基于HTML5的KVM管理工具详解

kimchi An HTML5 management interface for KVM guests 项目地址: https://gitcode.com/gh_mirrors/ki/kimchi

什么是Kimchi项目

Kimchi是一个基于HTML5的KVM虚拟机管理工具，它的核心目标是降低KVM虚拟化的使用门槛，帮助用户快速创建和管理虚拟机。作为Wok框架的插件运行，Kimchi通过libvirt与KVM进行交互，为用户提供直观的Web管理界面。

技术特点

1. 现代化Web界面：采用HTML5技术构建，支持响应式设计
2. 模板化部署：通过预定义模板简化虚拟机创建流程
3. 实时监控：提供虚拟机运行状态的实时可视化
4. 跨平台访问：任何支持HTML5的浏览器均可访问管理界面

环境准备与安装

系统要求

Kimchi支持多种Linux发行版，包括但不限于：

• Fedora
• Debian/Ubuntu
• openSUSE LEAP

依赖安装指南

Fedora系统

开发依赖：

sudo dnf install -y gcc make autoconf automake git python3-pip python3-requests python3-mock gettext-devel rpm-build libxslt gcc-c++ python3-devel python3-pep8 python3-pyflakes rpmlint python3-pyyaml
sudo -H pip3 install -r requirements-dev.txt

运行时依赖：

sudo dnf install -y python3-configobj python3-lxml python3-magic python3-paramiko python3-ldap spice-html5 novnc qemu-kvm python3-libvirt python3-pyparted python3-ethtool python3-pillow python3-cherrypy python3-libguestfs libvirt libvirt-daemon-config-network iscsi-initiator-utils libguestfs-tools sos nfs-utils
sudo -H pip3 install -r requirements-FEDORA.txt

Debian/Ubuntu系统

开发依赖：

sudo apt install -y gcc make autoconf automake git python3-pip python3-requests python3-mock gettext pkgconf xsltproc python3-dev pep8 pyflakes python3-yaml
sudo -H pip3 install -r requirements-dev.txt

运行时依赖：

sudo apt install -y python3-configobj python3-lxml python3-magic python3-paramiko python3-ldap spice-html5 novnc qemu-kvm python3-libvirt python3-parted python3-ethtool python3-guestfs python3-pil python3-cherrypy3 libvirt0 libvirt-daemon-system libvirt-clients nfs-common sosreport open-iscsi libguestfs-tools libnl-route-3-dev
sudo -H pip3 install -r requirements-UBUNTU.txt

构建与安装流程

1. 配置构建环境：

sudo ./autogen.sh --system

2. 编译项目：

make

3. 安装选项：

• 直接安装到系统：

sudo make install

• 生成Debian包：

make deb

• 生成RPM包：

make rpm

使用指南

登录管理界面

1. 在浏览器中访问：https://localhost:8001
2. 使用系统PAM凭证登录（与本地登录凭证相同）

主要功能界面

1. 虚拟机视图：

   • 显示所有运行中的虚拟机
   • 提供实时屏幕截图
   • 包含关机、连接等操作按钮

2. 模板管理：

   • 查看和修改现有模板
   • 创建新模板
   • 支持本地ISO或远程镜像文件

创建虚拟机步骤

1. 点击右上角"+"按钮
2. 选择或创建模板
3. 配置虚拟机参数
4. 确认创建

常见问题排查

无法访问服务

检查Wok服务是否正常运行，确认防火墙设置是否允许8001端口访问。

缺少虚拟化标签

在开发模式下运行Wok以获取详细错误信息：

sudo python3 /usr/bin/wokd --environment=dev

常见解决方案：

• 安装缺失的依赖项
• 检查Python环境配置

NFS存储池问题

确保NFS导出路径配置正确：

1. 设置适当的squash参数
2. 配置正确的用户/组权限

测试验证

执行测试套件确保功能正常：

make check-local
sudo make check

测试完成后会显示包含所有错误/失败的摘要信息。

高级配置技巧

1. 自定义ISO存储：默认路径为/var/lib/kimchi/isos，可修改配置使用自定义路径
2. 远程镜像支持：支持HTTP/FTP等协议的远程镜像文件
3. 模板优化：根据硬件配置调整模板参数以获得最佳性能

Kimchi项目为KVM虚拟化管理提供了简单高效的解决方案，特别适合需要快速部署和管理虚拟化环境的中小企业和个人开发者。通过其直观的Web界面，用户可以轻松完成从虚拟机创建到日常管理的各项操作。

kimchi An HTML5 management interface for KVM guests 项目地址: https://gitcode.com/gh_mirrors/ki/kimchi