Documentação do CS-PANEL

Modelo de privilégio mínimo (least-privilege)

O PHP roda como o usuário normal do servidor web (www-data/apache), nunca como root. O instalador cria /etc/sudoers.d/cspanel (validado com visudo -cf antes de ativar, com rollback automático em caso de erro de sintaxe) liberando NOPASSWD apenas para os binários que o painel realmente precisa:

Toda chamada privilegiada em PHP passa pelo prefixo CS_SUDO (sudo -n), e todo dado vindo do usuário é tratado com escapeshellarg() e validação de formato/whitelist antes de chegar em qualquer shell_exec. Uploads de mídia aceitam apenas .iso/.img com nomes sanitizados; downloads por URL só aceitam esquemas http/https apontando direto para um arquivo .iso/.img (mitigação básica de SSRF).

Execute como root em um servidor Linux limpo (Ubuntu/Debian/AlmaLinux/Rocky):

wget -N http://files.cspanel.com/install.sh
chmod 0755 install.sh
./install.sh email=seu@email.com kernel=kvm

O parâmetro kernel=kvm seleciona o hipervisor principal (o instalador também instala pacotes de OpenVZ/LXC/Xen quando solicitado, mas a criação/gestão de VPS pelo painel hoje é 100% real apenas para KVM). Ao final, o admin fica em https://SEU_IP:4085 e o painel do cliente em https://SEU_IP:4083.

Dashboard

Tela inicial do admin. Sincroniza o status de todas as VPS com virsh domstate antes de renderizar (via cs_sync_vps_status()).

VPS (listagem)

Lista todas as VPS reais criadas no libvirt, com ações de ciclo de vida.

Nova VPS (wizard de criação)

Formulário de criação real de VPS, sem simulação de progresso — a chamada só retorna após o virt-install real ser disparado.

Cria também uma entrada em tasks (tipo create_vps) com a saída completa do comando, visível no módulo Tarefas.

IP Pool

Gestão do pool de IPs (IPv4/IPv6) usado na criação de VPS.

Media (ISO) — prioridade #1

Gerenciador de imagens ISO/IMG reais em disco (CS_ISO_DIR), usadas por VPS e pelo painel do cliente.

Recipes

Scripts reutilizáveis executados diretamente no disco de uma VPS desligada, via virt-customize.

Servidores

Cadastro dos nós/servidores físicos gerenciados pelo painel (nome, hostname, IP, hipervisor).

Storage

Storage pools reais (local/NFS/iSCSI), com uso de disco calculado a partir do caminho real informado.

Importar VPS

Detecta VMs libvirt que existem no host mas ainda não estão no banco do painel (criadas manualmente via virsh, por exemplo) e permite "adotá-las".

Ao importar, lê vCPUs/memória reais da VM via dominfo e grava no banco com o estado atual (rodando/parada).

GPU Passthrough

Detecta GPUs/dispositivos PCI reais do host e permite anexá-los a uma VPS via VFIO.

Requer IOMMU habilitado na BIOS/kernel do host e reinício da VM após a atribuição.

Firewall (Host)

Controle do firewall do próprio servidor via UFW.

Firewall VPS

Regras de firewall isoladas por VPS, aplicadas em uma cadeia iptables dedicada (cspanel-vps-<id>) que é totalmente reconstruída a cada alteração — garantindo que exclusões realmente removam a regra do host.

Load Balancer

Gera o arquivo /etc/haproxy/haproxy.cfg completo a partir das regras cadastradas e recarrega o serviço.

Power DNS

Gestão de zonas e registros DNS via PowerDNS.

Registros suportados: A, AAAA, CNAME, MX, TXT, NS.

SSL Settings

Emissão de certificados Let's Encrypt reais.

Requer porta 80 livre e DNS do domínio já apontando para o servidor (modo standalone).

Planos

Cadastro de planos de venda (CPU, RAM, disco, banda, preço) usados como referência comercial.

Faturamento

Geração e controle de faturas por usuário/VPS.

Usuários

Cadastro de clientes do painel (usuário, e-mail, senha com password_hash(), limite de VPS).

API Credentials

Exibe e permite regenerar a API Key/Password (geradas com random_bytes()) usadas pelos endpoints em /api/v1.

Configuration

Edição direta da tabela settings — cada linha vira um campo de formulário automaticamente.

Tasks

Fila/histórico real de operações assíncronas (criação de VPS, download de ISO, recipes), com saída bruta dos comandos executados, visível em um painel expansível por linha.

Backup

Backup e restauração de discos de VPS.

Logs

Auditoria completa: data, ação, detalhes e IP de origem das últimas 300 ações registradas por cs_log() em todos os módulos.

Cloud Resources

Visão de capacidade: vCPUs/RAM/disco alocados (somados das VPS ativas) versus capacidade real do host.

Dashboard (Enduser)

Visão do cliente: total de VPS próprias, quantas estão em execução, limite do plano contratado e lista das 5 VPS mais recentes com status real (sincronizado via virsh domstate).

Minhas VPS (Enduser)

Wizard de 3 passos (Categoria → Sistema → Configuração) para o cliente criar sua própria VPS, respeitando o limite de VPS do seu plano. A lista de sistemas operacionais vem das ISOs reais cadastradas em Media (compartilhado com o admin) e o deploy executa o mesmo fluxo real de qemu-img + virt-install usado no painel administrativo — nada é simulado nem usa IP aleatório.