ServerKit/docs/README.pt.md

ServerKit

Infraestrutura auto-hospedada, de forma simples.

Um painel de controle de servidores leve e moderno para gerenciar aplicações web, bancos de dados, containers Docker e segurança — sem a complexidade do Kubernetes ou o custo de plataformas gerenciadas.

English | Español | 中文版 | Português

Funcionalidades · Início Rápido · Capturas de Tela · Arquitetura · Roadmap · Documentação · Contribuindo · Discord

---

---

🎯 Funcionalidades

Aplicações & Containers

🐘 PHP / WordPress — PHP-FPM 8.x com instalação do WordPress em um clique

🐍 Aplicações Python — Deploy de Flask e Django com Gunicorn

🟢 Node.js — Aplicações gerenciadas pelo PM2 com streaming de logs

📦 Deploys Manuais & Zip — Faça deploy a partir de um caminho local/manual ou de um upload zip, além das fontes Git e Docker

🐳 Docker — Gerenciamento completo de containers e Docker Compose

🔄 Ciclo de Vida de Containers — Detecção de atualizações de imagem com aplicação em um clique, suspensão automática de containers ociosos e auto-escalonamento horizontal orientado por CPU

🔑 Variáveis de Ambiente — Gerenciamento seguro e criptografado por aplicação

Infraestrutura

🌐 Gerenciamento de Domínios — Virtual hosts Nginx com configuração simplificada

🔒 SSL / TLS — Let's Encrypt automático com renovação automática, HTTPS opcional (de melhor esforço) que nunca bloqueia uma instalação, cifras TLS 1.2+/AEAD reforçadas, configurações compatíveis com Cloudflare e registros CAA automáticos

🗄️ Bancos de Dados — Suporte a MySQL/MariaDB e PostgreSQL

🛡️ Firewall (UFW) — Gerenciamento visual de regras de firewall

⏰ Cron Jobs — Agendamento de tarefas com editor visual

📁 Gerenciador de Arquivos — Navegue e edite arquivos pela interface web, incluindo navegar e visualizar buckets S3 / Backblaze B2

📡 Servidor FTP — Gerencie usuários e acessos do vsftpd

Segurança

🔐 Autenticação de Dois Fatores — Baseada em TOTP com códigos de recuperação

🔑 Passkeys / WebAuthn — Login sem senha e como segundo fator com chaves de hardware, Touch ID e Windows Hello

🧯 Firewall de Aplicações Web — ModSecurity v3 + OWASP Core Rule Set por aplicação, com modos de detecção/bloqueio, paranoia ajustável e eventos no log de auditoria

🦠 Varredura de Malware — Integração com ClamAV e quarentena

📋 Monitoramento de Integridade de Arquivos — Detecção de alterações não autorizadas

🚨 Alertas de Segurança — Notificações de ameaças em tempo real

🧱 Fail2ban & SSH — Proteção contra força bruta e gerenciamento de chaves SSH

Monitoramento & Alertas

📊 Métricas em Tempo Real — Monitoramento de CPU, RAM, disco e rede via WebSocket

🎮 Monitoramento de GPU — Utilização, memória, temperatura e consumo de GPUs NVIDIA, com uso por processo e por container

📈 Rastreamento de Uptime — Histórico de disponibilidade do servidor

🔔 Notificações — Discord, Slack, Telegram e webhooks genéricos

🖥️ Multi-Servidor — Monitoramento e gerenciamento remoto de servidores baseado em agentes

---

🚀 Início Rápido

⏱️ Pronto para usar em menos de 2 minutos

Opção 1: Instalação em Uma Linha (Recomendado)

curl -fsSL https://serverkit.ai/install.sh | bash

Funciona no Ubuntu 22.04+ e Debian 12+. Configura tudo automaticamente.

Opção 2: Docker

git clone https://github.com/jhd3197/ServerKit.git
cd ServerKit
cp .env.example .env       # depois edite o .env com suas chaves secretas
docker compose up -d       # acesse em http://localhost

Opção 3: Instalação Manual

Consulte o Guia de Instalação para instruções passo a passo.

Requisitos

	Mínimo	Recomendado
SO	Ubuntu 22.04 LTS	Ubuntu 24.04 LTS
CPU	1 vCPU	2+ vCPU
RAM	1 GB	2+ GB
Disco	10 GB	20+ GB
Docker	24.0+	Mais recente

---

📸 Capturas de Tela

Ver Mais Capturas de Tela

---

🏗️ Arquitetura

                          ┌──────────────────┐
                          │     INTERNET     │
                          └────────┬─────────┘
                                   │
                                   ▼
