Dominios y SSL

sh0 usa Caddy como su proxy inverso, lo que significa que cada dominio obtiene HTTPS automático vía Let's Encrypt. Sin gestión manual de certificados, sin trabajos cron, sin archivos de configuración -- simplemente funciona.

Cómo funcionan los dominios

Cuando asignas un dominio a una app, sh0 configura automáticamente Caddy para:

1. Escuchar solicitudes entrantes en ese dominio (puertos 80 y 443).
2. Obtener e instalar un certificado SSL de Let's Encrypt.
3. Redirigir todo el tráfico HTTP a HTTPS.
4. Hacer proxy inverso del tráfico HTTPS al contenedor Docker correcto.
5. Renovar automáticamente el certificado antes de que expire.

Todo este proceso es automático. Una vez que agregas un dominio y apuntas su DNS a tu servidor, todo lo demás es automático.

Subdominios predeterminados

Cada app desplegada en sh0 Cloud recibe un subdominio gratuito bajo *.sh0.app. Esto es útil para:

• Pruebas rápidas sin configurar DNS
• Ambientes de staging
• Despliegues de vista previa para pull requests

El subdominio se basa en el nombre de tu app: si tu app se llama my-api, será accesible en my-api.sh0.app.

Agregar un dominio personalizado

Para agregar un dominio personalizado a tu app:

1. Navega a tu app y abre la pestaña Domains.
2. Haz clic en Add Domain.
3. Ingresa tu nombre de dominio (ej., app.example.com o example.com).
4. Guarda y configura tu DNS (ver abajo).

Puedes agregar múltiples dominios a una sola app. Todos servirán la misma aplicación. Esto es útil para:

• Servir tanto example.com como www.example.com
• Soportar múltiples nombres de dominio que apuntan al mismo servicio
• Mantener el subdominio predeterminado como respaldo junto a tu dominio personalizado

Configuración DNS

Apunta tu dominio a tu servidor sh0 agregando registros DNS en tu registrador o proveedor 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

Los certificados SSL son gestionados completamente por Caddy. No hay nada que configurar, no hay certificados que subir y no hay scripts de renovación que mantener.

Cómo funciona Let's Encrypt

Cuando agregas un dominio, lo siguiente ocurre automáticamente:

1. Desafío -- Caddy inicia un desafío ACME HTTP-01 para demostrar la propiedad del dominio.
2. Emisión -- Let's Encrypt verifica el desafío y emite un certificado (generalmente en segundos).
3. Instalación -- Caddy instala el certificado y comienza a servir tráfico HTTPS.
4. Renovación -- Caddy renueva automáticamente el certificado 30 días antes de su expiración.

Dominios wildcard

Los dominios wildcard (ej., *.example.com) permiten que cualquier subdominio se enrute a tu app. Esto es útil para:

• Aplicaciones multiinquilino donde cada inquilino obtiene un subdominio
• Despliegues de vista previa con subdominios únicos por rama
• Enrutamiento geográfico o basado en idioma

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

Estado del certificado SSL

La sección de dominios de cada app muestra el estado SSL para cada dominio configurado:

Dos reglas más desde la v1.6.25. Un dominio Activo cuyo certificado desaparece del disco vuelve a Pendiente tras dos comprobaciones consecutivas, nunca por una sola lectura. Y la fecha de expiración del certificado se lee ahora del propio certificado, de modo que las alertas de expiración tienen por fin un valor con el que trabajar.

Solución de problemas

Si tu dominio no funciona o el certificado SSL falla al provisionarse, verifica estos problemas comunes:

# 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"