131 lines
3.4 KiB
Markdown
131 lines
3.4 KiB
Markdown
# Server Control Panel
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
## Overview
|
|
|
|
Server Control Panel is a web-based interface for monitoring and managing QEMU virtual machines and system services. Built with **Nuxt.js** and styled using **DaisyUI**, this panel provides real-time system information using the **systeminformation** NPM package.
|
|
|
|
## Features
|
|
|
|
- Display OS, CPU, and Memory Information
|
|
- Manage QEMU Virtual Machines (Start/Shutdown)
|
|
- View and Control System Services (Start/Stop functionality removed in the latest version)
|
|
- Clean and modern UI
|
|
|
|
## Technologies Used
|
|
|
|
- **[Nuxt.js](https://nuxt.com/)** - Vue.js-based framework for SSR and static site generation
|
|
- **[DaisyUI](https://daisyui.com/)** - Tailwind CSS component library for styling
|
|
- **[systeminformation](https://www.npmjs.com/package/systeminformation)** - Node.js library for retrieving system and hardware details
|
|
|
|
|
|
|
|
## Installation
|
|
|
|
### Prerequisites
|
|
|
|
- [Node.js](https://nodejs.org/) (v16+ recommended)
|
|
- [NPM](https://www.npmjs.com/)
|
|
- [QEMU](https://documentation.ubuntu.com/server/how-to/virtualisation/virtual-machine-manager/index.html) (can be disabled tho)
|
|
- [PM2](https://pm2.keymetrics.io/)
|
|
|
|
### Steps
|
|
|
|
1. Clone the repository:
|
|
```sh
|
|
git clone https://github.com/WeeXnes/server_panel.git
|
|
cd server_panel
|
|
```
|
|
2. Install dependencies:
|
|
```sh
|
|
npm install
|
|
```
|
|
3. Set the admin password:
|
|
```sh
|
|
npm run password_gen <password>
|
|
```
|
|
4. Build the Panel
|
|
```sh
|
|
npm run build
|
|
```
|
|
5. Start the Server
|
|
```sh
|
|
pm2 start
|
|
```
|
|
|
|
## Configuration
|
|
|
|
Modify the `panel.config.ts` file (if needed) to configure VM management and system services settings.
|
|
|
|
```ts
|
|
import { reactive } from "vue";
|
|
|
|
export const settings = reactive({
|
|
ignoreCache: true,
|
|
// Leave empty to scan all interfaces
|
|
// or change item to "disabled" to disable interface scanning
|
|
interfaces_to_scan:[
|
|
"eth0"
|
|
],
|
|
// enable or disable QEMU controls
|
|
enable_qemu_controls: true,
|
|
// list the qemu vm names you want to monitor/scan for
|
|
qemu_vms: [
|
|
{
|
|
name: "Gameserver",
|
|
// OS Info has to be declared here due to technical
|
|
// limitations of not being able to gather vm OS info
|
|
os: "Ubuntu 24.04"
|
|
},
|
|
{
|
|
name: "Ubuntu_VM1",
|
|
os: "Ubuntu 24.04"
|
|
},
|
|
],
|
|
//enable or disable systemctl service monitoring
|
|
enable_services: true,
|
|
//list systemctl services to monitor/scan for
|
|
systemctl_services:[
|
|
"libvirt",
|
|
"frp"
|
|
],
|
|
// set the password hash by running "npm run password_gen <password>" before building
|
|
password_hash: ""
|
|
});
|
|
```
|
|
|
|
|
|
## Usage
|
|
|
|
- The dashboard provides an overview of system information.
|
|
- You can start or shut down virtual machines.
|
|
- Service monitoring
|
|
|
|
## Optional (Recommended)
|
|
|
|
### Running the Website with SSL
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
## Author
|
|
|
|
Developed by **WeeXnes**
|
|
|