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

spiritLHLS · spiritLHLS · commit 772c3d85cfee · 2025-09-25T15:45:12.000Z
diff --git a/docs/en/guide/oneclickvirt/oneclickvirt_install.md b/docs/en/guide/oneclickvirt/oneclickvirt_install.md
@@ -2,4 +2,108 @@
 outline: deep
 ---
 
-Occupancy pending construction
+# OneClickVirt
+
+Distinguish between the panel side and the controlled side. The controlled side needs to have the corresponding virtualization environment installed in advance. You can use other parts of this documentation for environment installation.
+
+## Controlled Side
+
+Refer to other parts of this documentation for environment installation, no further details are provided here.
+
+## Panel Side
+
+The host machine needs to have ```nginx``` or ```caddy``` and ```mysql``` installed, with at least 1G free memory and 1G free disk space.
+
+After installation, the default startup addresses are:
+
+Frontend: ```http://localhost:8080```
+
+Backend API: ```http://localhost:8888```
+
+API Documentation: ```http://localhost:8888/swagger/index.html```
+
+### Backend Installation
+
+#### Linux
+
+Download and execute:
+
+International:
+
+```shell
+curl -L https://raw.githubusercontent.com/oneclickvirt/oneclickvirt/refs/heads/main/install.sh -o install.sh && chmod +x install.sh
+````
+
+Domestic:
+
+```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
+```
+
+Interactive installation:
+
+```
+./install.sh
+```
+
+Non-interactive installation:
+
+```
+noninteractive=true ./install.sh
+```
+
+Installation directory: `/opt/oneclickvirt`
+
+Usage:
+
+Start service: `systemctl start oneclickvirt`
+
+Stop service: `systemctl stop oneclickvirt`
+
+Enable autostart: `systemctl enable oneclickvirt`
+
+Check status: `systemctl status oneclickvirt`
+
+View logs: `journalctl -u oneclickvirt -f`
+
+#### Windows
+
+See:
+
+[https://github.com/oneclickvirt/oneclickvirt/releases/latest](https://github.com/oneclickvirt/oneclickvirt/releases/latest)
+
+Download the latest compressed file for the corresponding architecture, extract it, and run it.
+
+In the same directory as the executed binary file, download:
+
+[https://cdn.spiritlhl.net/https://raw.githubusercontent.com/oneclickvirt/oneclickvirt/refs/heads/main/server/config.yaml](https://cdn.spiritlhl.net/https://raw.githubusercontent.com/oneclickvirt/oneclickvirt/refs/heads/main/server/config.yaml)
+
+This file is the configuration file needed later.
+
+### Frontend Installation
+
+#### Linux
+
+The previous installation script will extract the static files to:
+
+```shell
+cd /opt/oneclickvirt/web/
+```
+
+In this path.
+
+Use `nginx` or `caddy` to build a static website with this path. Whether you need domain binding is up to you.
+
+#### Windows
+
+After downloading the `web-dist.zip` file, extract it and use the corresponding program to build a static website.
+
+## MYSQL
+
+After installing MySQL, create an empty database named ```oneclickvirt```. It is recommended to allow access only from local ```127.0.0.1```. Keep the corresponding username and password safe.
+
+After opening the corresponding frontend page, it will automatically redirect to the initialization page. Fill in the database information and related user information, then click to initialize the system.
+
+Once initialization is complete, it will automatically redirect to the homepage, where you can explore and use the system.
+
+## Configuration File (Optional)
diff --git a/docs/en/guide/oneclickvirt/oneclickvirt_precheck.md b/docs/en/guide/oneclickvirt/oneclickvirt_precheck.md
@@ -4,6 +4,28 @@ outline: deep
 
 # Preface
 
-This control panel has no environmental dependencies required, just a daemon-starting backend and a corresponding folder of static files for the frontend.
+Welcome to give the project a ```Star``` for free support --> [https://github.com/oneclickvirt/oneclickvirt](https://github.com/oneclickvirt/oneclickvirt)
 
-Feel free to give the project a ```Star``` for free support!-->[https://github.com/oneclickvirt/oneclickvirt](https://github.com/oneclickvirt/oneclickvirt)
+## Environment Requirements
+
+Supported architectures: amd64 or arm64
+
+Supported systems: Linux, Windows
+
+As long as there is public network access, the deployed machine does not need to have a dedicated public IP address. This is only a virtualization control panel.
+
+This control panel has no environmental dependency requirements, only a backend started as a daemon process and a corresponding frontend static file folder.
+
+Frontend static files can be deployed through nginx or caddy.
+
+## Platform Features
+
+- All code is open source, commercial use is not allowed
+
+- Supports connecting to Providers such as ProxmoxVE, Incus, Docker, LXD for virtualization, supporting the creation of virtual machines or containers
+
+- Supports automatic NAT public port mapping, flexible configuration of the Provider's network type, and creating virtual machines or containers with independent IPv6 addresses
+
+- Supports traffic monitoring, forces synchronization of traffic for sensitive operations, and resets traffic usage uniformly at the beginning of the month
+
+- Supports invitation code registration instead of public registration, and user level management for setting resource limits
diff --git a/docs/guide/oneclickvirt/oneclickvirt_install.md b/docs/guide/oneclickvirt/oneclickvirt_install.md
@@ -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```可访问，对应用户名和密码保存好。
+
+打开前端对应的页面后，将自动跳转到初始化界面，填写数据库信息和相关用户信息，点击初始化系统。
+
+完成初始化后会自动跳转到首页，可以自行探索并使用了。
+
+## 配置文件(可选)
diff --git a/docs/guide/oneclickvirt/oneclickvirt_precheck.md b/docs/guide/oneclickvirt/oneclickvirt_precheck.md
@@ -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地址的虚拟机或容器
+
+- 支持流量监控，敏感操作强行同步流量，月初统一重置流量使用
+
+- 支持邀请码注册非公开注册，支持用户等级管理设置资源限制
