Instalação

Cerca de 15 minutos de um Ubuntu novo até o primeiro login.

1:28CloudZH SetupCole um comando da sua conta de cliente e instale passo a passo no navegador.

<user> é o usuário Linux que você criou ao instalar o Ubuntu, <server-ip> o endereço do servidor na sua rede doméstica, por exemplo 192.168.1.200. No servidor, ip -4 -br addr mostra esse endereço na linha do adaptador de rede. Mais em Marcadores.

CloudZH Setup no navegador

O caminho mais rápido, sem copiar arquivos e sem perguntas no terminal:

1. Copie seu comando

   Na sua conta de cliente, em Minhas licenças → CloudZH Setup, clique em Criar comando e copie. Ele é pessoal, vale 24 horas e serve para no máximo 3 downloads.

2. Cole no servidor

   Por SSH ou direto na tela do servidor. Ele baixa o instalador, confere a soma SHA-256 e inicia o assistente:

   curl -fsSL https://account.cloudzh.app/i/<your-code> | sudo bash

3. Continue no navegador

   Abra o endereço mostrado no terminal num PC, notebook ou celular da mesma rede, por exemplo http://192.168.1.200:8000. O assistente verifica o sistema, pergunta por LAN ou domínio, a pasta de dados e suas chaves de licença, instala com progresso ao vivo e entrega a chave de backup para baixar. Abrir o painel preenche o token de configuração para você.

   Ele só responde a dispositivos da sua rede doméstica, pede o código de acesso do terminal e continua se você fechar a janela SSH. Já copiou o arquivo do instalador? sudo bash install.sh --web inicia o mesmo assistente.

Instalar no terminal

Para especialistas, ou para responder às perguntas na linha de comando.

1. Atualizar o Ubuntu

   sudo apt update && sudo apt full-upgrade -y
   sudo reboot

2. Copiar o instalador para o servidor

   Baixe o instalador na sua conta de cliente em My licenses → Download installer, um arquivo com nome como cloudzh-0.77.5-stable-customer.tar.gz. A página também mostra o checksum SHA-256. Copie-o do seu computador e depois descompacte-o no servidor. <file> é o nome do arquivo do instalador:

   scp <file> <user>@<server-ip>:~
   ssh <user>@<server-ip>
   mkdir -p ~/cloudzh && tar xzf ~/<file> -C ~/cloudzh --strip-components=1
   cd ~/cloudzh

3. Rode o instalador

   sudo bash install.sh

   O instalador pede o seu domínio (deixe vazio para o modo LAN), o token do Cloudflare e a sua chave de licença. Depois confirme o novo servidor no e-mail que lhe enviamos, ou na sua conta de cliente em Licenças; o servidor ativa-se sozinho. Para passar a chave sem perguntas:

   sudo CZH_LICENSE_KEY=CZL-XXXXX-XXXXX-XXXXX-XXXXX bash install.sh

   No final ele mostra o endereço do painel, um token de configuração e, em um servidor novo, onde está a chave de backup. Guarde a chave de backup no seu gerenciador de senhas; sem ela, os backups não podem ser abertos:

   sudo cat /etc/cloudzh/backup.key

4. Entrar e verificar

   Abra o endereço do painel, digite o token de configuração e crie seu administrador. Perdeu o token? zh token mostra de novo. Depois, no servidor:

   zh status
   zh doctor

   Continue com Domínio e HTTPS e Primeiros passos.

O que o instalador configura

• Docker, Caddy, o painel e o agente como serviços systemd
• A árvore de dados em /srv/data (veja Estrutura de dados)
• Fail2Ban e a saudação SSH com um status resumido
• O kit de diagnóstico: teste de velocidade, mtr, iperf3, dig, smartctl, sensors, ethtool, iw, htop, ncdu
• O comando zh para todo usuário com permissões de sudo