...

AKR Updater

1.7.3

...

💻 Comando de instalação
curl -fsSL https://dl.akra13.fr/AKRUpdaterInstaller | sudo bash

Este guia prático detalha passo a passo a utilização do software, desde a descoberta da interface web até à criação das suas primeiras tarefas agendadas. Aprenderá também a ligar a sua conta Discord para controlar os seus reinícios remotamente.

Antes de iniciar a implementação da aplicação, descubra os passos a seguir para configurar rapidamente o seu hospedeiro corretamente. Todo o procedimento baseia-se num comando shell único executado no seu terminal Linux.

Instalação

1

Preparação do ambiente Linux

Inicie um sistema Linux ou crie um contentor LXC dedicado e limpo para alojar o serviço. Certifique-se de que dispõe de acesso ao terminal com privilégios de administração sudo e de uma ligação de rede ativa para transferir os ficheiros necessários.

2

Execução do comando de instalação

Abra o seu terminal e cole o seguinte comando exato: curl -fsSL https://dl.akra13.fr/AKRUpdaterInstaller | sudo bash. Valide a execução para iniciar o script oficial de instalação automatizada.

3

Aguardar pela configuração automática

Deixe o processo de instalação implementar os ficheiros e configurar os serviços de segundo plano. O script executa-se de forma autónoma em poucos segundos para preparar os componentes necessários ao funcionamento do sistema.

4

Verificação das portas de rede

Controle se a porta TCP 8080 está acessível a partir da sua rede local ou autorize-a nas suas regras de firewall aplicacionais. Esta porta é indispensável para comunicar com a interface gráfica de administração alojada pelo software.

5

Acesso ao painel de administração web

