mplx/docker-webvirtcloud

Docker版WebVirtCloud

WebVirtCloud是Linux KVM虚拟化的Web管理界面，本镜像将retspen的WebVirtCloud（https://github.com/retspen/webvirtcloud%EF%BC%89%E5%AE%B9%E5%99%A8%E5%8C%96%EF%BC%8C%E4%BE%BF%E4%BA%8E%E5%BF%AB%E9%80%9F%E9%83%A8%E7%BD%B2%E5%92%8C%E4%BD%BF%E7%94%A8%E3%80%82

Docker Hub版本标签

核心功能

• 基于Web的KVM虚拟机全生命周期管理
• 持久化存储数据库与SSH密钥
• 支持自定义公共端口与VNC/SPICE代理配置
• 兼容反向代理部署场景

使用场景

• 企业或个人快速搭建KVM虚拟化管理平台
• 需要Web界面简化KVM虚拟环境操作的场景
• 容器化部署需求下的虚拟化管理解决方案

配置说明

持久化数据挂载

需挂载容器内/srv/webvirtcloud/data（数据库）和/var/www/.ssh（SSH密钥）目录：

• 现有数据库会自动迁移升级
• 无SSH密钥时自动生成4096位RSA密钥
• 警告：请勿挂载本地~/.ssh目录，容器会修改权限

部署示例

拉取镜像

bash
docker pull mplx/docker-webvirtcloud:latest

Docker CLI运行

bash
docker run -d \
    -p 80:80 \
    -v /srv/webvirtcloud/data:/srv/webvirtcloud/data \
    -v /srv/webvirtcloud/ssh:/var/www/.ssh \
    --name webvirtcloud \
    mplx/docker-webvirtcloud:latest

Docker Compose配置

yml
version: '2'
services:
  webvirtcloud:
    image: mplx/docker-webvirtcloud
    ports:
      - "80:80"
    volumes:
      - /srv/webvirtcloud/data:/srv/webvirtcloud/data
      - /srv/webvirtcloud/ssh:/var/www/.ssh

严格主机检查

添加KVM目标系统前需验证主机密钥：

bash
docker exec -i -t <container> /sbin/setuser www-data ssh <user>@<fqdn>

若无需严格检查，可在SSH卷的config文件中添加：

StrictHostKeyChecking=no
UserKnownHostsFile=/dev/null

端口与代理配置

• 公共端口：通过PUBLIC_PORT环境变量修改（如-e PUBLIC_PORT=443）
• VNC代理：通过VNC_HOST和VNC_PORT设置外部WebSocket地址
• 反向代理：支持jwilder/nginx-proxy等代理工具，需配置VIRTUAL_HOST等环境变量

贡献指南

提交首个PR时，请将提交***添加到贡献者文件（含CLA协议）。

许可协议

基于MIT许可证授权。