Pular para o conteúdo principal
Versão: 0.4 · atual

Instalar o Excubius

Visão geralRevisado em 11 de outubro de 2026
Aplica-se a:Excubius 0.4Funções: Instalador (administrador do Linux)
PlanosFree · Core · Pro · EnterpriseImplantaçãoAuto-hospedado

O Excubius é executado em um servidor Linux que você controla, na sua assinatura de nuvem ou no seu datacenter. O instalador interativo verifica o servidor, faz uma lista curta de perguntas, instala os contêineres e obtém o certificado. Este artigo lista o que você precisa, o que o instalador pergunta e faz e aonde ir para cada tarefa seguinte.

Antes de começar​

ItemRequisito
ServidorRocky Linux 9 ou 10 (ou outro sistema da família RHEL), x86-64, systemd. Pelo menos 2 vCPUs, 4 GiB de memória e 20 GiB de disco livre; no Azure, Standard_B2ms (2 vCPUs, 8 GiB) é um bom começo e pode ser redimensionado depois. Se a sua equipe de nuvem cria os servidores, consulte Solicitar o servidor do Azure
AcessoUma conta com sudo no servidor, acessível por SSH a partir da sua estação de trabalho
Rede para os usuáriosPortas 80 e 443 livres no servidor e abertas a partir de onde as pessoas usarão o Excubius
SaídaHTTPS para ghcr.io e docker.io para baixar as imagens, a menos que você use o pacote offline
Rede para o que você monitoraA partir do servidor, a porta SQL de cada instância, réplica e IP de ouvinte (e UDP 1434 para instâncias nomeadas sem porta fixa), além de HTTPS para os endpoints web que você testa. Nada se conecta ao coletor
Pacote do instaladorexcubius-installer-<version>.tar.gz ou o pacote offline com as imagens incluídas. Usuários conectados obtêm os dois em Downloads
EntradaUm registro de aplicativo do Microsoft Entra ID, um cliente OAuth do Google ou ambos. Consulte Configurar provedores de entrada
Logons de monitoramentoLogons somente leitura para o que você vai monitorar, por exemplo o logon do SQL Server em Pré-requisitos para grupos de disponibilidade
CertificadoPara o Let's Encrypt, um nome DNS público que aponte para o servidor ou acesso por API à zona DNS dele. Não é necessário para um certificado próprio, um autoassinado ou um gateway que encerra o TLS

Como a instalação funciona​

As verificações prévias abrangem o sistema operacional e a versão dele, a arquitetura, o systemd e o dnf, a memória, as CPUs, o disco, as portas 80 e 443 livres, o SELinux, o acesso aos registros ou ao arquivo de imagens e a sincronização do relógio.

O servidor recebe o pacote da versão, um arquivo de configuração e as imagens de contêiner. Ele nunca recebe código-fonte e nunca acessa um repositório de código.

Instalar​

  1. Copie o pacote do instalador para o servidor e descompacte-o:

    tar -xzf excubius-installer-0.4.0.tar.gz
    cd excubius-installer-0.4.0
  2. Se quiser, execute apenas as verificações prévias. Elas não alteram nada:

    sudo ./install.sh --check-only
  3. Execute o instalador e responda às perguntas. Pressione Enter para aceitar o valor entre colchetes:

    sudo ./install.sh

    O instalador guarda as suas respostas, com controle de versão, para que uma atualização pergunte apenas o que é novo naquela versão.

  4. Ao terminar, abra o endereço público que ele exibe e entre como o administrador que você definiu durante a instalação. Em seguida, configure a entrada e convide as pessoas que usarão o Excubius.

Tudo o que o instalador faz é registrado em /var/log/excubius-install.log, sem segredos.

As perguntas do instalador​