Inicie o seu navegador web e dirija-se ao endereço IP do seu servidor seguido da porta 8080 (por exemplo http://IP_SERVIDOR:8080). Acederá ao ecrã inicial do painel dedicado à gestão dos seus servidores.

6

Adição do primeiro servidor remoto

A partir do painel web, registe a sua primeira máquina alvo introduzindo o seu endereço e as credenciais necessárias para a ligação inicial. O sistema gerará a chave SSH encriptada, selando o acesso seguro para futuras operações de manutenção.

Guia de uso

Navegação no painel de administração web

O dashboard acessível na porta 8080 centraliza o estado de todas as suas máquinas registadas. Pode observar o estado global do seu parque, verificar as últimas operações executadas e percorrer o histórico completo das ações. Este espaço constitui o ponto fulcral para orquestrar as suas intervenções técnicas sem abrir múltiplas sessões SSH.

Agendamento de tarefas e trim SSD

A partir da secção de agendamento, defina a frequência com que os seus pacotes de sistema devem ser inspecionados e atualizados. Pode também integrar a otimização trim SSD para manter um bom desempenho nos seus suportes de armazenamento flash. Uma vez registada, a rotina executa-se automaticamente em segundo plano de acordo com o calendário estabelecido.

Configuração de alertas e bot Discord

Para assegurar um acompanhamento remoto, parametrize os seus canais de alerta introduzindo um webhook Discord ou ativando o bot integrado. Em modo bot, receberá painéis detalhados após cada execução de tarefa. Estas notificações enriquecidas integram botões de interação que permitem reiniciar uma máquina ou programar o seu reinício com um simples clique.

Administração de instâncias NetBird

Se a sua infraestrutura se baseia em NetBird, o software suporta a gestão das versões dos seus componentes. Pode aplicar atualizações tanto no cliente como na infraestrutura NetBird SelfHosted diretamente através da ferramenta. Esta integração nativa assegura a coerência das versões da sua rede sobreposta sem manipulação manual complexa.

Monitorização de logs e rastreabilidade

Consulte regularmente o histórico de operações na interface para auditar as ações realizadas nas suas máquinas. Em caso de anomalia num serviço após uma atualização, o log permite-lhe verificar precisamente que pacotes foram processados e em que momento. Esta visibilidade facilita a análise e a manutenção preventiva dos seus ambientes.

Estas dicas de utilização foram formuladas para o ajudar a tirar o melhor partido do seu painel de controlo e a otimizar a segurança do seu parque. Coloque em prática estas recomendações para preservar a estabilidade dos seus ambientes Linux.

Dicas

Privilegie um contentor LXC dedicado

Instale a ferramenta dentro de uma instância LXC virgem para isolar a administração dos seus servidores das suas cargas aplicacionais correntes. Isto simplifica as cópias de segurança globais e preserva a integridade do seu servidor de supervisão.

Agende fora das horas de pico

Programe os seus ciclos de atualização e trim SSD durante os períodos de menor atividade noturna. Evitará assim qualquer lentidão de disco imprevista ou qualquer indisponibilidade passageira para os seus utilizadores.

Explore os botões de ação Discord

Configure o modo bot Discord em vez de um webhook passivo para beneficiar dos botões interativos de reinício. Isto permite-lhe validar um reinício do sistema a partir do seu telemóvel sem ter de se ligar ao dashboard.

Monitorize os pacotes do kernel

Esteja atento às notificações que sinalizam uma atualização do kernel Linux. Agende então um reinício rápido do hospedeiro para carregar a nova versão segura sem deixar a máquina num estado intermédio.

Verifique as suas chaves SSH registadas

Uma vez que a ferramenta encripta automaticamente as chaves SSH geradas, tenha cuidado para não alterar manualmente as permissões dos diretórios de chaves nos alvos. Deixe a ferramenta gerir os seus acessos para evitar qualquer rutura de comunicação.

Centralize os seus nós NetBird

Agrupe a supervisão dos seus clientes NetBird e do seu servidor SelfHosted no mesmo dashboard. Isto garante uma homogeneidade perfeita dos protocolos e limita os riscos de incompatibilidade entre versões da rede.

Consulte o histórico antes de qualquer alteração importante

Antes de instalar uma nova aplicação pesada num servidor remoto, verifique no histórico se a última manutenção foi concluída sem erros. Desta forma, parte de uma base de software perfeitamente saudável e atualizada.

Verifique a conectividade da porta 8080

Se gere as suas máquinas através de uma rede remota, considere colocar o painel web atrás de um túnel seguro ou filtrar rigorosamente os endereços IP autorizados a aceder à porta 8080.

Em caso de imprevistos ao aceder ao painel web ou na comunicação com uma máquina remota, consulte esta rubrica de resolução de problemas. Reúne soluções concretas para os bloqueios técnicos mais frequentemente encontrados.

Resolução de problemas

⚠️ A interface web na porta 8080 recusa-se a carregar após a instalação
Verifique se o serviço está ativo na sua máquina hospedeira consultando os processos em curso no terminal. Certifique-se de que a firewall local não interceta as ligações na porta 8080 e controle se o endereço IP utilizado é alcançável a partir do seu posto.
⚠️ Falha de ligação ao adicionar uma nova máquina alvo
Controle se o servidor remoto é alcançável em rede e se o serviço SSH funciona lá corretamente. Verifique se as credenciais de administrador temporárias introduzidas estão exatas para que o software possa implementar a sua chave encriptada inicial.
⚠️ Os alertas Discord não chegam ao servidor de discussão
Inspecione o URL do webhook ou o token do bot Discord configurado nas definições do painel. Certifique-se de que a sala de chat visada concede permissões de escrita e envio de mensagens enriquecidas (embeds) ao bot.
⚠️ Os botões interativos Discord não desencadeiam o reinício
Certifique-se de que utiliza o modo bot Discord e não um simples webhook, uma vez que este último não permite a interatividade. Verifique também se a comunicação de saída a partir do seu hospedeiro para a API Discord não está bloqueada.
⚠️ A operação de trim SSD falha num servidor específico
Verifique se o armazenamento da máquina alvo se baseia num suporte SSD compatível com o comando fstrim. No caso de uma máquina virtual ou de um contentor, a opção de emulação SSD ou o acesso aos comandos de discard deve estar ativado no hipervisor.
⚠️ A atualização do NetBird SelfHosted não progride
Consulte os logs de histórico na interface web para detetar eventuais conflitos de pacotes ou de contentores. Certifique-se de que a instância NetBird dispõe de espaço em disco suficiente para transferir e descompactar os novos binários.
⚠️ Interrupção do comando curl durante a instalação inicial
Verifique a estabilidade da sua ligação à internet e certifique-se de que os pacotes curl e sudo estão instalados no seu sistema base. Relance depois o comando curl -fsSL https://dl.akra13.fr/AKRUpdaterInstaller | sudo bash no seu terminal.
⚠️ O reinício agendado não foi executado à hora prevista
Controle a sincronização horária (fuso horário e serviço NTP) entre o servidor que executa o Updater e a máquina remota. Uma divergência de relógio pode adiar a execução das programações agendadas.

Tome conhecimento dos pré-requisitos materiais e de sistema indispensáveis para assegurar um funcionamento ótimo do painel web e das suas tarefas de segundo plano. Concebida para ser muito económica, a ferramenta adapta-se a configurações materiais modestas.

Requisitos

Mínimo

SODistribuição Linux moderna (recomendado em contentor LXC novo)
CPUProcessador 1 núcleo 64 bits
RAM512 MB de memória RAM
Armazenamento1 GB de espaço livre
RedeAcesso à Internet para transferência e repositórios de pacotes

Recomendado

SODistribuição Linux moderna em contentor LXC dedicado
CPUProcessador 2 núcleos
RAM1 GB de memória RAM ou mais
Armazenamento5 GB de espaço livre para históricos e logs
RedeLigação de alta velocidade e porta 8080 aberta na rede local