Saltar al contenido
CloudZH

Documentación / Primeros pasos

Dominio y HTTPS

CloudZH da a cada app su propia dirección HTTPS bajo tu dominio, con un único certificado wildcard.

En esta página, example.com representa tu propio dominio y <server-ip> la dirección del servidor en casa, por ejemplo 192.168.1.200. ¿Sin dominio? Entonces CloudZH funciona en modo LAN, consulta Dominio o red doméstica.

Registros DNS

Crea un registro wildcard que apunte a tu dirección IP pública. Tu dominio raíz y el correo pueden quedarse donde están.

TipoNombreValorProxy
A*tu IP públicaSolo DNS

Tu IP pública: en el servidor, curl -4 -s https://ifconfig.me.

Direcciones que obtienes

DirecciónUso
app.example.comPanel. El instalador pregunta por el subdominio y sugiere dash.
plex.example.comPlex, para apps y amigos fuera de tu casa
sonarr.example.com y otrasApps de administración, detrás del inicio de sesión del panel
vpn.example.comEndpoint de WireGuard. Debe apuntar directamente a tu IP, nunca a través del proxy de Cloudflare.

Tu dominio principal

Sin más configuración, el propio example.com redirige al panel, aunque también puede seguir apuntando a tu web o tu servidor de correo actuales. Para servir en su lugar una web estática desde el servidor, apunta el registro raíz a tu IP y publica una carpeta con un index.html:

zh website deploy /home/<user>/my-site
zh website on
zh website status   # shows whether the DNS records already point here

Entonces www.example.com redirige a example.com, y zh website rollback recupera la versión anterior.

Certificado

Caddy solicita el certificado wildcard mediante la comprobación DNS de Cloudflare (DNS-01), así que no hace falta el puerto 80. Introduce tu token de API cuando el instalador lo pida; zh cloudflare-token lo comprueba y lo sustituye más adelante. System Health muestra cuándo el certificado es válido.

Dentro de tu red doméstica

Desde casa, app.example.com se resuelve a tu IP pública y el tráfico pasa por el router y vuelve. Muchos routers lo gestionan con lentitud. Añade una entrada hosts en tu ordenador para que vaya directamente al servidor:

<server-ip>  app.example.com

Por ejemplo 192.168.1.200 app.example.com. Windows: C:\Windows\System32\drivers\etc\hosts. macOS y Linux: /etc/hosts. El diagnóstico de rendimiento te indica cuándo es tu caso.