Instalación

Unos 15 minutos desde un Ubuntu recién instalado hasta el primer inicio de sesión.

1:28CloudZH SetupPega un comando de tu cuenta de cliente e instala paso a paso en tu navegador.

<user> es el usuario de Linux que creaste al instalar Ubuntu, <server-ip> la dirección del servidor en tu red doméstica, por ejemplo 192.168.1.200. En el servidor, ip -4 -br addr la muestra en la línea del adaptador de red. Más en Marcadores de posición.

CloudZH Setup en el navegador

La forma más rápida, sin copiar archivos ni preguntas en el terminal:

1. Copia tu comando

   En tu cuenta de cliente, en Mis licencias → CloudZH Setup, pulsa Crear comando y cópialo. Es personal, válido 24 horas y sirve para un máximo de 3 descargas.

2. Pégalo en el servidor

   Por SSH o directamente en la pantalla del servidor. Descarga el instalador, comprueba su suma SHA-256 e inicia el asistente:

   curl -fsSL https://account.cloudzh.app/i/<your-code> | sudo bash

3. Sigue en el navegador

   Abre la dirección que muestra el terminal en un PC, portátil o móvil de la misma red, por ejemplo http://192.168.1.200:8000. El asistente revisa el sistema, pregunta por LAN o dominio, la carpeta de datos y tus claves de licencia, instala con progreso en directo y te da la clave de copia para descargar. Ir al panel rellena el token de configuración por ti.

   Solo responde a dispositivos de tu red doméstica, pide el código de acceso del terminal y sigue aunque cierres la ventana SSH. ¿Ya copiaste el archivo del instalador? sudo bash install.sh --web inicia el mismo asistente.

Instalar en el terminal

Para expertos, o para responder las preguntas en la línea de comandos.

1. Actualiza Ubuntu

   sudo apt update && sudo apt full-upgrade -y
   sudo reboot

2. Copia el instalador al servidor

   Descarga el instalador en tu cuenta de cliente en My licenses → Download installer, un archivo con un nombre como cloudzh-0.77.5-stable-customer.tar.gz. La página también muestra su suma de comprobación SHA-256. Cópialo desde tu ordenador y descomprímelo en el servidor. <file> es el nombre del archivo del instalador:

   scp <file> <user>@<server-ip>:~
   ssh <user>@<server-ip>
   mkdir -p ~/cloudzh && tar xzf ~/<file> -C ~/cloudzh --strip-components=1
   cd ~/cloudzh

3. Ejecuta el instalador

   sudo bash install.sh

   El instalador pide tu dominio (déjalo vacío para el modo LAN), el token de Cloudflare y tu clave de licencia. Después confirma el nuevo servidor en el correo que te enviamos, o en tu cuenta de cliente en Licencias; el servidor se activa solo. Para pasar la clave sin preguntas:

   sudo CZH_LICENSE_KEY=CZL-XXXXX-XXXXX-XXXXX-XXXXX bash install.sh

   Al final muestra la dirección del panel, un token de configuración y, en un servidor nuevo, dónde está la clave de copia de seguridad. Guarda la clave de copia de seguridad en tu gestor de contraseñas; sin ella, las copias no se pueden abrir:

   sudo cat /etc/cloudzh/backup.key

4. Inicia sesión y comprueba

   Abre la dirección del panel, introduce el token de configuración y crea tu administrador. ¿Has perdido el token? zh token lo vuelve a mostrar. Después, en el servidor:

   zh status
   zh doctor

   Continúa con Dominio y HTTPS y Primeros pasos.

Qué configura el instalador

• Docker, Caddy, el panel y el agente como servicios systemd
• El árbol de datos en /srv/data (consulta Estructura de datos)
• Fail2Ban y el saludo SSH con un breve estado
• El kit de diagnóstico: test de velocidad, mtr, iperf3, dig, smartctl, sensors, ethtool, iw, htop, ncdu
• El comando zh para cada usuario con permisos sudo