spiritlhl/oneclickvirt Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

OneClickVirt 虚拟化管理平台

一个可扩展的通用虚拟化管理平台，支持 LXD、Incus、Docker 和 Proxmox VE。

镜像概述和主要用途

OneClickVirt 旨在提供便捷的虚拟化环境统一管理解决方案，支持多种主流虚拟化技术，可通过容器化方式快速部署。该平台提供灵活的部署选项，包括内置数据库的一体化版本和需外部数据库的独立版本，满足不同场景下的使用需求，适用于个人开发者、小型团队或企业环境中对多种虚拟化资源的集中管理。

核心功能和特性

• 多虚拟化技术支持：兼容 LXD、Incus、Docker 和 Proxmox VE 等主流虚拟化平台
• 灵活部署选项：提供一体化版本（内置数据库）和独立数据库版本，适应不同架构需求
• 多架构支持：所有镜像均支持 linux/amd64 和 linux/arm64 架构
• 数据持久化：通过卷挂载确保数据库数据和应用存储的持久化
• 便捷配置：支持通过环境变量自定义域名、数据库连接等关键参数

使用场景和适用范围

• 快速部署场景：需要快速搭建虚拟化管理平台，无需复杂配置时，选择一体化版本
• 定制化环境：已有外部数据库或需分离部署组件时，选择独立数据库版本
• 开发测试：通过 Docker Compose 快速部署完整开发环境，包含前端、后端和数据库
• 生产环境：可固定版本标签确保环境稳定性，支持自定义域名和安全配置

详细使用方法和配置说明

镜像标签说明

快速部署方式

方式一：使用预构建镜像

一体化版本（内置数据库）

基础使用（不配置域名）：

bash
docker run -d \
  --name oneclickvirt \
  -p 80:80 \
  -v oneclickvirt-data:/var/lib/mysql \
  -v oneclickvirt-storage:/app/storage \
  --restart unless-stopped \
  spiritlhl/oneclickvirt:latest

配置域名访问：

设置 FRONTEND_URL 环境变量指定前端访问地址：

bash
docker run -d \
  --name oneclickvirt \
  -p 80:80 \
  -e FRONTEND_URL="[***]" \
  -v oneclickvirt-data:/var/lib/mysql \
  -v oneclickvirt-storage:/app/storage \
  --restart unless-stopped \
  spiritlhl/oneclickvirt:latest

或使用 GitHub Container Registry：

bash
docker run -d \
  --name oneclickvirt \
  -p 80:80 \
  -e FRONTEND_URL="[***]" \
  -v oneclickvirt-data:/var/lib/mysql \
  -v oneclickvirt-storage:/app/storage \
  --restart unless-stopped \
  ghcr.io/oneclickvirt/oneclickvirt:latest

独立数据库版本

使用外部数据库，镜像体积更小，启动速度更快：

bash
docker run -d \
  --name oneclickvirt \
  -p 80:80 \
  -e FRONTEND_URL="[***]" \
  -e DB_HOST="your-mysql-host" \
  -e DB_PORT="3306" \
  -e DB_NAME="oneclickvirt" \
  -e DB_USER="root" \
  -e DB_PASSWORD="your-password" \
  -v oneclickvirt-storage:/app/storage \
  --restart unless-stopped \
  spiritlhl/oneclickvirt:no-db

环境变量说明：

• FRONTEND_URL: 前端访问地址（必填，支持 http/https，影响 CORS、OAuth2 回调等功能）
• DB_HOST: 数据库主机地址（独立数据库版本必填）
• DB_PORT: 数据库端口（默认 3306）
• DB_NAME: 数据库名称（默认 oneclickvirt）
• DB_USER: 数据库用户名
• DB_PASSWORD: 数据库密码

方式二：使用 Docker Compose

采用分容器部署架构，包含前端、后端和数据库容器：

bash
git clone [***]
cd oneclickvirt
docker-compose up -d --build || docker compose up -d --build

默认配置说明：

• 前端服务：http://localhost:8888
• 后端 API：通过前端代理访问
• MySQL 数据库：端口 3306，数据库名 oneclickvirt，无密码
• 数据持久化：
  • 数据库数据：./data/mysql
  • 应用存储：./data/app/

初始化配置： 首次访问时需进行初始化，数据库配置填写：

• 数据库地址：mysql（容器名称，非 127.0.0.1）
• 数据库端口：3306
• 数据库名称：oneclickvirt
• 数据库用户：root
• 数据库密码：留空（默认无密码）

自定义端口（可选）： 修改 docker-compose.yaml 文件中的 ports 配置：

yaml
services:
  web:
    ports:
      - "你的端口:80"  # 例如 "80:80" 或 "8080:80"

常用命令：

• 停止服务：docker-compose down
• 查看日志：docker-compose logs -f
• 清理数据：docker-compose down && rm -rf ./data

方式三：自己编译打包

一体化版本（内置数据库）：

bash
git clone [***]
cd oneclickvirt
docker build -t oneclickvirt .
docker run -d \
  --name oneclickvirt \
  -p 80:80 \
  -v oneclickvirt-data:/var/lib/mysql \
  -v oneclickvirt-storage:/app/storage \
  --restart unless-stopped \
  oneclickvirt

独立数据库版本：

bash
git clone [***]
cd oneclickvirt
docker build -f Dockerfile.no-db -t oneclickvirt:no-db .
docker run -d \
  --name oneclickvirt \
  -p 80:80 \
  -e FRONTEND_URL="[***]" \
  -e DB_HOST="your-mysql-host" \
  -e DB_PORT="3306" \
  -e DB_NAME="oneclickvirt" \
  -e DB_USER="root" \
  -e DB_PASSWORD="your-password" \
  -v oneclickvirt-storage:/app/storage \
  --restart unless-stopped \
  oneclickvirt:no-db

默认账户

系统初始化后生成默认管理员账户：

• 用户名：admin
• 密码：Admin123!@#

提示：首次登录后请立即修改默认密码，通过用户管理界面点击对应用户进行修改。

配置文件

主要配置文件路径：server/config.yaml