# qkpanel

**Repository Path**: sidaxin/qkpanel

## Basic Information

- **Project Name**: qkpanel
- **Description**: 智维轻联运维面板 - 轻量级服务器运维管理面板
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 2
- **Created**: 2026-07-10
- **Last Updated**: 2026-07-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 智维轻联运维面板 (QKpanel)

> 轻量、智能、集群化 —— 下一代服务器运维管理面板

[English](README.en.md)

## 项目简介

QKpanel（智维轻联运维面板）是一款基于 Go + Vue3 构建的轻量级服务器运维管理面板，定位为宝塔面板和 1Panel 的现代化替代方案。

核心差异化优势：

- **极低资源占用**：运行内存 ≤80MB，远低于同类面板
- **原生 AI 算力支持**：内置 GPU 监控与模型部署能力
- **原生集群管理**：多服务器统一管控，批量运维
- **单二进制部署**：Go 单文件编译，一键安装即可运行

## 核心特性

- 🚀 **轻量高效** — Go 单二进制，运行内存 ≤80MB
- 🎨 **现代界面** — Vue3 + Element Plus 响应式交互界面
- 🌐 **网站管理** — Nginx 配置、PHP 多版本切换、SSL 证书自动申请
- 🗄️ **数据库管理** — MySQL 一键安装与可视化管理
- 🐳 **Docker 管理** — 容器与镜像的可视化生命周期管理
- 📂 **文件管理** — 在线文件浏览器，支持流式上传/下载
- 🧠 **AI 算力** — GPU 监控、模型部署、推理服务管理
- 🔗 **集群管理** — 多服务器统一纳管，批量操作与同步
- 🔒 **安全防护** — IP 白名单、暴力破解防护、权限隔离
- ⚡ **一键部署** — 单命令完成安装，开箱即用

## 技术栈

| 组件 | 技术 |
|------|------|
| 后端 | Go 1.21+ / Gin / GORM |
| 前端 | Vue3 / Vite / Element Plus / TypeScript |
| 数据库 | SQLite |
| 容器 | Docker API |
| 通信 | HTTP REST + WebSocket |

## 快速开始

### 一键安装（Linux 服务器）

在项目目录内从源码安装（推荐开发/测试）：

```bash
git clone https://github.com/qkpanel/qkpanel.git && cd qkpanel
sudo bash scripts/install.sh --from-source --install-deps
```

在线安装（需已发布 Release 包）：

```bash
curl -fsSL https://raw.githubusercontent.com/qkpanel/qkpanel/main/scripts/install.sh | sudo bash
```

常用选项：

```bash
sudo bash scripts/install.sh --port 8888          # 自定义端口
sudo bash scripts/install.sh --no-start           # 安装后不自动启动
sudo bash scripts/uninstall.sh                    # 卸载面板
sudo bash scripts/uninstall.sh --keep-data        # 卸载但保留数据
```

安装完成后访问 `http://<服务器IP>:9999`，默认账号 `admin` / `changeme123`。

构建发布包：

```bash
bash scripts/build-release.sh
```

### 本地开发

```bash
# 后端
cd backend && go run cmd/server/main.go

# 前端
cd frontend && pnpm install && pnpm dev
```

## 系统支持

| 操作系统 | 版本 |
|----------|------|
| Ubuntu | 20.04 / 22.04 |
| Debian | 11 / 12 |
| CentOS | 7 / 8 / Stream 9 |

## 项目文档

- [技术架构文档](docs/technical-architecture.md)
- [开发指南文档](docs/development-guide.md)

## 开源协议

本项目基于 [MIT License](LICENSE) 开源。

## 联系我们

- 官网：https://qkpanel.com
- GitHub：https://github.com/qkpanel/qkpanel
- 社区论坛：https://community.qkpanel.com
- 邮箱：contact@qkpanel.com

---

> 智维轻联，让运维更简单。