appstore/apps/oneclickvirt/README.md

OneClickVirt

应用简介

可扩展的通用虚拟化管理平台，需外部 MySQL/MariaDB。

英文说明：Extensible virtualization management platform requiring external MySQL/MariaDB.

部署说明

• 本应用使用 Docker Compose 在 1Panel 中部署。
• 应用分类：工具。
• 支持架构：amd64、arm64。
• 可选版本：latest。
• 安装后按应用表单中的端口访问 Web UI、SSH 或对应服务。

端口

变量	说明	默认值	必填
PANEL_DB_PORT	数据库端口	3306	是
PANEL_APP_PORT_HTTP	网页端口	80	是

数据持久化

• ./storage:/app/storage

升级或迁移前，请在 1Panel 中备份上述数据目录。

配置项

变量	说明	默认值	必填
PANEL_DB_TYPE	数据库服务	mysql	是
PANEL_DB_NAME	数据库名	oneclickvirt	是
PANEL_DB_USER	数据库用户	oneclickvirt	是
PANEL_DB_USER_PASSWORD	数据库密码	oneclickvirt	是
FRONTEND_URL	前端访问地址（选填，如 https://your-domain.com）	-	否

使用说明

安装前请先在 应用商店 中安装并运行 MySQL 或 MariaDB，安装时在表单中选择对应的数据库服务。

默认 Web 访问端口为 80，容器启动后等待约 30 秒再访问。

前端访问地址（FRONTEND_URL） 为可选项：若通过 IP 直接访问可留空；若需要通过域名或 HTTPS 访问，请填入完整地址（如 https://your-domain.com），该配置影响 CORS 和 OAuth2 回调等功能。

数据持久化目录：

• ./storage → 容器内 /app/storage（配置、证书、日志、上传等）

参考资料

• 官网: https://github.com/oneclickvirt/oneclickvirt