OneClickVirt Documentation

ECS is a Go-based suite used to collect system and network diagnostics and perform hardware benchmarks. It includes the following capabilities:

• System and network basics collection via basics and gostun.
• Hardware testing: CPU (cputest), memory (memorytest), and disk (disktest).
• Media unlock status checks via UnlockTests.
• IP quality and security analysis via securityCheck.
• Mail port testing via portchecker.
• Network routing and performance tests via backtrace, nt3, speedtest, and pingtest.

It supports root/admin and non-root environments, as well as offline execution.

The oneclickvirt/qemu project provides a lightweight virtualization solution based on QEMU/KVM that allows for the creation of individual or batch KVM virtual machines without requiring management platforms like Proxmox VE or Incus. Key features include:

• Independent SSH ports and port mapping for each VM.
• Automatic IPv4/IPv6 allocation and port forwarding.
• Batch creation with automatic logging of VM information.
• Support for both x86_64 (amd64) and ARM64 architectures.
• Support for domestic CDN mirror acceleration.

This solution uses a containerd + nerdctl runtime to create NAT servers. Key technical features include:

• Component Stack: Installs nerdctl-full which includes containerd, runc, nerdctl, CNI, and buildkitd.
• Images: Uses custom-compiled base images from GitHub Releases (prioritizing offline loading, falling back to official images).
• Networking: Each container is provided with one external SSH port and 25 consistent internal/external ports. Supports IPv6 outbound (using ULA NAT66 for SLAAC /64 scenarios when public /128 is not assigned).
• Container Security & Isolation: Creates non-privileged containers by default and supports lxcfs mounting if installed on the host.
• Storage Management: Supports disk limit parameters (requires xfs/btrfs snapshotter with storage-opt support).
• Optimization: Supports domestic CDN image acceleration.

This project provides a pure QEMU/KVM virtualization solution for batch or individual creation of virtual machines without requiring management platforms like Proxmox VE or Incus. Key features include:

• Dedicated SSH ports and port mapping for each VM.
• Automatic IPv4/IPv6 allocation and port forwarding.
• Batch creation with automatic logging.
• Support for X86_64 and ARM64 architectures.
• Support for domestic CDN mirror acceleration.

This project provides one-click deployment and management of KVM virtual machines using KubeVirt on a k3s cluster. Key features include:

• Automated deployment of the full k3s + KubeVirt environment.
• VM management via KubeVirt Custom Resource Definitions (CRDs).
• Dedicated SSH ports and port mapping for each VM.
• Automatic IPv4/IPv6 allocation and port forwarding.
• Batch VM creation with automatic logging.
• Support for X86_64 and ARM64 architectures.
• Support for domestic CDN mirror acceleration.

The oneclickvirt/kubevirt project enables one-click deployment and management of KVM virtual machines on a Kubernetes (k3s) cluster using KubeVirt CRDs. Key features include:

• Automated deployment of the full k3s + KubeVirt environment.
• Independent SSH ports and port mapping for each VM.
• Automatic IPv4/IPv6 allocation and port forwarding.
• Support for bulk VM creation with automatic logging.
• Compatibility with x86_64 (amd64) and ARM64 architectures.
• Support for domestic CDN mirror acceleration.

The project provides bulk or individual NAT server provisioning via Docker with the following characteristics:

• OS Options: Defaults to Debian; Alpine is also available.
• Port Mapping: Each container includes 1 external SSH port and 25 ports that are consistent between internal and external networks.
• Virtualization Limit: Containers are created as non-privileged and do not mount the host's Docker daemon communication socket. Consequently, Docker cannot be nested (run) inside these NAT servers.
• Resource Isolation: lxcfs is installed and enabled by default, ensuring that CPU and memory queries inside the container reflect the configured limits rather than the host's total resources.
• Disk Management: Users can choose whether to share the host's disk or install an environment with restricted disk size.

To deploy oneclickvirt, ensure the environment meets the following criteria:

• Architectures: amd64 or arm64.
• Operating Systems: Linux, Windows, or any self-compiled system architecture.
• Network: Public network access is required. The deployed machine does not need a dedicated public IP address unless intranet penetration is required (in which case the controller must be on a Linux host with a dedicated public IPv4).
• Deployment Options: Supports all-in-one Docker images (including database) or docker-compose with separated containers.
• Frontend: Static files are deployed via nginx, caddy, or OpenResty. For non-Docker/non-source deployments, a reverse proxy to the backend port for the API path is required.

The Oracle-server-keep-alive-script is designed to maintain resource usage (CPU, Memory, Bandwidth) to prevent server reclamation. While optimized for Oracle Cloud, it works on any ARM or X86_64 architecture.

Supported Systems:

• Ubuntu 20+
• Debian 10+
• CentOS 7+
• Oracle Linux 8+
• AlmaLinux 8.5+

Installation Process: During installation, the script provides a menu: Option 1 for installation, Option 2 for uninstallation, Option 3 for updating the guide script, and Option 4 to exit.

• Pressing Enter through the prompts will enable all resource occupations.
• Enter n to skip specific resource occupations.
• For bandwidth occupation, you can choose between speedtest-go or wget.
• To use default bandwidth parameters, press Enter (default n); to customize, enter y.