Documentación de CloudZH
Todo lo que necesitas para instalar CloudZH, configurar tus apps multimedia, invitar a tus amigos y mantener el servidor en forma.
Qué es CloudZH
CloudZH convierte una máquina Linux en casa (Ubuntu, Debian o Raspberry Pi OS) en un servidor gestionado. Trae un panel web, una App Store con 30+ apps, una biblioteca multimedia para tus amigos, una VPN WireGuard, comprobaciones de salud con reparaciones seguras y el comando zh en el servidor.
Cómo está construido
| Parte | Qué hace |
|---|---|
| Caddy | El único punto de entrada. HTTPS para cada subdominio con un único certificado wildcard. Las apps de administración solo son accesibles tras iniciar sesión en el panel. |
| Panel | La interfaz web. Se ejecuta sin privilegios en un contenedor reforzado. |
| Agente | Un pequeño servicio root con una lista fija de comandos, accesible a través de un socket Unix. Instala apps, ejecuta reparaciones, lee logs. |
| Apps | Docker Compose, una carpeta por app en /opt/cloudzh/apps, datos en /srv/data. |
| Partes nativas | WireGuard y UniFi OS Server se ejecutan fuera de Docker. Solo se instalan con zh en el servidor. |
Qué no incluye CloudZH
Ni medios, ni indexadores, ni clientes de torrent. Tú aportas un proveedor de Usenet e indexadores de tu elección, y usas las apps con contenido que tienes derecho a usar.
Marcadores de posición
Los comandos y direcciones de esta documentación usan marcadores de posición. Sustitúyelos, corchetes angulares incluidos, por tus propios valores.
| Marcador | Significa | Ejemplo |
|---|---|---|
<user> | El usuario de Linux que creaste al instalar Ubuntu | anna |
<server-ip> | La dirección del servidor en tu red doméstica. En el servidor, ip -4 -br addr la muestra en la línea del adaptador de red, antes de la /. Tu router también la muestra entre sus dispositivos. | 192.168.1.200 |
example.com | Tu propio dominio. app.example.com significa app. seguido de tu dominio. | app.example.com |
Así, ssh <user>@<server-ip> se convierte, por ejemplo, en ssh anna@192.168.1.200.