Caso de estudo · Infraestrutura

46 containers, uma máquina, zero portas abertas

Todos os sistemas deste site — o CRM, a plataforma de photobooth, as automações e até o servidor git que os aloja — correm em hardware que é meu e que eu opero. Não há nenhuma cloud gerida entre uma má decisão e as suas consequências.

Função
Fundador, Lead Systems Architect
Serve
Clientes da ClickBox + as minhas ferramentas
Período
2024 – hoje
Stack
Docker Compose · Cloudflare Tunnel & Access · Caddy · Forgejo Actions · restic
46containers a correr em cerca de 13 GB de RAM num mini PC
0portas de entrada abertas — todo o tráfego chega por um tunnel só de saída
9m42sde indisponibilidade para os clientes ao mudar tudo para hardware novo
439rotas de API classificadas por verificadores de auth automáticos
Arquitetura

Da internet até um container

Cada pedido atravessa três barreiras antes de chegar a uma aplicação, e cada aplicação vive na sua própria rede privada.

  1. 1 · EdgeCloudflare TunnelUm conector só de saída. Nada está à escuta no router.
  2. 2 · IdentidadeCloudflare AccessPolíticas por email para pessoas, um service token por quiosque.
  3. 3 · ProxyCaddy + TinyAuthRegras por host; headers de identidade forjados são removidos.
  4. 4 · AplicaçãoA sua própria autenticação, outra vezAllowlists que negam por omissão e device tokens na própria aplicação.
  • NegócioCRM e FinOps · assinatura eletrónica · portal de clientes · plataforma de photobooth · galerias de convidados
  • Automaçãon8n · Windmill · bots de Telegram
  • EngenhariaForgejo · Actions runner · Playwright E2E · draw.io
  • PessoalApp de finanças · registo de saúde · Vaultwarden · ownCloud · Paperless-ngx
  • OperaçõesCheckmk · Dockhand · inventário de ativos em Snipe-IT
Segurança

Duas fechaduras em cada porta

A allowlist da API é aplicada duas vezes, de propósito — no proxy e outra vez em cada aplicação — para que alargar uma camada nunca abra a outra sem ninguém dar por isso.

O ponto fraco era o proxy: as aplicações confiam num header de identidade, por isso bastaria um bloco do proxy que se esquecesse de o remover para haver um bypass total. Agora, uma verificação em CI lê cada Caddyfile e falha o build se algum bloco que chega a uma aplicação não o remover.

CI/CD

O meu próprio pipeline, na minha própria máquina

  • Playwright E2E por aplicação — o build do website é servido a partir de um container descartável e testado como gate obrigatório em cada commit.
  • Imagem de verificações — typecheck, lint, formatação e unit tests antes de qualquer merge.
  • Relatório diário de cobertura — quanto de cada API publicada é realmente coberto por algum teste.
  • Documentação que não fica desatualizada — cada commit de infraestrutura atualiza o README e o brief dos agentes; um git hook mostra a checklist.
Migração

Mudar de casa em menos de dez minutos

Em junho de 2026, toda a stack passou de um velho HP EliteDesk para um mini PC Ryzen 9 — com 9 minutos e 42 segundos de indisponibilidade para os clientes, às 2 da manhã, e todas as contagens de conteúdo a bater certo no fim.

  • Pré-carregar em produção, mudar num instante~14 GB sincronizados por uma ligação privada enquanto a máquina antiga continuava a servir; só as stacks com base de dados pararam para o último delta.
  • Mover as imagens em execução, não reconstruí-lasIdênticas byte a byte às que os clientes estavam a usar — e um rebuild teria falhado, porque uma imagem base a montante tinha mudado.
  • Primeiro, uma revisão adversarialApanhou quatro armadilhas — pastas de compose separadas, named volumes que não viajam com os bind mounts, um token do tunnel no sítio errado, um volume órfão — cada uma, uma perda de dados silenciosa.
Backups

Três cópias, e um ritual

A cada dois dias, um workflow n8n pede-me no Telegram para ligar um disco, corre o backup e diz-me quando o posso desligar. Dois discos USB alternam, para que um snapshot estragado nunca afete os dois.

  • Dumps consistentespg_dump e VACUUM INTO antes de cada snapshot — nunca ficheiros de base de dados em uso.
  • restic cifradoGuarda 7 diários, 4 semanais, 6 mensais e 2 anuais.
  • Um teste de restauro mensalVerifica se o repositório tem bit-rot e restaura uma base de dados real, em vez de confiar em “provavelmente funcionou”.
Incidente, com honestidade

O backup que parou sem avisar

A terceira cópia — numa máquina de reserva — falhou em silêncio durante 48 dias. A causa presumida era uma chave de VPN expirada. Os logs do kernel diziam outra coisa: crashes idênticos em dois kernels, em processos aleatórios sem relação entre si, com bits de ponteiros corrompidos. RAM avariada.

Os discos rotativos aguentaram. A máquina de reserva está a ser substituída por um desktop ligado por Wake-on-LAN para cada backup — e a lição ficou: um backup precisa de um alarme para o silêncio, não só para os erros.

Incidente real

A noite em que as passwords desapareceram

Uma extensão de gestor de passwords atualizou-se sozinha antes do servidor. Servidor saudável, API a devolver 200, cofre vazio — só a consola do cliente dizia a verdade.

Higiene de segredos

Aspas em tudo o que tenha um $

Um valor sem aspas num .env deixou um parser estragar um segredo em hash. Agora, cada valor com caracteres especiais leva aspas, sem exceção.

Fora de horas

Tirei a Google da sala de estar

Limpei as TVs por ADB em rede e troquei o launcher por uma pequena app que escrevi e que arranca diretamente no HDMI.