Kimchi 项目安装与使用教程

概述

Kimchi 是一个基于 HTML5 的 KVM（Kernel-based Virtual Machine）虚拟机管理工具，旨在让用户能够轻松开始使用 KVM 并创建第一个虚拟机。作为 Wok 项目的插件，Kimchi 通过 libvirt 管理 KVM 虚拟机，并通过支持 HTML5 的浏览器提供 Web 管理界面。

系统要求

硬件要求

• 支持硬件虚拟化的 CPU（Intel VT-x 或 AMD-V）
• 至少 2GB RAM（推荐 4GB 或更多）
• 足够的磁盘空间用于虚拟机存储

软件要求

• Linux 操作系统（支持 Fedora、Debian、Ubuntu、openSUSE 等）
• KVM 和 libvirt 已安装并配置
• Python 3.x
• 现代浏览器（Chrome、Firefox、Safari、Edge）

安装步骤

1. 安装 Wok 框架

Kimchi 作为 Wok 的插件运行，首先需要安装 Wok：

# Fedora
sudo dnf install wok

# Debian/Ubuntu
sudo apt install wok

# openSUSE
sudo zypper install wok

2. 安装 Kimchi 依赖

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 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

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 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

3. 从源码安装 Kimchi

# 克隆项目
git clone https://gitcode.com/gh_mirrors/ki/kimchi.git
cd kimchi

# 构建和安装
sudo ./autogen.sh --system
make

# 安装到系统
sudo make install

# 或者创建安装包
make deb    # 创建 .deb 包
make rpm    # 创建 .rpm 包

4. 配置 Kimchi

编辑配置文件 /etc/kimchi/kimchi.conf：

[wok]
# 在 Wok 服务器上启用 Kimchi 插件
enable = True

[kimchi]
# 在服务器启动时自动创建 ISO 池
create_iso_pool = True
# 是否为 Web 界面启用截图功能
take_screenshot = True

启动和使用

启动 Wok 服务

# 启动 Wok 服务
sudo systemctl start wokd

# 设置开机自启
sudo systemctl enable wokd

# 检查服务状态
sudo systemctl status wokd

访问管理界面

在浏览器中访问：https://localhost:8001

默认使用 PAM 认证，可以使用系统用户名和密码登录。

功能特性

虚拟机管理

• 创建、启动、停止、重启虚拟机
• 实时虚拟机监控
• 虚拟机克隆和迁移
• 快照管理

存储管理

• 存储池管理（本地、NFS、iSCSI）
• 存储卷管理
• ISO 镜像管理

网络管理

• 虚拟网络配置
• 网络接口管理
• 网桥配置

模板系统

• 基于模板创建虚拟机
• 自定义模板参数
• 模板克隆和修改

使用示例

创建虚拟机模板

flowchart TD
    A[登录 Kimchi 界面] --> B[点击 Templates 标签]
    B --> C[点击 + 按钮创建新模板]
    C --> D[配置模板参数<br>名称、操作系统、内存、CPU]
    D --> E[选择安装介质<br>ISO 镜像或网络安装]
    E --> F[配置存储<br>选择存储池和磁盘大小]
    F --> G[配置网络<br>选择网络接口和类型]
    G --> H[保存模板]
    H --> I[使用模板创建虚拟机]

虚拟机创建参数表

参数	描述	推荐值
名称	虚拟机名称	my-vm-01
内存	分配内存大小	2048 MB
CPU	虚拟 CPU 数量	2
磁盘	虚拟磁盘大小	20 GB
网络	网络接口类型	virtio
显卡	显示适配器	VGA

存储池配置示例

# 创建目录存储池
sudo virsh pool-define-as default dir - - - - "/var/lib/libvirt/images"
sudo virsh pool-build default
sudo virsh pool-start default
sudo virsh pool-autostart default

# 创建 NFS 存储池
sudo virsh pool-define-as nfs-pool netfs - - - - "nfs-server:/export/path"
sudo virsh pool-build nfs-pool
sudo virsh pool-start nfs-pool

