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

🐳 Docker — Gerenciamento completo de containers e Docker Compose

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

Infraestrutura

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

🔒 Certificados SSL — Let's Encrypt automático com renovação automática

🗄️ 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

📡 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

🦠 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

📈 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

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
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, LESS
Banco de Dados	SQLite / PostgreSQL
Servidor Web	Nginx, Gunicorn
Containers	Docker, Docker Compose
Segurança	ClamAV, TOTP (pyotp), Cryptography

---

🤝 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.

---

💬 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