Coloque seus apps no ar: servidor + domínio

Criar a VPS

Crie a conta, clique em criar servidor (às vezes chamado de “droplet” ou “instance”), escolha Ubuntu 24.04 e o plano mais barato. Em 1–2 minutos ele fica pronto e mostra o IP. Copie o IP — vamos usar em tudo.

Apontar o domínio pro servidor

DNS é a “agenda de contatos” da internet: ele diz qual nome leva a qual IP. Você cria registros do tipo A (nome → IP):

Tipo   Nome    Valor (aponta para)
A      @       SEU_IP        # o domínio raiz (seudominio.com)
A      www     SEU_IP
A      app1    SEU_IP        # vira app1.seudominio.com
A      app2    SEU_IP        # um por app...

Entrar no servidor (SSH)

SSH é o jeito de controlar o servidor por texto, de longe. Abra o terminal do seu computador e digite (troque pelo seu IP):

$ ssh root@SEU_IP

Ele pergunta a senha (a que o provedor te deu). Ao digitar, não aparece nada na tela — é normal, é segurança. Aperte Enter. Deu certo? Você está “dentro” do servidor.

Preparar o servidor

Primeiro atualize tudo. Depois instale o Docker — o programa que roda seus apps em “caixinhas” isoladas (containers), sem bagunçar o servidor.

$ apt update && apt upgrade -y      # atualiza o sistema
$ curl -fsSL https://get.docker.com | sh   # instala o Docker
$ ufw allow 22 && ufw allow 80 && ufw allow 443 && ufw --force enable

Montar o “porteiro” (Caddy) + o primeiro app

O Caddy recebe todas as visitas, coloca o cadeado (HTTPS de graça, automático) e encaminha cada endereço pro app certo. Vamos deixar o Caddy e os apps juntos, numa pasta só.

a) O código do seu app vai em /opt/meuapp, com um Dockerfile (a “receita” de como rodar). Exemplo pra um app Python/FastAPI:

FROM python:3.12-slim
WORKDIR /app
COPY requirements.txt .
RUN pip install -r requirements.txt
COPY . .
CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "8000"]

b) A “planta” que sobe tudo, em /opt/stack/docker-compose.yml:

services:
  caddy:
    image: caddy:2
    restart: unless-stopped
    ports: ["80:80", "443:443"]
    volumes:
      - ./Caddyfile:/etc/caddy/Caddyfile
      - caddy_data:/data
  meuapp:
    build: /opt/meuapp
    restart: unless-stopped
    expose: ["8000"]
volumes:
  caddy_data:

c) A lista do porteiro, em /opt/stack/Caddyfile — cada endereço e pra qual app ele vai:

app1.seudominio.com {
    reverse_proxy meuapp:8000
    encode zstd gzip
}

d) Suba tudo:

$ cd /opt/stack
$ docker compose up -d --build

Adicionar mais apps (é só repetir)

Para cada app novo você faz três passos rápidos: 1) põe o código em /opt/outroapp; 2) adiciona um serviço no docker-compose.yml e um bloco no Caddyfile; 3) cria o registro A do subdomínio no DNS (se não usou o curinga *).

app2.seudominio.com {
    reverse_proxy outroapp:8000
    encode zstd gzip
}

$ cd /opt/stack
$ docker compose up -d --build         # sobe o app novo
$ docker compose exec caddy caddy reload --config /etc/caddy/Caddyfile

O último comando avisa o porteiro do endereço novo sem derrubar os que já estão no ar.

Manutenção do dia a dia

$ docker compose ps            # o que está rodando
$ docker compose logs -f meuapp # ver mensagens/erros de um app
$ docker compose restart meuapp # reiniciar um app
$ docker compose up -d --build  # aplicar mudanças no código