fix:添加部分OneClickVirt虚拟化管理平台的安装使用说明

This commit is contained in:
spiritlhl
2025-09-25 15:45:12 +00:00
parent 4048c9c39b
commit 772c3d85cf
4 changed files with 256 additions and 5 deletions

View File

@@ -2,5 +2,108 @@
outline: deep
---
# OneClickVirt
占位待施工
区分面板端和受控端,受控端需要提前安装好对应虚拟化的环境,可使用本说明别的主体安装进行环境安装
## 受控端
对应本说明别的主体安装进行环境安装,这里不过多赘述
## 面板端
宿主机需要安装好```nginx```或```caddy```和```mysql```需要至少1G空闲内存和1G空闲硬盘。
安装完成后,默认启动的地址
前端:```http://localhost:8080```
后端 API```http://localhost:8888```
API 文档:```http://localhost:8888/swagger/index.html```
### 后端安装
#### Linux
下载并执行
国际
```shell
curl -L https://raw.githubusercontent.com/oneclickvirt/oneclickvirt/refs/heads/main/install.sh -o install.sh && chmod +x install.sh
```
国内
```shell
curl -L https://cdn.spiritlhl.net/https://raw.githubusercontent.com/oneclickvirt/oneclickvirt/refs/heads/main/install.sh -o install.sh && chmod +x install.sh
```
有交互地安装
```
./install.sh
```
无交互地安装
```
noninteractive=true ./install.sh
```
安装目录: ```/opt/oneclickvirt```
使用方法:
启动服务: ```systemctl start oneclickvirt```
停止服务: ```systemctl stop oneclickvirt```
开机自启: ```systemctl enable oneclickvirt```
查看状态: ```systemctl status oneclickvirt```
查看日志: ```journalctl -u oneclickvirt -f```
#### Windows
查看
https://github.com/oneclickvirt/oneclickvirt/releases/latest
下载最新的对应架构的压缩文件,解压后挂起执行。
执行的二进制文件的同级目录下,下载
https://cdn.spiritlhl.net/https://raw.githubusercontent.com/oneclickvirt/oneclickvirt/refs/heads/main/server/config.yaml
文件,这是后续需要使用的配置文件。
### 前端安装
#### Linux
前面安装脚本会将静态文件解压到
```shell
cd /opt/oneclickvirt/web/
```
这个路径下
使用```nginx```或```caddy```以这个路径建立静态网站即可,是否需要域名绑定自行选择
#### Windows
下载```web-dist.zip```文件后,解压并使用对应的程序建立静态网站即可.
## MYSQL
安装mysql后创建一个空的数据库```oneclickvirt```,最好仅本地```127.0.0.1```可访问,对应用户名和密码保存好。
打开前端对应的页面后,将自动跳转到初始化界面,填写数据库信息和相关用户信息,点击初始化系统。
完成初始化后会自动跳转到首页,可以自行探索并使用了。
## 配置文件(可选)

View File

@@ -4,6 +4,28 @@ outline: deep
# 前言
欢迎给项目一个```Star```进行免费的支持-->[https://github.com/oneclickvirt/oneclickvirt](https://github.com/oneclickvirt/oneclickvirt)
## 环境需求
支持的架构amd64或arm64
支持的系统Linux、Windows
只要有公网就行部署的机器不必有独立的公网IP地址这只是一个虚拟化的控制面板。
本控制面板无环境依赖需求,仅一个守护进程启动的后端和一个对应的前端静态文件的文件夹。
欢迎给项目一个```Star```进行免费的支持-->[https://github.com/oneclickvirt/oneclickvirt](https://github.com/oneclickvirt/oneclickvirt)
前端静态文件通过nginx或者caddy部署即可。
## 平台特点
- 所有代码开源,不可进行商用
- 对接支持Provider如 ProxmoxVE、Incus、Docker、LXD 进行虚拟化,支持开设虚拟机或容器
- 支持自动的NAT公网端口映射支持灵活设置Provider的网络类型开设带独立IPV6地址的虚拟机或容器
- 支持流量监控,敏感操作强行同步流量,月初统一重置流量使用
- 支持邀请码注册非公开注册,支持用户等级管理设置资源限制