appstore/apps/oneclickvirt/README.md

使用说明

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

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

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

数据持久化目录：

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

产品介绍

OneClickVirt 是一个可扩展的通用虚拟化管理控制面板，通过 SSH 或 API 远程管理多台节点服务器上的虚拟化环境，支持自动 NAT 端口映射、资源配额管理、兑换码/邀请码/OAuth2 分发容器与虚拟机。

控制面板本身对部署环境没有公网独立 IP 的要求，只需有端口能访问前端即可；甚至在无公网 IPv4 地址的环境下也可正常管理多台虚拟化节点。

详细文档见 www.spiritlhl.net

⚠️ 节点要求：被纳管节点的宿主机网卡必须直接绑定待映射的公网 IP 地址。不支持阿里云 VPC 等通过 NAT/端口转发提供公网 IP 的宿主机。

开源仓库见 https://github.com/oneclickvirt/oneclickvirt

支持的虚拟化平台

平台	实例类型
Proxmox VE	容器、虚拟机
Incus	容器、虚拟机
LXD	容器、虚拟机
Docker	容器
Podman	容器
Containerd (nerdctl)	容器

主要功能

• 多节点管理：通过 SSH 或 API 统一管理多台服务器上的虚拟化环境，无需逐台登录操作
• 自动 NAT 端口映射：支持 IPv4/IPv6 自动端口映射，支持 NAT IPv4、独立 IPv4、纯 IPv6 等多种网络类型，根据不同 Provider 自动选择最佳映射方案（原生、设备代理、iptables 等）
• 灵活分发机制：支持邀请码、兑换码、OAuth2 等方式分发容器/虚拟机，支持非公开注册的邀请机制
• 资源配额管理：按用户等级设置实例数量、CPU、内存、磁盘、带宽的配额限制
• 流量统计与限制：集成 IP 级和网络接口级的精确流量统计，支持用户级、实例级、Provider 级的流量限制，每月初统一重置
• 内置镜像数据：各虚拟化平台自带预编译镜像，无需自行查找，支持统一管理或自定义添加镜像地址
• 国际化界面：前端支持中英双语切换，默认中文显示
• 多架构支持：同时提供 amd64 与 arm64 架构镜像