Apresentação de Uptime Kuma
O Uptime Kuma é uma ferramenta de monitorização self-hosted, desenvolvida por Louis Lam e pela comunidade, com licença MIT. Consulta a intervalos regulares os seus sites, APIs, portas TCP, hosts (ping), registos DNS ou contentores Docker e avisa-o por Telegram, Discord, Slack, e-mail ou webhook quando algo deixa de responder. A interface é clara e dispensa leitura de documentação.
Destina-se a programadores, agências e equipas pequenas que querem saber que um serviço caiu antes dos clientes, sem pagar uma subscrição SaaS por monitor. Alojar a ferramenta no seu próprio VPS dá-lhe ainda controlo total sobre os dados de monitorização.
Após a entrega, o servidor tem Docker, o Uptime Kuma (imagem louislam/uptime-kuma:2) e um reverse proxy Caddy. A aplicação escuta apenas em 127.0.0.1:3001 e o Caddy publica-a em HTTPS na porta 443 do IP público do servidor, com um certificado autoassinado. Só falta abrir o URL e criar a conta de administrador.
O que pode fazer com Uptime Kuma
Muitos tipos de monitor
HTTP(S), palavra-chave numa página, TCP, ping, DNS, contentor Docker e outros. Define o intervalo de verificação e o número de falhas antes de enviar o alerta.
Alertas nos seus canais habituais
Telegram, Discord, Slack, e-mail SMTP, webhook e muitos outros serviços de notificação estão disponíveis na interface, sem plugins para instalar.
Páginas de estado públicas
Publique uma página com o estado dos seus serviços para clientes ou para a equipa, se quiser com o seu próprio domínio.
Controlo dos certificados TLS
O Uptime Kuma lê a data de expiração dos certificados dos sites HTTPS monitorizados e pode avisá-lo antes de expirarem.
Docker e Caddy pré-instalados
Dois contentores com reinício automático (
restart: always), descritos num ficheirodocker-compose.ymlque pode editar e versionar.Dados num volume dedicado
A configuração e o histórico dos monitores ficam no volume Docker
kuma_data, o que simplifica as cópias de segurança e as atualizações.
Começar com Uptime Kuma
Da encomenda à produção em poucos minutos.
- 1
Encomende o VPS com Uptime Kuma
No formulário de encomenda, escolha um VPS Linux (Paris ou Frankfurt) com Debian 12, Debian 13 ou Ubuntu 20.04, 22.04, 24.04. No separador «Aplicações», marque Uptime Kuma.
- 2
Aguarde a entrega e abra a interface
Depois de o servidor ser entregue, a instalação corre em segundo plano durante alguns minutos (transferência do Docker e das imagens). Abra então o URL abaixo. O navegador mostra um aviso porque o certificado é autoassinado: aceite a exceção para continuar.
Bashhttps://SERVER_IP:443 # Verificar o estado dos contentores por SSH: ssh root@SERVER_IP cd /opt/uptime-kuma && docker compose ps - 3
Crie a conta de administrador e o primeiro monitor
No primeiro acesso, o Uptime Kuma pede-lhe que crie o utilizador administrador. Depois, adicione um monitor (por exemplo, HTTP(S) para o seu site) e configure um canal de notificação para receber os alertas.
- 4
Proteja a instalação para produção
Aponte um registo DNS A de YOUR_DOMAIN para SERVER_IP e substitua o endereço no Caddyfile pelo seu domínio: o Caddy obterá um certificado reconhecido. As portas 80 e 443 devem ficar abertas e a porta 22 limitada aos seus IP, sempre que possível.
Bashcd /opt/uptime-kuma nano Caddyfile # YOUR_DOMAIN { # reverse_proxy 127.0.0.1:3001 # } docker compose restart caddy
Casos de uso de Uptime Kuma
Vigiar os seus sites e APIs
Um monitor HTTP por site ou endpoint crítico, com alerta por Telegram ou e-mail assim que o código de resposta sai do intervalo esperado.
Página de estado para clientes
Uma agência ou editora de SaaS publica o estado dos seus serviços numa página própria, evitando responder a cada pergunta por mensagem.
Controlar servidores e portas internas
Ping às suas máquinas, TCP a uma base de dados ou a um serviço SSH, verificação de um contentor Docker: uma vista única da infraestrutura.
Antecipar a expiração de certificados
Acompanhe a data de expiração dos certificados dos seus domínios e receba um alerta antes de uma renovação falhada deixar um site em baixo.
Perguntas frequentes sobre Uptime Kuma
A receita configura o Caddy com tls internal, que gera um certificado autoassinado para o endereço IP do servidor. A cifragem está ativa, mas o navegador não consegue verificar o emissor. Associe um domínio ao servidor e edite o Caddyfile para obter um certificado reconhecido.
Mais sobre Uptime Kuma
Localização dos ficheiros
Tudo está em /opt/uptime-kuma: o script de instalação install-uptime-kuma.sh, o ficheiro docker-compose.yml e o Caddyfile. O Caddy corre em network_mode: host e lê o Caddyfile em modo só de leitura.
Não volte a executar o script de instalação depois de editar o Caddyfile: o script reescreve-o com o endereço IP público e perderia a configuração do domínio. Para aplicar uma alteração, use docker compose restart caddy.
Passar de um IP para um domínio
Por omissão, o Caddyfile contém https://IP_PUBLIQUE:443 com tls internal, daí o certificado autoassinado. Quando substitui essa linha por um nome de domínio e remove tls internal, o Caddy pede e renova sozinho um certificado público. O DNS já tem de apontar para o servidor, caso contrário o pedido falha.
Cópias de segurança
Os dados do Uptime Kuma estão no volume Docker kuma_data. O mais seguro é parar o contentor durante a cópia e só depois arquivar o volume.
Bashcd /opt/uptime-kuma docker compose stop uptime-kuma docker volume ls | grep kuma_data docker run --rm -v uptime-kuma_kuma_data:/data -v $(pwd):/backup alpine \ tar czf /backup/kuma-backup.tar.gz -C /data . docker compose start uptime-kuma
O nome exato do volume depende da pasta do projeto; confirme-o com docker volume ls. Depois, copie o arquivo para fora do servidor. Um snapshot do VPS é um complemento útil.
Atualizações
A imagem usa a tag 2, que acompanha as versões 2.x. Para obter a versão mais recente, faça uma cópia de segurança e execute:
Bashcd /opt/uptime-kuma docker compose pull docker compose up -d
Onde colocar a monitorização
Um monitor alojado no próprio servidor que vigia não o avisa se esse servidor deixar de funcionar por inteiro. Para os serviços importantes, instale o Uptime Kuma num VPS separado, por exemplo no outro local (Paris ou Frankfurt). Consulte os nossos tutoriais para ir mais longe.