高级功能

虚拟机迁移

Kimchi 支持实时迁移功能：

sequenceDiagram
    participant User
    participant Kimchi
    participant Source Host
    participant Target Host
    
    User->>Kimchi: 发起迁移请求
    Kimchi->>Source Host: 准备迁移
    Source Host->>Target Host: 建立连接
    Target Host->>Source Host: 确认准备就绪
    Source Host->>Target Host: 传输内存状态
    Target Host->>Source Host: 确认接收
    Source Host->>Target Host: 完成迁移
    Target Host->>Kimchi: 迁移完成
    Kimchi->>User: 显示迁移结果

API 接口使用

Kimchi 提供 RESTful API 接口：

import requests
import json

# 认证信息
auth = ('username', 'password')
base_url = 'https://localhost:8001/plugins/kimchi'

# 获取虚拟机列表
def get_vms():
    response = requests.get(f'{base_url}/vms', auth=auth, verify=False)
    return response.json()

# 创建虚拟机
def create_vm(template_name, vm_name):
    data = {
        'template': template_name,
        'name': vm_name
    }
    response = requests.post(f'{base_url}/vms', 
                           auth=auth, 
                           json=data, 
                           verify=False)
    return response.json()

# 示例使用
vms = get_vms()
print(f"当前虚拟机: {vms}")

故障排除

常见问题解决

1. 无法访问 Web 界面

   # 检查防火墙设置
   sudo firewall-cmd --add-port=8001/tcp --permanent
   sudo firewall-cmd --reload
   
   # 检查服务状态
   sudo systemctl status wokd
   sudo journalctl -u wokd -f
   

2. 缺少虚拟化标签

   # 使用开发模式运行以获取详细错误信息
   sudo python3 /usr/bin/wokd --environment=dev
   

3. NFS 存储池权限问题

   # 确保 NFS 导出路径配置正确
   # /etc/exports 示例：
   /export/path *(all_squash,anongid=36,anonuid=36,rw,sync)
   

性能优化建议

优化项目	建议配置	效果
内存分配	根据负载动态调整	提高资源利用率
CPU 拓扑	匹配物理 CPU 拓扑	提升性能
磁盘缓存	使用 writeback 模式	提高 I/O 性能
网络驱动	使用 virtio 驱动	降低网络延迟

安全考虑

安全最佳实践

1. 使用 HTTPS

   # 配置 SSL 证书
   sudo openssl req -new -newkey rsa:2048 -days 365 -nodes -x509 \
   -keyout /etc/kimchi/key.pem -out /etc/kimchi/cert.pem
   

2. 访问控制

   # 配置防火墙规则
   sudo firewall-cmd --remove-port=8001/tcp --permanent
   sudo firewall-cmd --add-rich-rule='rule family="ipv4" source address="192.168.1.0/24" port port="8001" protocol="tcp" accept' --permanent
   sudo firewall-cmd --reload
   

3. 定期更新

   # 定期检查更新
   git pull origin master
   sudo make install
   

总结

Kimchi 提供了一个强大且易用的 KVM 虚拟机管理解决方案，通过 Web 界面简化了虚拟化的复杂性。本文详细介绍了从安装配置到高级使用的完整流程，包括：

• ✅ 系统要求和依赖安装
• ✅ 源码编译和包管理安装
• ✅ 基本配置和服务启动
• ✅ 虚拟机创建和管理
• ✅ 存储和网络配置
• ✅ 高级功能和 API 使用
• ✅ 故障排除和性能优化

通过遵循本教程，您可以快速搭建和管理基于 KVM 的虚拟化环境，享受 Kimchi 带来的便捷管理体验。

下一步建议：

• 探索 Kimchi 的模板系统，创建自定义虚拟机模板
• 尝试使用 API 接口进行自动化管理
• 配置高可用性和负载均衡方案
• 参与社区贡献，报告问题或提交改进

享受您的 Kimchi 虚拟化之旅！