webvirtcloud project (Thanks to Anatoliy Guskov)
webvirtcloud是一个用来管理KVM（实际上是通过libvirt）的基于浏览器的管理界面，但是安装配置步骤较多，不太方便，这里用Docker来简化安装配置。
- 两个版本：
- allinone模式，所有webvirtcloud, nginx, sqlite都运行于一个容器中。以下提到此模式的镜像时，称为allinone镜像。
- standalone模式， 每个组件单独运行在自己的容器中，包括webvirtcloud, nginx, postgresql。以下提到吃模式的镜像时，仅指用于此模式的webvirtcloud镜像，不包括nginx和postgres镜像。
- 配置中经常提到两种服务器，需要区分一下：
- webvirtcloud服务器，用于安装运行webvirtcloud管理平台的服务器
- virsh服务器，运行virsh的服务器，被webvirtcloud服务器所管理的服务器
-
在webvirtcloud服务器上安装配置docker(略)
-
运行webvirtcloud-allinone容器
$ docker run -d --name webvirtcloud -p 80:80 -p 6080:6080 kenlee/webvirtcloud-docker:allinone
或者使用docker-compose，下载allinon目录下的docker-compose.yml文件，然后在同一目录下运行
$ docker-compose up -d
-
使用浏览器访问 http://yourip/
-
添加被管理的virsh服务器，不同的virsh服务器连接方式配置不同，参见下面的virsh服务器配置步骤
- 在webvirtcloud服务器上安装配置docker(略)
2a. 下载docker-compose.yml文件，并在同一目录下运行
$ docker-compose up -d
这个命令会拉起webvirtcloud, nginx和postgreSQL三个容器，nginx采用基于官方镜像的kenlee/webvirtcloud-docker:wvcweb及内置配置文件，postgreSQL则采用官方镜像。
在启动后还需要执行一次初始化操作：
$ docker exec -i wvc /init.sh
2b. 如果不想用docker-compose，则需要运行以下命令，其中第二行是进行初始化，仅需运行一次
$ docker run -d --name postgres \
> -e POSTGRES_PASSWORD your_postgres_password \
> postgres
$ docker run -it --rm --link postgres:db \
> -e DB_PASSWORD=your_wvc_db_password \
> kenlee/webvirtcloud-docker:latest /init.sh
$ docker run -d --name wvc -p 6080:6080 --link postgres:db kenlee/webvirtcloud-docker:latest
$ docker run -d --name web -p 80:80 --link wvc \
> --volumes-from wvc:ro \
> kenlee/webvirtcloud-docker:web
对于最后nginx容器，如果需要指定不同的URL，则需要修改webvirtcloud.conf配置文件，如果还需要调整其他配置，则可以传入自己的nginx.conf文件，这时可以直接使用官方的nginx镜像而不是kenlee/webvirtcloud-docker:web镜像，命令如下：
$ docker run -d --name web -p 80:80 --link wvc \
> --volumes-from wvc:ro \
> -v ${PWD}/nginx.conf:/etc/nginx/nginx.conf \
> -v ${PWD}/webvirtcloud.conf:/etc/nginx/conf.d/webvirtcloud.conf \
> nginx
其中配置文件webvirtcloud.conf中，注意保持LINK的名称“wvc”，如果你LINK的容器名称不是"wvc"，则需要做相应修改
server {
listen 80;
#server_name webvirtcloud.example.com;
#access_log /var/log/nginx/webvirtcloud-access_log;
location /static/ {
root /srv/webvirtcloud;
expires max;
}
location / {
proxy_pass http://wvc:8000;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-for $proxy_add_x_forwarded_for;
proxy_set_header Host $host:$server_port;
proxy_set_header X-Forwarded-Proto $remote_addr;
proxy_connect_timeout 600;
proxy_read_timeout 600;
proxy_send_timeout 600;
client_max_body_size 1024M;
}
}
简单处理，运行
$ wget -O - https://clck.ru/9V9fH | sudo sh
这个自动化脚本里面大致做了三件事
- 安装软件，包括KVM, libvirt, Linux Bridge, Guestfs, supervisor，以及必要的库
- 配置软件，安装后修改了libvirt的配置来支持多种连接方式，修改了supervisor和配置
- 运行软件，启动libvirt服务和supervisor服务
共有4种连接方式，前三种是网络连接，需要webvirtcloud容器和被管理的virsh服务器网络。最后一种只能运行于webvirtcloud容器和被管理virsh服务器在同一服务器上的场景。
- TCP连接
virsh服务器需要配置virsh的网络访问，如果你之前按运行了virsh服务器的脚本，此配置已经生效。用户授权需要使用
saslpasswd2 -a libvirt *username*命令。
添加用户
$ sudo saslpasswd2 -a libvirt ken
Password: xxxxxx
Again (for verification): xxxxxx
列出用户
$ sudo saslpasswd2 -f /etc/libvirt/passwd.db
删除用户
$ sudo saslpasswd2 -a libvirt -d ken
验证连接
$ virsh -c qemu+tcp://IP_address/system nodeinfo
- SSH连接
SSH连接方式使用virsh服务器上的用户和证书来访问virsh服务，那么首先是用ssh-keygen生成证书，然后将私有证书放入webvirtcloud服务器的www-data用户的.ssh目录中，将公有证书导入virsh服务器的用于连接的用户的.ssh目录的authorized_keys文件中。
在allinone和standalone镜像中，都内置了公钥和私钥文件，以方便快速使用和测试，从安全角度考虑，你应该用自己的公钥私钥文件来替换。
- 在allinone和standalone镜像中，缺省用户是www-data，私钥文件为/var/www/.ssh/id_rsa，公钥文件为/var/www/.ssh/id_rsa.pub。webvirtcloud服务器无需配置，可以通过以下命令导出公钥：
$ docker exec -it webvirtcloud cat /var/www/.ssh/webvirtcloud_rsa.pub
ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQC7zEEPi7AeG4Luk1nP7faf8KzWmyyMXQmNf7WMZOwJP08Zp9p6QJ727w6OFgTtMbL3miljXjjV7U9TC8mQBIJ9cRZFwFZZfsifFROSYE+OUjsw6IuzUaq3krPOqM71/iKm3jHIqd9JAu5M0MnwTGjd9aVs3aXPJ68PuVmaEXgsBql+4cSu0890GBY9BoOxE6i1Pdjxw6T6ZsxRnyAzx2Q9bBCXtVngjgQhS77vNhFENKlnqL170O17lAW+xHzr+ONULtFVqOveaqdVcZNGlb6KbN3otsUq00dE6ow2jZM9q4OhA7FSzoiQRVgPlr4JNj+soG3AR9fGHh7TwrkEdRad webvirtcloud
或者用docker cp命令copy处理进行处理
$ docker cp /var/www/.ssh/id_rsa.pub ./webvirtcloud_rsa.pub
将显示的内容拷贝并添加到被管理virsh服务器的用于SSH连接（并属于libvirt组）的用户的~/.ssh/authorized_keys文件中就可以了。
-
TLS连接 (TBD)
-
Unix Socket连接 用于连接运行webvirtcloud服务器上的virsh服务，需要在运行webvirtcloud容器时指定/var/run/libvirt/libvirt-sock文件。由于这个文件是归属于root:libvirt的，而容器内没有libvirt组，并且运行用户是www-data而不是root，在容器内需要将www-data用户加入到libvirt组中。这个操作已经由entrypoint.sh脚本自动处理了。
- 对allinone镜像来说，启动容器的命令为：
$ docker run -d --name webvirtcloud -p 80:80 -p 6080:6080 \
> -v /var/run/libvirt/libvirt-sock:/var/run/libvirt/libvirt-sock \
> kenlee/webvirtcloud-docker:allinone
- 对standalone镜像来说，启动容器的命令为：
$ docker run -d --name wvc -p 6080:6080 --link postgres:db \
> -v /var/run/libvirt/libvirt-sock:/var/run/libvirt/libvirt-sock \
> kenlee/webvirtcloud-docker:latest
如果你用docker-compose的方式启动，则需要相应修改docker-compose.yml文件。
如果对以上步骤中还有疑问，请访问wiki
![[Hurd]Donkey avatar](https://avatars.githubusercontent.com/u/12184093?s=40&u=e743cc85853b638d20e945e2fd16cfe00f8d7200&v=4 "[Hurd]Donkey")
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent