Requisitos
O que a máquina, sua rede e seu domínio precisam antes de você rodar o instalador.
Servidor
- Sistema operacional: Ubuntu Server 24.04 LTS, 64 bits Intel ou AMD (x86-64). Comece com uma instalação nova.
- Processador e memória: pelo menos 4 núcleos e 8 GB, 16 GB se o UniFi OS Server também rodar. Planeje mais para Immich, Tdarr ou muitos usuários transmitindo ao mesmo tempo.
- Discos: um SSD para o sistema e um disco ou NVMe separado para a sua mídia, montado em
/srv/data. - Acesso: um usuário com permissões de
sudoe SSH.
Rede
- Conecte o servidor por cabo. O Wi-Fi funciona, mas downloads, Plex e VPN sofrem, e um controlador UniFi nunca deve depender do próprio ponto de acesso.
- Dê ao servidor um endereço fixo no seu roteador (reserva DHCP), por exemplo
192.168.1.200. A documentação o chama de<server-ip>, veja Prepare o servidor. - Com um domínio, encaminhe a porta TCP 443 do roteador para o servidor. Para a VPN, também a UDP 51820.
- O acesso de fora exige um endereço IPv4 público próprio. Muitas linhas de cabo e fibra, Starlink e roteadores LTE/5G compartilham um endereço entre clientes (CGNAT, DS-Lite), e o redirecionamento de portas não tem efeito. O instalador verifica isso, veja Acessibilidade, CGNAT e DynDNS.
Domínio
Opcional. Sem domínio, o CloudZH roda no modo LAN, só na sua rede doméstica. Veja Domínio ou rede doméstica.
- Um domínio cuja zona DNS é gerenciada pela Cloudflare.
- Um token de API da Cloudflare com a permissão Zone · DNS · Edit para essa zona. Não use a Global API Key.
Licença
- A sua chave de licença (
CZL-XXXXX-XXXXX-XXXXX-XXXXX) do seu e-mail de licença. Um servidor novo confirma-se por e-mail, ou usa o CloudZH Setup da sua conta de cliente, que não precisa de confirmação.
Contas opcionais
- Uma conta Plex, um provedor de Usenet e pelo menos um indexador de Usenet.
- Uma chave de API de um provedor de IA, se você quiser usar o assistente.