Pular para o conteúdo
CloudZH

Docs / Usando o CloudZH

Homelab

Apps para o seu servidor e a sua rede doméstica, do controlador UniFi ao Home Assistant. A maioria instala com um clique, como qualquer app da App Store.

Instalável ou guia

Cada item instalável em Apps → Homelab é um template revisado da App Store. Instalar configura o que o CloudZH consegue automatizar, e o cartão do app lista os Próximos passos que ficam para você, como criar a conta de admin ou parear dispositivos. Software que não roda como contêiner no CloudZH, como Ubiquiti UISP, Grandstream GWN Manager e OpenWISP, ganha um guia passo a passo, normalmente para um servidor pequeno separado.

Encontrar apps

As categorias são as mesmas da App Store, com os apps ★ recomendados primeiro. O filtro Instalável / Guia reduz a lista, e em Rede e dispositivos um filtro por fabricante mostra os apps para o seu hardware.

ÁreaPor exemplo
Rede e dispositivosUniFi Network Application, TP-Link Omada, AdGuard Home, NetAlertX, UpSnap
Câmeras e casa inteligenteHome Assistant, Zigbee2MQTT, Z-Wave JS UI, Scrypted, Frigate, Node-RED
Sistema e monitoramentoScrutiny, Healthchecks, Beszel, SmokePing
Acesso externoApache Guacamole, RustDesk Server, MeshCentral
Dia a dia, arquivos e nuvemNextcloud, Stirling PDF, PairDrop, Rallly, Mealie, Actual Budget, Homebox, Karakeep, FreshRSS, Mumble, Spliit
IA local e jogosOllama, Open WebUI, Pelican Panel

Um controlador por fabricante

Controladores de rede do mesmo fabricante se excluem: instale o UniFi Network Application ou o UniFi OS Server, nunca os dois. O CloudZH avisa antes da instalação se o outro já estiver lá.

Adaptadores USB e dispositivos

Zigbee2MQTT e Z-Wave JS UI precisam de um adaptador USB. A janela de instalação lista os adaptadores que encontra pelo nome fixo. Se não houver nenhum, ela diz o que fazer, por exemplo Conecte seu adaptador Zigbee e selecione-o aqui. O Scrutiny lê os valores S.M.A.R.T. de todos os seus discos.

Rede do host e portas fixas

Alguns apps precisam da rede do próprio servidor ou de portas fixas, por exemplo para que os dispositivos UniFi encontrem o controlador. O CloudZH verifica essas portas antes da instalação e diz qual app ou serviço já usa alguma delas.

Memória e processador

Cada app tem uma estimativa de memória, para que o CloudZH possa avisar antes de o servidor ficar sem. Apps publicados só para alguns processadores mostram uma mensagem clara antes da instalação em vez de falhar no meio, por exemplo num Raspberry Pi.

AdGuard Home e a porta 53

O AdGuard Home bloqueia anúncios e rastreadores para todos os dispositivos da casa, como servidor DNS da sua rede. Ele precisa da porta 53, que o systemd-resolved ocupa no Ubuntu e no Debian. Só se você marcar Liberar a porta 53 na janela de instalação o CloudZH desliga o stub DNS do systemd-resolved, e remover o AdGuard Home o liga de novo. O servidor continua resolvendo nomes o tempo todo.

O AdGuard Home começa com o Quad9 como upstream e o filtro AdGuard DNS, ambos alteráveis. Nada muda na sua rede até você definir o servidor como servidor DNS no roteador. Nunca encaminhe a porta 53 para a internet.

Deixados de fora de propósito

TipoPor quê
PainéisO painel do CloudZH já mostra cada app com link, status e login.
Gerenciamento de DockerAcesso total ao Docker equivale a acesso root ao servidor e contornaria a verificação de segurança de cada app.
Proxies reversosO Caddy já cuida de domínios, certificados e do login.
Interfaces de WireGuardO CloudZH tem sua própria VPN WireGuard.
Servidores de e-mailConexões domésticas não conseguem enviar e-mail de forma confiável, e um servidor de e-mail exige cuidado constante.