6.3 KiB
outline
| outline |
|---|
| deep |
WebVirtCloud 安装指南
仓库地址: https://github.com/oneclickvirt/webvirtcloud
控制端安装
系统要求
最低配置要求:
- CPU: 1 核
- 内存: 1 GB RAM
- 硬盘: 空余 10 GB
- 系统：Debian11+，Ubuntu20.04+
默认登录信息
- 用户名:
admin@webvirt.cloud - 密码:
admin
面板地址
- 用户面板:
https://192-168-0-114.nip.io - 管理后台:
https://192-168-0-114.nip.io/admin
注意: 请将
192.168.0.114替换为你的公网 IP，以获取真实可访问地址。
安装命令
curl -slk https://raw.githubusercontent.com/oneclickvirt/webvirtcloud/main/scripts/install_webvirt_cloud.sh -o install_webvirt_cloud.sh \
&& chmod +x install_webvirt_cloud.sh \
&& bash install_webvirt_cloud.sh
计算节点安装
重要提示: Hypervisor 和 Controller 不能在同一虚拟机上安装，否则网络会出现冲突。
系统要求
建议配置:
- CPU: 2 核
- 内存: 4 GB RAM
- 硬盘: 空余 40 GB
- 系统：AlmaLinux8+，RockyLinux8+
额外说明:
- 实际使用建议更高配置，测试环境只够开 4 台最小的虚拟机。
- 服务器推荐支持 KVM 嵌套虚拟化的，若
VM-x/AMD-V/Hyper-V未启用也可以，会自动切换为QEMU使用TCG仿真开设虚拟机，只不过性能会有所损耗。- 跳过 env 检测安装，直接使用二进制文件，无需安装依赖。
环境检测
检测服务器是否支持 KVM 嵌套虚拟化：
curl -L https://cdn.spiritlhl.net/https://raw.githubusercontent.com/oneclickvirt/ecs/master/goecs.sh -o goecs.sh && chmod +x goecs.sh && ./goecs.sh install && goecs
选择硬件单项测试
计算节点安装步骤
下载安装脚本：
curl -slk https://raw.githubusercontent.com/oneclickvirt/webvirtcloud/main/scripts/install_hypervisor.sh -o install_hypervisor.sh \
&& chmod +x install_hypervisor.sh
执行安装（替换为你的 Controller IP）：
bash install_hypervisor.sh x.x.x.x
请将
x.x.x.x替换为你的 Controller 控制端的实际 IP 地址。
面板纳管节点
执行完毕后会有提示需要在Controller面板端需要填写的内容。
面板端要填入Hostname的是当前计算节点的IPV4地址，还有要填入Token识别节点。
NetworkManager 版本问题
安装过程中可能会出现以下错误：
Connection 'eth0' (bed050e9-ff49-4665-8112-24ddf2a1cd3c) successfully deleted.
Warning: nmcli (1.48.10) and NetworkManager (1.42.2) versions don't match. Restarting NetworkManager is advised.
Error: Failed to add 'br-ext' connection: connection.autoconnect-ports: unknown property
解决方法: 重启服务器后重新执行安装命令。
安装耗时提示
- 整个过程大约耗时 10~25 分钟。
- 大部分时间用于下载
finnix-125.iso至/var/lib/libvirt/isos/finnix-125.iso，有时候下载快有时候下载慢。 - 该部分无法加速，建议使用 tmux 或 screen 等工具防止中断。
添加计算节点到控制面板
安装完成后会生成一个 Token，用于在控制端（Admin 面板）中添加计算节点：
路径: Admin Panel > Computers > Add
给开设的虚拟机添加公网IP端口映射
假设此时你的虚拟机在用户端控制面板显示为
且宿主机的命令执行ip a | head -n 15结果为
1: lo: <LOOPBACK,UP,LOWER_UP> mtu 65536 qdisc noqueue state UNKNOWN group default qlen 1000
link/loopback 00:00:00:00:00:00 brd 00:00:00:00:00:00
inet 127.0.0.1/8 scope host lo
valid_lft forever preferred_lft forever
inet6 ::1/128 scope host
valid_lft forever preferred_lft forever
2: ens3: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc fq_codel state UP group default qlen 1000
link/ether 52:54:00:f1:d6:8b brd ff:ff:ff:ff:ff:ff
altname enp0s3
inet 你的公网IPV4地址/对应的子网掩码 scope global noprefixroute ens3
valid_lft forever preferred_lft forever
inet6 2a0b:4140:4c60::2/48 scope global noprefixroute
valid_lft forever preferred_lft forever
inet6 fe80::5054:ff:fef1:d68b/64 scope link noprefixroute
valid_lft forever preferred_lft forever
可见公网IPV4地址绑定的接口是ens3，所以后面的命令这里用ens3
那么映射当前虚拟机的22端口到公网IPV4的3322端口的命令为
# 添加 DNAT 规则：将公网3322流量转发到宿主机本地的192.168.33.130:22
iptables -t nat -A PREROUTING -i ens3 -p tcp --dport 3322 -j DNAT --to-destination 192.168.33.130:22
# 添加 POSTROUTING：本机 NAT 伪装，以便连接正常返回
iptables -t nat -A POSTROUTING -p tcp -d 192.168.33.130 --dport 22 -j MASQUERADE
# 需要允许 INPUT 的3322端口通过（firewalld 默认是开启了的）
iptables -I INPUT -p tcp --dport 3322 -j ACCEPT
这样内网的虚拟机就被映射出来，可以直接远程登录使用了。
问题排查
添加计算节点错误排查
在Controller控制端执行：
telnet <node ip> 8884
在计算节点执行：
systemctl status webvirtcompute
systemctl status libvirtd
systemctl status prometheus
systemctl status prometheus-libvirt-exporter
如果以上都查不出问题，那么就需要到Controller控制端执行：
docker exec -it webvirtcloud-backend /bin/sh
vi webvirtcloud/settings/production.py
将 DEBUG=False 改成 DEBUG=True
然后保存文件后，容器内执行
UV_PROJECT_ENVIRONMENT=/usr/local uv sync --dev
然后exit退出容器后，执行
docker restart webvirtcloud-backend
sleep 3
docker logs webvirtcloud-backend -f
然后前端去触发错误的位置，这块日志实时加载就会看到对应的报错了
Controller 重启后 Docker 容器不自重启
如果 Docker 容器在系统重启后没有自动重启，执行以下命令：
docker start $(docker ps -a -q)
缺点
系统镜像是写死的，没法使用自己制作的自定义镜像，也没办法导出使用，同时原始的镜像没有设置远程可用密码登录和ROOT登录可用