Requisitos
Lo que necesitan la máquina, tu red y tu dominio antes de ejecutar el instalador.
Servidor
- Sistema operativo: Ubuntu Server 24.04 LTS, Intel o AMD de 64 bits (x86-64). Parte de una instalación limpia.
- Procesador y memoria: al menos 4 núcleos y 8 GB, 16 GB si también se ejecuta UniFi OS Server. Prevé más para Immich, Tdarr o muchos usuarios reproduciendo a la vez.
- Discos: un SSD para el sistema y un disco aparte o NVMe para tus medios, montado en
/srv/data. - Acceso: un usuario con permisos
sudoy SSH.
Red
- Conecta el servidor por cable. El Wi-Fi funciona, pero las descargas, Plex y la VPN se resienten, y un controlador UniFi nunca debe depender de su propio punto de acceso.
- Dale al servidor una dirección fija en tu router (reserva DHCP), por ejemplo
192.168.1.200. La documentación la llama<server-ip>, consulta Prepara el servidor. - Con un dominio, redirige TCP 443 de tu router al servidor. Para la VPN, también UDP 51820.
- El acceso desde fuera requiere una dirección IPv4 pública propia. Muchas líneas de cable y fibra, Starlink y los routers LTE/5G comparten una dirección entre clientes (CGNAT, DS-Lite) y ahí el reenvío de puertos no tiene efecto. El instalador lo comprueba, consulta Accesibilidad, CGNAT y DynDNS.
Dominio
Opcional. Sin dominio, CloudZH funciona en modo LAN, solo en tu red doméstica. Consulta Dominio o red doméstica.
- Un dominio cuya zona DNS gestione Cloudflare.
- Un token de API de Cloudflare con el permiso Zone · DNS · Edit para esta zona. No uses la Global API Key.
Licencia
- Tu clave de licencia (
CZL-XXXXX-XXXXX-XXXXX-XXXXX) de tu correo de licencia. Un servidor nuevo se confirma por correo, o usa CloudZH Setup desde tu cuenta de cliente, que no necesita confirmación.
Cuentas opcionales
- Una cuenta de Plex, un proveedor de Usenet y al menos un indexador de Usenet.
- Una clave API de un proveedor de IA si quieres usar el asistente.