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

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 环境变量：

docker run -d \
  --name oneclickvirt \
  -p 80:80 \
  -e FRONTEND_URL="https://your-domain.com" \
  -v oneclickvirt-data:/var/lib/mysql \
  -v oneclickvirt-storage:/app/storage \
  --restart unless-stopped \
  spiritlhl/oneclickvirt:latest

或者使用 GitHub Container Registry：

docker run -d \
  --name oneclickvirt \
  -p 80:80 \
  -e FRONTEND_URL="https://your-domain.com" \
  -v oneclickvirt-data:/var/lib/mysql \
  -v oneclickvirt-storage:/app/storage \

  --restart unless-stopped \
  ghcr.io/oneclickvirt/oneclickvirt:latest

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

docker run -d \
  --name oneclickvirt \
  -p 80:80 \
  -e FRONTEND_URL="https://your-domain.com" \
  -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）
• DB_HOST: 数据库主机地址
• DB_PORT: 数据库端口（默认 3306）
• DB_NAME: 数据库名称
• DB_USER: 数据库用户名
• DB_PASSWORD: 数据库密码

使用 Docker Compose 可以一键部署完整的开发环境，采用分容器部署架构，包括独立的前端容器、后端容器和数据库容器：

git clone https://github.com/oneclickvirt/oneclickvirt.git
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 配置：

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

停止服务：

docker-compose down

查看日志：

docker-compose logs -f

清理数据：

docker-compose down
rm -rf ./data

如果需要修改源码或自定义构建：

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

git clone https://github.com/oneclickvirt/oneclickvirt.git
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

独立数据库版本：

git clone https://github.com/oneclickvirt/oneclickvirt.git
cd oneclickvirt
docker build -f Dockerfile.no-db -t oneclickvirt:no-db .
docker run -d \
  --name oneclickvirt \
  -p 80:80 \
  -e FRONTEND_URL="https://your-domain.com" \
  -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

环境要求

• Go 1.24.5
• Node.js 22+
• MySQL 5.7+
• npm 或 yarn

环境部署

1. 构建前端

cd web
npm i
npm run serve

2. 构建后端

cd server
go mod tidy
go run main.go

3. 开发模式下不需要反代后端，vite已自带后端代理请求。

4. 在mysql中创建一个空的数据库oneclickvirt，记录对应的账户和密码。

5. 访问前端地址，自动跳转到初始化界面，填写数据库信息和相关信息，点击初始化。

6. 完成初始化后会自动跳转到首页，可以开始开发测试了。

本地开发

• 前端：http://localhost:8080
• 后端 API：http://localhost:8888
• API 文档：http://localhost:8888/swagger/index.html