┌──────────────────────────────────────────────────────────────────────────┐
│                            YOUR SERVER                                    │
│                                                                           │
│  ┌─────────────────────────────────────────────────────────────────────┐ │
│  │                      NGINX (Reverse Proxy)                          │ │
│  │                         :80 / :443                                  │ │
│  │                                                                     │ │
│  │    app1.com ──┐      app2.com ──┐      api.app3.com ──┐            │ │
│  └───────────────┼─────────────────┼─────────────────────┼─────────────┘ │
│                  │ proxy_pass      │ proxy_pass          │ proxy_pass    │
│                  ▼                 ▼                     ▼               │
│  ┌─────────────────────────────────────────────────────────────────────┐ │
│  │                      DOCKER CONTAINERS                              │ │
│  │                                                                     │ │
│  │    ┌───────────┐    ┌───────────┐    ┌───────────┐                 │ │
│  │    │ WordPress │    │   Flask   │    │  Node.js  │    ...          │ │
│  │    │   :8001   │    │   :8002   │    │   :8003   │                 │ │
│  │    └─────┬─────┘    └───────────┘    └───────────┘                 │ │
│  └──────────┼──────────────────────────────────────────────────────────┘ │
│             │                                                            │
│             ▼                                                            │
│  ┌─────────────────────────────────────────────────────────────────────┐ │
│  │                        DATABASES                                    │ │
│  │    MySQL :3306    PostgreSQL :5432    Redis :6379                  │ │
│  └─────────────────────────────────────────────────────────────────────┘ │
└──────────────────────────────────────────────────────────────────────────┘

Ver Documentação Completa da Arquitetura → — Fluxo de requisições, sistema de templates, alocação de portas, vinculação de bancos de dados e solução de problemas.

---

🗺️ Roadmap

• Infraestrutura base — Flask + React + JWT + WebSocket
• Gerenciamento de aplicações — PHP, Python, Node.js, Docker
• Domínio & SSL — Virtual hosts Nginx, Let's Encrypt
• Bancos de dados — MySQL, PostgreSQL
• Gerenciamento de arquivos & FTP
• Monitoramento & alertas — Métricas, webhooks, rastreamento de uptime
• Segurança — 2FA, ClamAV, integridade de arquivos, Fail2ban
• Firewall — Integração com UFW
• Gerenciamento multi-servidor — Agente em Go, painel centralizado
• Deploy via Git — Webhooks, deploy automático, rollback, zero-downtime
• Backup & restauração — S3, Backblaze B2, backups agendados
• Servidor de e-mail — Postfix, Dovecot, DKIM/SPF/DMARC
• Equipes & permissões — RBAC, log de auditoria
• Aplicativo mobile — React Native com notificações push
• Marketplace de plugins — Extensões, widgets personalizados, temas
• Firewall de aplicações web — ModSecurity v3 + OWASP CRS por aplicação
• Segurança de containers — Varredura de CVEs de imagem (grype) + SBOM (syft)
• Autenticação sem senha — WebAuthn / passkeys
• DNS dinâmico — Atualizações A/AAAA autenticadas por token
• Monitoramento de GPU — Utilização, memória e processos NVIDIA
• Ciclo de vida de containers — Aplicação de atualização de imagem, suspensão automática, auto-escalonamento horizontal
• Reforço de TLS — HTTPS opcional, configurações compatíveis com Cloudflare, CAA automático
• Gerenciador de secrets & gateway de webhooks de entrada
• Acesso remoto — Exponha serviços privados/NAT via túneis WireGuard gerenciados por agente
• Hub de conexões — Contas externas unificadas (fonte, nuvem, DNS, registradores, SMTP, armazenamento)
• Publicação WordPress — Subdomínios reais, troca de URL, domínios personalizados, HTTPS wildcard

Detalhes completos: ROADMAP.md

---

📖 Documentação

Documento	Descrição
Arquitetura	Design do sistema, fluxo de requisições, diagramas
Guia de Instalação	Instruções completas de configuração
Guia de Deploy	Comandos CLI e deploy em produção
Referência da API	Endpoints da API REST
Novas Funcionalidades	Referência de endpoints e páginas das funcionalidades mais recentes de dev
Roadmap	Roadmap de desenvolvimento e funcionalidades planejadas
Contribuindo	Como contribuir

---

🧱 Stack Tecnológica

Camada	Tecnologia
Backend	Python 3.11, Flask, SQLAlchemy, Flask-SocketIO
Frontend	React 18, Vite, SCSS
Banco de Dados	SQLite / PostgreSQL
Servidor Web	Nginx, Gunicorn
Containers	Docker, Docker Compose
Segurança	ClamAV, TOTP (pyotp), Cryptography, ModSecurity v3 + OWASP CRS, grype, syft

---

🤝 Contribuindo

Contribuições são bem-vindas! Por favor, leia o CONTRIBUTING.md primeiro.

fork → branch de feature → commit → push → pull request

Áreas prioritárias: Implementações de backup, canais de notificação adicionais, melhorias de UI/UX, documentação.

---

🔭 Projetos Relacionados

Faro — Um cliente de desktop moderno para SFTP, FTP, SSH e armazenamento compatível com S3, do mesmo autor. Salve um servidor uma vez e depois navegue pelos seus arquivos em uma visão de painel duplo e abra um terminal sobre a mesma sessão SSH — além de transferências com arrastar e soltar, sincronização de diretórios em um sentido e edição no lugar. Ele ainda tem um Agent Bridge que permite ao Claude Code (ou qualquer agente MCP) executar comandos em um servidor através da sua sessão autenticada, com aprovação por comando e sem compartilhar credenciais.

O ServerKit gerencia seus servidores pelo navegador; o Faro é o companheiro de desktop para transferência de arquivos, shells e trabalho pontual em todos os seus servidores. Baixe uma versão →

---

💬 Comunidade

Entre no Discord para tirar dúvidas, compartilhar feedback ou obter ajuda com sua configuração.

---

ServerKit — Simples. Moderno. Auto-hospedado.

Reportar Bug · Solicitar Funcionalidade

Feito com ❤️ por Juan Denis