Skip to content

Commit e79b5cf

Browse files
authored
fix: 中英文拆分说明
1 parent fa2d5bc commit e79b5cf

File tree

1 file changed

+157
-63
lines changed

1 file changed

+157
-63
lines changed

docs/incomplete/webvirtcloud.md

Lines changed: 157 additions & 63 deletions
Original file line numberDiff line numberDiff line change
@@ -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

89
Repository: 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
3132
curl -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

5754
To test if your server supports KVM nested virtualization:
58-
(检测服务器是否支持KVM嵌套虚拟化)
59-
6055
```bash
6156
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
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
```
89190
Connection 'eth0' (bed050e9-ff49-4665-8112-24ddf2a1cd3c) successfully deleted.
90191
Warning: nmcli (1.48.10) and NetworkManager (1.42.2) versions don't match. Restarting NetworkManager is advised.
91192
Error: 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
115210
telnet <node ip> 8884
116211
```
117212

118-
From Hypervisor 在Hypervisor端执行:
213+
在计算节点执行:
119214
```bash
120215
journalctl -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
127221
docker start $(docker ps -a -q)
128222
```
129223

130-
## Credits 鸣谢
224+
## 鸣谢
131225
https://webvirt.cloud/

0 commit comments

Comments
 (0)