跳到主要内容

QVMConsole 文档

欢迎使用 QVMConsole 文档！

QVMConsole 是一款基于 KVM/QEMU 的轻量级虚拟机管理面板，提供直观的 Web 界面来管理虚拟化基础设施。

文档目录​

功能与架构​

本章节围绕 QVMConsole 的核心技术实现与架构设计展开，涵盖虚拟化原理、系统架构、数据流、安全机制等技术细节。适合以下人群阅读：

  • 开发者：了解项目代码结构与技术实现，便于参与开发和贡献
  • 运维人员：深入理解系统工作原理，优化部署和故障排查
  • 技术爱好者：学习 KVM/QEMU 虚拟化技术与 Web 管理面板设计

章节内容​

虚拟机​

本章节深入介绍 QVMConsole 虚拟机管理的全部功能，从创建到运维的完整指南。涵盖创建方式、基础配置、硬件规格、存储配置、网络配置、系统配置、高级设置和硬件直通等内容。适合以下人群阅读：

  • 运维人员：掌握虚拟机创建和管理的最佳实践
  • 开发者：了解虚拟化技术的底层实现和调优方法
  • 系统管理员：学习资源分配和性能优化策略
  • 技术爱好者：探索 KVM/QEMU 虚拟化的高级特性

章节内容​

网络​

本章节全面介绍 QVMConsole 的网络管理功能，涵盖 OVS 基础网络、VPC 交换机、安全组策略、端口转发和 ACL 管理。适合以下人群阅读：

  • 运维人员：掌握网络架构设计和流量管控策略
  • 网络管理员：了解 VPC 隔离和安全组配置
  • 开发者：理解 OVS 网桥和 nftables 规则生成机制

章节内容​

  • 网络概览 - OVS 基础网络状态、网桥管理与端口监控
  • VPC 交换机 - 交换机创建、VLAN 隔离与流量配额管理
  • 安全组策略 - 安全组规则配置与 VPC 访问控制
  • 端口转发 - 公网到虚拟机的流量转发规则管理
  • ACL 管理 - VPC ACL nftables 规则的预览与应用

公网 IP​

本章节介绍 QVMConsole 的公网 IP 管理功能，支持 1:1 NAT、经典网络-路由和经典网络-桥接三种模式。适合以下人群阅读：

  • 运维人员：管理公网 IP 资源和绑定关系
  • 网络管理员：理解 NAT、路由和桥接三种模式的差异
  • 系统管理员：配置公网访问和浮动 IP 迁移

章节内容​

  • 公网IP管理 - 公网IP的新增、绑定、解绑、迁移与规则管理

防火墙​

本章节介绍 QVMConsole 的防火墙管理功能，涵盖宿主机防火墙、KVM 网络防火墙和连接管理。适合以下人群阅读：

  • 安全管理员：配置和管理防火墙规则
  • 运维人员：理解 UFW 和 nftables 双层防火墙架构
  • 系统管理员：监控和清理 TCP 连接

章节内容​

存储池​

本章节介绍 QVMConsole 的存储池管理功能，涵盖物理磁盘管理、分区配置与默认存储位置设置。适合以下人群阅读：

  • 运维人员：管理宿主机存储资源和虚拟机落盘策略
  • 系统管理员：配置存储池和格式化挂载硬盘

章节内容​

  • 存储池管理 - 物理磁盘管理、分区配置与默认存储位置设置

节点管理​

本章节介绍 QVMConsole 的多节点管理功能，涵盖节点接入、连通性探测与虚拟机迁移。适合以下人群阅读：

  • 运维人员：管理多节点集群和虚拟机迁移
  • 系统管理员：配置远程节点和监控节点状态

章节内容​

  • 节点管理 - 多节点接入、连通性探测与虚拟机迁移

我的存储​

本章节介绍 QVMConsole 的用户个人存储管理功能，涵盖 ISO 镜像、文件共享、虚拟磁盘与挂载管理。适合以下人群阅读：

  • 用户：上传和管理个人文件，挂载到虚拟机
  • 运维人员：了解 9p VirtFS 挂载机制

章节内容​

  • 我的存储 - ISO 镜像、文件共享、虚拟磁盘与挂载管理

用户管理​

本章节介绍 QVMConsole 的用户管理功能，涵盖用户生命周期、配额管理与安全认证。适合以下人群阅读：

  • 管理员：管理平台用户和资源配额
  • 安全管理员：配置双因素认证和安全策略

章节内容​

  • 用户管理 - 用户生命周期、配额管理与安全认证

调度事件​

本章节介绍 QVMConsole 的调度事件功能，涵盖全局调度器监控、事件日志与 VM 定时任务。适合以下人群阅读：

  • 运维人员：监控调度器运行状态和事件日志
  • 用户：配置虚拟机定时开关机任务

章节内容​

  • 调度事件 - 全局调度器概览、事件日志与 VM 定时任务

系统设置​

本章节介绍 QVMConsole 的系统设置功能，涵盖基础配置、存储网络、宿主机调优与安全维护。适合以下人群阅读：

  • 管理员：配置平台全局参数和安全策略
  • 运维人员：调优宿主机性能（KSM、zRAM、动态内存）

章节内容​

  • 系统设置 - 基础配置、存储网络、宿主机调优与安全维护

使用文档​

详细的使用说明和配置指南：

虚拟机管理​

  • 虚拟机创建与基础设施
  • 虚拟机迁移
  • 虚拟机快照
  • 虚拟机导入导出

网络管理​

  • VPC 网络
  • OVS 网络
  • 端口转发
  • 公网 IP

存储管理​

  • 存储池管理
  • 模板管理

用户与权限​

  • 用户管理
  • API Key
  • 安全设置（2FA）

系统管理​

  • 系统设置
  • 调度中心
  • 任务中心
  • 维护模式

快速开始​

# 安装脚本
bash install.sh

# 启动开发环境
bash start-dev.sh

技术栈​

组件技术
前端Vue.js 3 + Vite
后端Go (Gin) + libvirt
数据库SQLite
虚拟化KVM/QEMU

相关链接​