Domínios & SSL

sh0 usa Caddy como proxy reverso, o que significa que cada domínio recebe HTTPS automático via Let's Encrypt. Sem gerenciamento manual de certificados, sem cron jobs, sem arquivos de configuração — simplesmente funciona.

Como Domínios Funcionam

Quando você atribui um domínio a um app, sh0 configura automaticamente o Caddy para:

1. Escutar requisições de entrada nesse domínio (portas 80 e 443).
2. Obter e instalar um certificado SSL do Let's Encrypt.
3. Redirecionar todo o tráfego HTTP para HTTPS.
4. Fazer proxy reverso do tráfego HTTPS para o container Docker correto.
5. Renovar automaticamente o certificado antes de expirar.

Todo esse processo é automático. Depois que você adiciona um domínio e aponta seu DNS para seu servidor, todo o resto é automático.

Subdomínios Padrão

Todo app implantado no sh0 Cloud recebe um subdomínio gratuito em *.sh0.app. Isso é útil para:

• Testes rápidos sem configurar DNS
• Ambientes de staging
• Deploys de preview para pull requests

O subdomínio é baseado no nome do seu app: se seu app se chama my-api, ele será acessível em my-api.sh0.app.

Desativar *.sh0.app

Ao iniciar, o sh0 se registra no proxy em nuvem do sh0 (proxy.sh0.app) — seu identificador, seu endereço IP público e sua versão — para obter os endereços *.sh0.app. Para manter seu servidor fora do proxy, defina SH0_CLOUD_REGISTRATION=off no ambiente do serviço sh0 antes da primeira inicialização.

Em um servidor novo, o instalador faz isso por você:

curl -fsSL https://get.sh0.dev | bash -s -- --no-cloud

Em um servidor já instalado, adicione um drop-in do systemd e reinicie o sh0:

mkdir -p /etc/systemd/system/sh0.service.d
printf '[Service]\nEnvironment=SH0_CLOUD_REGISTRATION=off\n' \
  > /etc/systemd/system/sh0.service.d/cloud-registration.conf
systemctl daemon-reload && systemctl restart sh0

Em seguida, execute sh0 doctor: a linha de registro em nuvem deve indicar “disabled”. Os valores off, 0, false e no são aceitos.

Adicionando um Domínio Personalizado

Para adicionar um domínio personalizado ao seu app:

1. Navegue até seu app e abra a aba Domains.
2. Clique em Add Domain.
3. Insira seu nome de domínio (ex.: app.example.com ou example.com).
4. Salve e configure seu DNS (veja abaixo).

Você pode adicionar múltiplos domínios a um único app. Todos servirão a mesma aplicação. Isso é útil para:

• Servir tanto example.com quanto www.example.com
• Suportar múltiplos nomes de domínio que apontam para o mesmo serviço
• Manter o subdomínio padrão como fallback junto ao seu domínio personalizado

Configuração DNS

Aponte seu domínio para seu servidor sh0 adicionando registros DNS no seu registrador ou provedor DNS:

# For app.example.com
Type: A
Name: app
Value: 203.0.113.50
TTL: 300

# For example.com (root domain)
Type: A
Name: @
Value: 203.0.113.50
TTL: 300

SSL Automático

Certificados SSL são gerenciados inteiramente pelo Caddy. Não há nada para configurar, nenhum certificado para fazer upload e nenhum script de renovação para manter.

Como o Let's Encrypt Funciona

Quando você adiciona um domínio, o seguinte acontece automaticamente:

1. Desafio -- Caddy inicia um desafio ACME HTTP-01 para provar a propriedade do domínio.
2. Emissão -- Let's Encrypt verifica o desafio e emite um certificado (geralmente em segundos).
3. Instalação -- Caddy instala o certificado e começa a servir tráfego HTTPS.
4. Renovação -- Caddy renova automaticamente o certificado 30 dias antes da expiração.

Domínios Wildcard

Domínios wildcard (ex.: *.example.com) permitem que qualquer subdomínio roteie para seu app. Isso é útil para:

• Aplicações multi-tenant onde cada tenant recebe um subdomínio
• Deploys de preview com subdomínios únicos por branch
• Roteamento baseado em geografia ou idioma

# In sh0 Settings > SSL, configure your DNS provider
# Example for Cloudflare:
DNS_PROVIDER=cloudflare
CLOUDFLARE_API_TOKEN=your-api-token

Status do Certificado SSL

A seção Domínios de cada app mostra o status SSL para cada domínio configurado:

Duas regras a mais desde a v1.6.25. Um domínio Ativo cujo certificado desaparece do disco volta a Pendente após duas verificações consecutivas, nunca por uma única leitura. E a data de expiração do certificado é agora lida do próprio certificado, para que os alertas de expiração tenham finalmente um valor com que trabalhar.

Solução de Problemas

Se seu domínio não está funcionando ou o certificado SSL falha ao provisionar, verifique estes problemas comuns:

# Check if DNS resolves correctly
dig +short app.example.com

# Test if port 80 is accessible from outside
curl -I http://app.example.com

# Check Caddy logs for certificate errors
journalctl -u sh0 | grep -i "certificate\|tls\|acme"