mber5/virt-manager

Docker virt-manager

libvirt的GTK Broadway Web UI

!https://raw.githubusercontent.com/m-bers/docker-virt-manager/main/docker-virt-manager.gif

镜像概述和主要用途

docker-virt-manager是一个将virt-manager通过GTK Broadway后端转换为Web UI的Docker镜像。virt-manager是一款用于管理虚拟机和其他虚拟化功能的桌面工具，而Broadway是GTK3的HTML5后端，可将GTK应用程序通过Web浏览器展示。本镜像结合两者，提供无需VNC或xrdp的libvirt Web管理界面。

相关项目:

• virt-manager: [***]
• broadway: https://developer.gnome.org/gtk3/stable/gtk-broadway.html

核心功能和特性

• GTK3 Broadway后端: 使用HTML5技术，无需VNC、xrdp等远程桌面工具

• 密码/SSH密码短语支持: 通过ttyd实现，添加SSH连接后点击左下角终端图标即可输入密码

• 暗模式: 支持启用暗色主题

要求

• git
• docker
• docker-compose
• 至少一个libvirt/kvm主机

使用方法和配置说明

docker-compose部署

场景1: docker和libvirt在同一主机上

yaml
services: 
  virt-manager:
    image: docker.xuanyuan.run/mber5/virt-manager:latest
    restart: always
    ports:
      - 8185:80
    environment:
      # 设置DARK_MODE为true启用暗模式
      DARK_MODE: false

      # 设置HOSTS: "['qemu:///session']"以连接用户会话
      HOSTS: "['qemu:///system']"

      # 若主机为Ubuntu（或任何启用libvirt AppArmor策略的主机），
      # 需要使用SSH连接到本地主机或使用qemu:///system并取消以下行注释
      # privileged: true

    volumes:
      - "/var/run/libvirt/libvirt-sock:/var/run/libvirt/libvirt-sock"
      - "/var/lib/libvirt/images:/var/lib/libvirt/images"
    devices:
      - "/dev/kvm:/dev/kvm"

场景2: docker和libvirt在不同主机上

yaml
services: 
  virt-manager:
    image: docker.xuanyuan.run/mber5/virt-manager:latest
    restart: always
    ports:
      - 8185:80
    environment:
      # 设置DARK_MODE为true启用暗模式
      DARK_MODE: false

      # 替换为逗号分隔的qemu连接字符串，例如：
      # HOSTS: "['qemu+ssh://user@host1/system', 'qemu+ssh://user@host2/system']"
      HOSTS: "[]"
    # volumes:
      # 若不使用密码认证，替换为SSH私钥位置，例如：
      # - /home/user/.ssh/id_rsa:/root/.ssh/id_rsa:ro

从Dockerfile构建

bash
git clone https://github.com/m-bers/docker-virt-manager.git
cd docker-virt-manager
docker build -t docker-virt-manager . && docker-compose up -d

部署完成后，在浏览器中访问 http://localhost:8185 即可使用。