@@ -3,129 +3,223 @@ outline: deep
33---
44
55## WebVirtCloud Installation Guide
6+
67[ ![ hits] ( https://hits.spiritlhl.net/webvirtcloud.svg?action=hit&title=hits&title_bg=%23555555&count_bg=%233aebee&edge_flat=false )] ( https://hits.spiritlhl.net )
78
89Repository: https://github.com/oneclickvirt/webvirtcloud
910
10- ## Controller Installation 控制端安装
11+ ## Controller Installation
12+
13+ ### System Requirements
1114
12- ### System Requirements 系统要求
13- ** Minimum Configuration 最低配置要求:**
14- - CPU: 1 core / 1 核
15- - Memory: 1 GB RAM / 内存: 1 GB
16- - Disk: 10 GB free space / 硬盘: 空余 10 GB
15+ ** Minimum Configuration:**
16+ - CPU: 1 core
17+ - Memory: 1 GB RAM
18+ - Disk: 10 GB free space
1719
18- ### Default Login Information 默认登录信息
19- - Username 用户名 : ` admin@webvirt.cloud `
20- - Password 密码 : ` admin `
20+ ### Default Login Information
21+ - Username: ` admin@webvirt.cloud `
22+ - Password: ` admin `
2123
22- ### Access URLs 面板地址
23- - Client Panel 用户面板 : ` https://192-168-0-114.nip.io `
24- - Admin Panel 管理后台 : ` https://192-168-0-114.nip.io/admin `
24+ ### Access URLs
25+ - Client Panel: ` https://192-168-0-114.nip.io `
26+ - Admin Panel: ` https://192-168-0-114.nip.io/admin `
2527
26- > ** Note 注意:** Replace ` 192.168.0.114 ` with your actual public IP address to get the correct access URL.
27- > 请将 ` 192.168.0.114 ` 替换为你的公网 IP,以获取真实可访问地址。
28+ > ** Note:** Replace ` 192.168.0.114 ` with your actual public IP address to get the correct access URL.
2829
29- ### Installation Command 安装命令
30+ ### Installation Command
3031``` bash
3132curl -slk https://raw.githubusercontent.com/oneclickvirt/webvirtcloud/main/scripts/install_webvirt_cloud.sh -o install_webvirt_cloud.sh \
3233&& chmod +x install_webvirt_cloud.sh \
3334&& bash install_webvirt_cloud.sh
3435```
3536
36- ## Hypervisor Installation 计算节点安装
37+ ## Hypervisor Installation
3738
38- > ** Important 重要提示:** The Hypervisor and Controller cannot be installed on the same virtual machine; network conflicts will occur.
39- > Hypervisor 和 Controller 不能在同一个虚拟机上进行安装,否则网络会出现冲突问题。
39+ > ** Important:** The Hypervisor and Controller cannot be installed on the same virtual machine; network conflicts will occur.
4040
41- ### System Requirements 系统要求
42- ** Recommended Configuration 建议配置 :**
43- - CPU: 2 cores / 2 核
44- - Memory: 4 GB RAM / 内存: 4 GB
45- - Disk: 40 GB free space / 硬盘: 空余 40 GB
41+ ### System Requirements
42+ ** Recommended Configuration:**
43+ - CPU: 2 cores
44+ - Memory: 4 GB RAM
45+ - Disk: 40 GB free space
4646
47- > ** Additional Notes 额外说明:**
48- > - Higher specifications are recommended for production use. This minimal setup is only sufficient to run 4 small VMs in a test environment.
49- > 实际使用建议更高配置,测试环境只够开4台最小的虚拟机。
50- > - The server must support KVM nested virtualization with VM-x/AMD-V/Hyper-V enabled.
51- > 服务器需要支持KVM嵌套虚拟化,需要检测项目` VM-x/AMD-V/Hyper-V ` 是启用的。
52- > - The installation uses binary files directly, skipping dependency installation.
53- > 跳过env检测安装,直接使用二进制文件,无需安装依赖。
47+ > ** Additional Notes:**
48+ > - Higher specifications are recommended for production use. This minimal setup is only sufficient to run 4 small VMs in a test environment.
49+ > - The server must support KVM nested virtualization with VM-x/AMD-V/Hyper-V enabled.
50+ > - The installation uses binary files directly, skipping dependency installation.
5451
55- ### Environment Testing 环境检测
52+ ### Environment Testing
5653
5754To test if your server supports KVM nested virtualization:
58- (检测服务器是否支持KVM嵌套虚拟化)
59-
6055``` bash
6156curl -L https://cdn.spiritlhl.net/https://raw.githubusercontent.com/oneclickvirt/ecs/master/goecs.sh -o goecs.sh && chmod +x goecs.sh && ./goecs.sh install
6257```
6358
64- - For performance testing in English: ` ./goecs -l=en ` (select option 8)
65- - 性能测试中文版:` ./goecs ` (选择选项8)
59+ ### Hypervisor Installation Steps
6660
67- ### Hypervisor Installation Steps 计算节点安装步骤
61+ 1 . Download the installation script:
62+ ``` bash
63+ curl -slk https://raw.githubusercontent.com/oneclickvirt/webvirtcloud/main/scripts/install_hypervisor.sh -o install_hypervisor.sh \
64+ && chmod +x install_hypervisor.sh
65+ ```
6866
69- 1 . Download the installation script 下载安装脚本:
67+ 2 . Run the installation (replace with your Controller IP):
68+ ``` bash
69+ bash install_hypervisor.sh x.x.x.x
70+ ```
71+ > Replace ` x.x.x.x ` with your Controller's actual IP address.
72+
73+ ## Troubleshooting
74+
75+ ### NetworkManager Version Issue
76+ You might see this error during installation:
77+
78+ ```
79+ Connection 'eth0' (bed050e9-ff49-4665-8112-24ddf2a1cd3c) successfully deleted.
80+ Warning: nmcli (1.48.10) and NetworkManager (1.42.2) versions don't match. Restarting NetworkManager is advised.
81+ Error: Failed to add 'br-ext' connection: connection.autoconnect-ports: unknown property
82+ ```
83+
84+ ** Solution:** Reboot your server, then run the installation command again.
85+
86+ ### Installation Time Notes
87+ - The entire process takes approximately ** 20-25 minutes** .
88+ - Most time is spent downloading ` finnix-125.iso ` to ` /var/lib/libvirt/isos/finnix-125.iso ` .
89+ - This download cannot be accelerated; use ` tmux ` or ` screen ` to prevent interruption.
90+
91+ ### Adding Compute Node to Controller Panel
92+ After installation, a ** Token** will be generated for adding the compute node to the Controller:
93+
94+ Path: ` Admin Panel > Computers > Add `
95+
96+ ### Troubleshooting Node Connection Issues
97+ From Controller:
98+ ``` bash
99+ telnet < node ip> 8884
100+ ```
101+
102+ From Hypervisor:
103+ ``` bash
104+ journalctl -xeu webvirtcompute
105+ ```
106+
107+ ### Restarting Docker Containers After Controller Reboot
108+ If Docker containers don't auto-restart after a system reboot, run:
109+ ``` bash
110+ docker start $( docker ps -a -q)
111+ ```
112+
113+ ## Credits
114+ https://webvirt.cloud/
115+
116+ ## WebVirtCloud 安装指南
117+
118+ [ ![ hits] ( https://hits.spiritlhl.net/webvirtcloud.svg?action=hit&title=hits&title_bg=%23555555&count_bg=%233aebee&edge_flat=false )] ( https://hits.spiritlhl.net )
119+
120+ 仓库地址: https://github.com/oneclickvirt/webvirtcloud
121+
122+ ## 控制端安装
123+
124+ ### 系统要求
125+
126+ ** 最低配置要求:**
127+ - CPU: 1 核
128+ - 内存: 1 GB RAM
129+ - 硬盘: 空余 10 GB
130+
131+ ### 默认登录信息
132+ - 用户名: ` admin@webvirt.cloud `
133+ - 密码: ` admin `
134+
135+ ### 面板地址
136+ - 用户面板: ` https://192-168-0-114.nip.io `
137+ - 管理后台: ` https://192-168-0-114.nip.io/admin `
138+
139+ > ** 注意:** 请将 ` 192.168.0.114 ` 替换为你的公网 IP,以获取真实可访问地址。
140+
141+ ### 安装命令
142+ ``` bash
143+ curl -slk https://raw.githubusercontent.com/oneclickvirt/webvirtcloud/main/scripts/install_webvirt_cloud.sh -o install_webvirt_cloud.sh \
144+ && chmod +x install_webvirt_cloud.sh \
145+ && bash install_webvirt_cloud.sh
146+ ```
147+
148+ ## 计算节点安装
149+
150+ > ** 重要提示:** Hypervisor 和 Controller 不能在同一虚拟机上安装,否则网络会出现冲突。
151+
152+ ### 系统要求
153+ ** 建议配置:**
154+ - CPU: 2 核
155+ - 内存: 4 GB RAM
156+ - 硬盘: 空余 40 GB
157+
158+ > ** 额外说明:**
159+ > - 实际使用建议更高配置,测试环境只够开 4 台最小的虚拟机。
160+ > - 服务器需要支持 KVM 嵌套虚拟化,需要检测项目 ` VM-x/AMD-V/Hyper-V ` 是启用的。
161+ > - 跳过 env 检测安装,直接使用二进制文件,无需安装依赖。
162+
163+ ### 环境检测
164+
165+ 检测服务器是否支持 KVM 嵌套虚拟化:
166+ ``` bash
167+ 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
168+ ```
169+
170+ ### 计算节点安装步骤
171+
172+ 1 . 下载安装脚本:
70173 ``` bash
71174 curl -slk https://raw.githubusercontent.com/oneclickvirt/webvirtcloud/main/scripts/install_hypervisor.sh -o install_hypervisor.sh \
72175 && chmod +x install_hypervisor.sh
73176 ```
74177
75- 2 . Run the installation (replace with your Controller IP) 执行安装命令(替换 Controller IP):
178+ 2 . 执行安装(替换为你的 Controller IP):
76179 ``` bash
77180 bash install_hypervisor.sh x.x.x.x
78181 ```
79- > Replace ` x.x.x.x ` with your Controller's actual IP address.
80182 > 请将 ` x.x.x.x ` 替换为你的 Controller 控制端的实际 IP 地址。
81183
82- ## Troubleshooting 问题排查
184+ ## 问题排查
83185
84- ### NetworkManager Version Issue NetworkManager 版本问题
85- You might see this error during installation:
86- 安装过程中可能会自动退出并提示 NetworkManager 版本问题:
186+ ### NetworkManager 版本问题
187+ 安装过程中可能会出现以下错误:
87188
88189```
89190Connection 'eth0' (bed050e9-ff49-4665-8112-24ddf2a1cd3c) successfully deleted.
90191Warning: nmcli (1.48.10) and NetworkManager (1.42.2) versions don't match. Restarting NetworkManager is advised.
91192Error: Failed to add 'br-ext' connection: connection.autoconnect-ports: unknown property
92193```
93194
94- ** Solution 解决方法:**
95- Reboot your server, then run the installation command again.
96- 重启服务器后重新执行安装命令。
195+ ** 解决方法:** 重启服务器后重新执行安装命令。
97196
98- ### Installation Time Notes 安装耗时提示
99- - The entire process takes approximately ** 20-25 minutes** .
100- 整个过程大约耗时 ** 20~ 25 分钟** 。
101- - Most time is spent downloading ` finnix-125.iso ` to ` /var/lib/libvirt/isos/finnix-125.iso ` .
102- 大部分时间用于下载 ` finnix-125.iso ` 至 ` /var/lib/libvirt/isos/finnix-125.iso ` 。
103- - This download cannot be accelerated; use ` tmux ` or ` screen ` to prevent interruption.
104- 该部分无法加速,** 建议使用 tmux 或 screen** 等工具防止中断。
197+ ### 安装耗时提示
198+ - 整个过程大约耗时 ** 20~ 25 分钟** 。
199+ - 大部分时间用于下载 ` finnix-125.iso ` 至 ` /var/lib/libvirt/isos/finnix-125.iso ` 。
200+ - 该部分无法加速,** 建议使用 tmux 或 screen** 等工具防止中断。
105201
106- ### Adding Compute Node to Controller Panel 添加计算节点到控制面板
107- After installation, a ** Token** will be generated for adding the compute node to the Controller:
202+ ### 添加计算节点到控制面板
108203安装完成后会生成一个 ** Token** ,用于在控制端(Admin 面板)中添加计算节点:
109204
110- Path 路径: ` Admin Panel > Computers > Add `
205+ 路径: ` Admin Panel > Computers > Add `
111206
112- ### Troubleshooting Node Connection Issues 纳管节点错误排查
113- From Controller 在控制端执行:
207+ ### 纳管节点错误排查
208+ 在控制端执行:
114209``` bash
115210telnet < node ip> 8884
116211```
117212
118- From Hypervisor 在Hypervisor端执行:
213+ 在计算节点执行:
119214``` bash
120215journalctl -xeu webvirtcompute
121216```
122217
123- ### Restarting Docker Containers After Controller Reboot Controller重启后Docker容器重启
124- If Docker containers don't auto-restart after a system reboot, run:
125- 执行以下命令重启所有容器:
218+ ### Controller 重启后 Docker 容器重启
219+ 如果 Docker 容器在系统重启后没有自动重启,执行以下命令:
126220``` bash
127221docker start $( docker ps -a -q)
128222```
129223
130- ## Credits 鸣谢
224+ ## 鸣谢
131225https://webvirt.cloud/
0 commit comments