Saltar al contenido
CloudZH

Documentación / Primeros pasos

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 sudo y 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.