Documentação do CloudZH
Tudo o que você precisa para instalar o CloudZH, configurar seus apps de mídia, convidar amigos e manter o servidor saudável.
O que é o CloudZH
O CloudZH transforma uma máquina Linux em casa (Ubuntu, Debian ou Raspberry Pi OS) em um servidor gerenciado. Ele traz um painel web, uma App Store com 30+ apps, uma biblioteca de mídia para seus amigos, uma VPN WireGuard, verificações de saúde com reparos seguros e o comando zh no servidor.
Como ele é construído
| Parte | O que faz |
|---|---|
| Caddy | O único ponto de entrada. HTTPS para cada subdomínio com um único certificado wildcard. Os apps de administração só ficam acessíveis depois do login no painel. |
| Painel | A interface web. Roda sem privilégios em um contêiner reforçado. |
| Agente | Um pequeno serviço root com uma lista fixa de comandos, acessado por um socket Unix. Instala apps, executa reparos, lê logs. |
| Apps | Docker Compose, uma pasta por app em /opt/cloudzh/apps, dados em /srv/data. |
| Partes nativas | O WireGuard e o UniFi OS Server rodam fora do Docker. Eles são instalados com zh, só no servidor. |
O que o CloudZH não inclui
Nada de mídia, indexadores ou clientes de torrent. Você traz um provedor de Usenet e os indexadores que preferir, e usa os apps com conteúdo que você tem direito de usar.
Marcadores
Os comandos e endereços desta documentação usam marcadores. Substitua-os, incluindo os colchetes angulares, pelos seus próprios valores.
| Marcador | Significa | Exemplo |
|---|---|---|
<user> | O usuário Linux que você criou ao instalar o Ubuntu | anna |
<server-ip> | O endereço do servidor na sua rede doméstica. No servidor, ip -4 -br addr mostra esse endereço na linha do adaptador de rede, antes da /. Seu roteador também o lista entre os dispositivos. | 192.168.1.200 |
example.com | Seu próprio domínio. app.example.com significa app. seguido do seu domínio. | app.example.com |
Assim, ssh <user>@<server-ip> vira, por exemplo, ssh anna@192.168.1.200.