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.
| Área | Por exemplo |
|---|---|
| Rede e dispositivos | UniFi Network Application, TP-Link Omada, AdGuard Home, NetAlertX, UpSnap |
| Câmeras e casa inteligente | Home Assistant, Zigbee2MQTT, Z-Wave JS UI, Scrypted, Frigate, Node-RED |
| Sistema e monitoramento | Scrutiny, Healthchecks, Beszel, SmokePing |
| Acesso externo | Apache Guacamole, RustDesk Server, MeshCentral |
| Dia a dia, arquivos e nuvem | Nextcloud, Stirling PDF, PairDrop, Rallly, Mealie, Actual Budget, Homebox, Karakeep, FreshRSS, Mumble, Spliit |
| IA local e jogos | Ollama, 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
| Tipo | Por quê |
|---|---|
| Painéis | O painel do CloudZH já mostra cada app com link, status e login. |
| Gerenciamento de Docker | Acesso total ao Docker equivale a acesso root ao servidor e contornaria a verificação de segurança de cada app. |
| Proxies reversos | O Caddy já cuida de domínios, certificados e do login. |
| Interfaces de WireGuard | O CloudZH tem sua própria VPN WireGuard. |
| Servidores de e-mail | Conexões domésticas não conseguem enviar e-mail de forma confiável, e um servidor de e-mail exige cuidado constante. |