From fa2d5bc60a63c99513ad2f33d66abbbbdfcbb378 Mon Sep 17 00:00:00 2001 From: spiritlhl <103393591+spiritLHLS@users.noreply.github.com> Date: Sun, 20 Apr 2025 19:22:01 +0800 Subject: [PATCH] =?UTF-8?q?fix:=20=E6=9B=B4=E6=96=B0=E8=AF=B4=E6=98=8E?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/incomplete/webvirtcloud.md | 165 ++++++++++++++++---------------- 1 file changed, 82 insertions(+), 83 deletions(-) diff --git a/docs/incomplete/webvirtcloud.md b/docs/incomplete/webvirtcloud.md index 89536dc6b4..04b02bb5bb 100644 --- a/docs/incomplete/webvirtcloud.md +++ b/docs/incomplete/webvirtcloud.md @@ -2,131 +2,130 @@ outline: deep --- -## Repo - -https://github.com/oneclickvirt/webvirtcloud - +## WebVirtCloud Installation Guide [![hits](https://hits.spiritlhl.net/webvirtcloud.svg?action=hit&title=hits&title_bg=%23555555&count_bg=%233aebee&edge_flat=false)](https://hits.spiritlhl.net) ---- +Repository: https://github.com/oneclickvirt/webvirtcloud -### Controller 控制端安装 +## Controller Installation 控制端安装 -> **最低配置要求**： -> - CPU: 1 核 -> - 内存: 1 GB -> - 硬盘: 空余 10 GB +### System Requirements 系统要求 +**Minimum Configuration 最低配置要求:** +- CPU: 1 core / 1 核 +- Memory: 1 GB RAM / 内存: 1 GB +- Disk: 10 GB free space / 硬盘: 空余 10 GB -#### 默认登录信息 Login Info +### Default Login Information 默认登录信息 +- Username 用户名: `admin@webvirt.cloud` +- Password 密码: `admin` -- 用户名 / Username: `admin@webvirt.cloud` -- 密码 / Password: `admin` +### Access URLs 面板地址 +- Client Panel 用户面板: `https://192-168-0-114.nip.io` +- Admin Panel 管理后台: `https://192-168-0-114.nip.io/admin` -#### 面板地址 Panel Access - -- 用户面板 / Client Panel: `https://192-168-0-114.nip.io` -- 管理后台 / Admin Panel: `https://192-168-0-114.nip.io/admin` - -> 请将 `192.168.0.114` 替换为你的公网 IP，以获取真实可访问地址。 -> Replace `192.168.0.114` with your actual **public IP address**. - -#### 安装命令 Install Command +> **Note 注意:** Replace `192.168.0.114` with your actual public IP address to get the correct access URL. +> 请将 `192.168.0.114` 替换为你的公网 IP，以获取真实可访问地址。 +### Installation Command 安装命令 ```bash 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 计算节点安装 +## Hypervisor Installation 计算节点安装 -Hypervisor 和 Controller 不能在同一个虚拟机上进行安装，网络会出现冲突问题。 +> **Important 重要提示:** The Hypervisor and Controller cannot be installed on the same virtual machine; network conflicts will occur. +> Hypervisor 和 Controller 不能在同一个虚拟机上进行安装，否则网络会出现冲突问题。 -The Hypervisor and Controller cannot be installed on the same virtual machine; the network will have conflict issues. +### System Requirements 系统要求 +**Recommended Configuration 建议配置:** +- CPU: 2 cores / 2 核 +- Memory: 4 GB RAM / 内存: 4 GB +- Disk: 40 GB free space / 硬盘: 空余 40 GB -#### 环境检测 +> **Additional Notes 额外说明:** +> - Higher specifications are recommended for production use. This minimal setup is only sufficient to run 4 small VMs in a test environment. +> 实际使用建议更高配置，测试环境只够开4台最小的虚拟机。 +> - The server must support KVM nested virtualization with VM-x/AMD-V/Hyper-V enabled. +> 服务器需要支持KVM嵌套虚拟化，需要检测项目`VM-x/AMD-V/Hyper-V`是启用的。 +> - The installation uses binary files directly, skipping dependency installation. +> 跳过env检测安装，直接使用二进制文件，无需安装依赖。 -> **建议配置**： -> - CPU: 2 核 -> - 内存: 4 GB -> - 硬盘: 空余 40 GB -> - 实际使用建议更高配置，测试环境只够开4台最小的虚拟机 -> - 服务器需要支持KVM嵌套虚拟化，如何测试建议使用 https://github.com/oneclickvirt/ecs 进行测试，需要检测项目```VM-x/AMD-V/Hyper-V```是启用的 -> - 跳过env检测安装，直接使用二进制文件，无需安装依赖 +### Environment Testing 环境检测 -> **Recommended Configuration**: -> - CPU: 2 cores -> - RAM: 4 GB -> - Disk: 40 GB free space -> - Higher specs are recommended for actual usage; this minimal setup is only sufficient to run 4 smallest VM in a test environment -> - The server must support KVM nested virtualization(Need ```VM-x/AMD-V/Hyper-V``` is enabled). To test compatibility, it's recommended to use: https://github.com/oneclickvirt/ecs -> - Skip the env detection installation, use the binary directly, no need to install dependencies +To test if your server supports KVM nested virtualization: +(检测服务器是否支持KVM嵌套虚拟化) -```shell +```bash 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 ``` -选择选项8进行性能测试: ```./goecs``` +- For performance testing in English: `./goecs -l=en` (select option 8) +- 性能测试中文版：`./goecs` (选择选项8) -Select option 8 for performance testing: ```./goecs -l=en``` +### Hypervisor Installation Steps 计算节点安装步骤 -#### 下载并准备安装脚本 +1. Download the installation script 下载安装脚本: + ```bash + curl -slk https://raw.githubusercontent.com/oneclickvirt/webvirtcloud/main/scripts/install_hypervisor.sh -o install_hypervisor.sh \ + && chmod +x install_hypervisor.sh + ``` + +2. Run the installation (replace with your Controller IP) 执行安装命令（替换 Controller IP）: + ```bash + bash install_hypervisor.sh x.x.x.x + ``` + > Replace `x.x.x.x` with your Controller's actual IP address. + > 请将 `x.x.x.x` 替换为你的 Controller 控制端的实际 IP 地址。 + +## Troubleshooting 问题排查 + +### NetworkManager Version Issue NetworkManager 版本问题 +You might see this error during installation: +安装过程中可能会自动退出并提示 NetworkManager 版本问题: -```bash -curl -slk https://raw.githubusercontent.com/oneclickvirt/webvirtcloud/main/scripts/install_hypervisor.sh -o install_hypervisor.sh \ -&& chmod +x install_hypervisor.sh ``` - -#### 执行安装命令（替换 Controller IP） - -请将 `x.x.x.x` 替换为你的 **Controller 控制端的实际 IP 地址**： - -```bash -bash install_hypervisor.sh x.x.x.x -``` - -### 安装中可能出现的问题与提示 - -安装过程中可能会自动退出并提示 NetworkManager 版本问题，如下所示： - -```text 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 ``` -> **解决方法**： -> 重启服务器后重新执行安装命令 -> Reboot your server, then **run the install command again**. +**Solution 解决方法:** +Reboot your server, then run the installation command again. +重启服务器后重新执行安装命令。 -### 安装耗时提示 - -- 整个过程大约耗时 **20~25 分钟** -- 大部分时间用于下载 `finnix-125.iso`： - `/var/lib/libvirt/isos/finnix-125.iso` -- 该部分无法加速，**建议使用 tmux 或 screen** 等工具防止中断 - -### 添加计算节点到控制面板 +### Installation Time Notes 安装耗时提示 +- The entire process takes approximately **20-25 minutes**. + 整个过程大约耗时 **20~25 分钟**。 +- Most time is spent downloading `finnix-125.iso` to `/var/lib/libvirt/isos/finnix-125.iso`. + 大部分时间用于下载 `finnix-125.iso` 至 `/var/lib/libvirt/isos/finnix-125.iso`。 +- This download cannot be accelerated; use `tmux` or `screen` to prevent interruption. + 该部分无法加速，**建议使用 tmux 或 screen** 等工具防止中断。 +### Adding Compute Node to Controller Panel 添加计算节点到控制面板 +After installation, a **Token** will be generated for adding the compute node to the Controller: 安装完成后会生成一个 **Token**，用于在控制端（Admin 面板）中添加计算节点： -路径： -`Admin Panel > Computers > Add` +Path 路径: `Admin Panel > Computers > Add` -### 纳管节点错误排查 - -Controller端： - -``` +### Troubleshooting Node Connection Issues 纳管节点错误排查 +From Controller 在控制端执行: +```bash telnet 8884 ``` -Hypervisor端： - -``` +From Hypervisor 在Hypervisor端执行: +```bash journalctl -xeu webvirtcompute ``` -## Thanks +### Restarting Docker Containers After Controller Reboot Controller重启后Docker容器重启 +If Docker containers don't auto-restart after a system reboot, run: +执行以下命令重启所有容器: +```bash +docker start $(docker ps -a -q) +``` +## Credits 鸣谢 https://webvirt.cloud/