Pular para o conteúdo
CloudZH

Docs / Primeiros passos

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 sudo e 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.