PerguntaPadrãoObservações
Diretório de instalação/opt/excubiusQualquer caminho absoluto
Conta de serviçoexcubiusÉ criada se não existir. Executa os contêineres sem privilégios de root
URL públicahttps://monitoring.example.comO endereço que as pessoas vão abrir. O host dele é o nome principal do servidor
AliasesNenhumOutros nomes que as pessoas podem abrir, separados por espaços, por exemplo um alias em um domínio que você controla
TLSletsencryptletsencrypt (por HTTP), letsencrypt-dns (por DNS), selfsigned, custom (seus arquivos PEM), gateway (o TLS termina na frente) ou later (HTTP simples por enquanto)
Nomes no certificadoallPerguntado quando há aliases: deixe de fora os nomes que um certificado não pode cobrir
E-mail para o Let's Encrypt—Nos dois modos do Let's Encrypt
Provedor de DNS e credenciais—Somente letsencrypt-dns: o id dnsapi do acme.sh, como dns_cf, dns_dreamhost ou dns_azure, e as variáveis dele, digitadas uma a uma sem eco
Arquivos de certificado e chave—Somente custom: a cadeia PEM, com o certificado do servidor primeiro, e uma chave não criptografada
Nome de usuário e senha do administradorUm nome de usuário sugeridoA conta para a primeira entrada, no endereço que o instalador exibe ao terminar. A senha precisa ter 12 caracteres ou mais e é pedida duas vezes
Predefinição baseenterpriseenterprise, databases ou core; consulte Configurar a instância
Usuário e token do registro—Fornecidos a você com a licença. Não são perguntados com o pacote offline
Token do bot e canal do Slack— e #alertsOpcional; você pode defini-los depois. Consulte Configurar notificações do Slack
ID do locatário, ID do cliente e segredo do Entra ID—Opcional; você pode defini-los depois

Com um modo do Let's Encrypt, o instalador verifica em seguida os nomes no DNS público e, por HTTP, se eles apontam para este servidor. Quando não apontam, ele explica as alternativas; ele nunca para por causa disso.

O instalador gera uma única vez a senha do banco de dados, o segredo de assinatura de sessão, a chave que criptografa os segredos armazenados e o token do coletor, e nunca os pede. Depois que a plataforma armazena a senha do administrador, as credenciais de DNS e uma chave privada, ele as remove do arquivo de configuração.

Para instalar sem perguntas, passe as respostas em um arquivo com --answers; consulte a referência do instalador.

Nomes e TLS​

ModoUse quando
Let's Encrypt, validação por HTTPO nome é resolvido publicamente para o servidor e a porta 80 está acessível pela internet
Let's Encrypt, validação por DNSO servidor é privado, mas você pode criar registros DNS por meio de uma API
Seu próprio certificadoA sua organização emite certificados
AutoassinadoUm laboratório ou um primeiro teste
GatewayUm balanceador de carga ou proxy reverso na frente encerra o TLS
HTTP simplesUm primeiro teste ou uma rede em que você confia totalmente

Você pode alterar os nomes e o certificado depois em Settings (Configurações) sem reinstalar, e a renovação é automática. Consulte Configurar nomes e TLS.

Atualizar, reinstalar ou desinstalar​

ComandoO que faz
sudo ./install.sh em um servidor instaladoOferece Upgrade (mantém os dados e faz apenas as perguntas novas), Reinstall, Purge and install fresh ou Cancel
sudo ./install.sh --uninstallFaz um último backup do banco de dados e depois remove os serviços e as imagens. Mantém os dados, os backups e a configuração
sudo ./install.sh --uninstall --purgeTambém exclui os dados, os backups e a conta de serviço. Pede que você digite purge
aviso

Atualize em uma janela de mudança. Os serviços são reiniciados por alguns segundos e as migrações do banco de dados são executadas. Leia os problemas conhecidos da versão antes de começar.

--dry-run funciona com todos os comandos e apenas exibe o que aconteceria. As etapas para atualizar, reverter, fazer backup e restaurar estão em Atualizar, fazer backup e restaurar, para usuários conectados.

Monitorar o Excubius de fora​

O Excubius não deve ser o único a monitorar a si mesmo. Registre https://<your server>/heartbeat em um monitor externo, como um teste de disponibilidade do Azure Monitor, um Uptime Kuma executado em outro lugar ou um serviço no estilo healthchecks, e configure-o para alertar você quando o endereço parar de responder ok. Se o servidor parar, é esse monitor que avisa você.

/heartbeat e /healthz respondem por HTTP simples em todos os modos de TLS. /healthz também retorna a versão em execução.

Próximas etapas​