...

AKR Updater

1.7.0

...

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

Este guia de utilização completo acompanha-o na aprendizagem do AKR Updater e de todas as suas funcionalidades de manutenção. Nele, irá aprender a navegar no painel web dedicado, a planear as suas atualizações do sistema, bem como a manutenção do SSD. Este documento também detalha a gestão de chaves SSH encriptadas, o suporte NetBird e a interação com o Bot Discord. Siga estas secções práticas para otimizar a gestão da sua infraestrutura Linux.

A instalação do AKR Updater foi concebida para ser a mais rápida e simples possível em sistemas Linux. Através de um único comando Curl a executar no seu terminal, a ferramenta é instalada numa fração de segundo, idealmente num contentor LXC novo. Antes de começar, certifique-se de que dispõe de acesso ao terminal e de uma ligação à Internet. Siga este guia passo a passo para configurar o seu servidor e aceder ao painel web na porta 8080.

Instalação

1

Preparação do terminal Linux

Abra uma sessão de terminal no seu servidor Linux ou ligue-se remotamente através de SSH. Certifique-se de que tem acesso a um ambiente Linux moderno e limpo, idealmente um contentor LXC novo. Verifique se a ferramenta curl está disponível no seu sistema para poder descarregar o script de instalação.

2

Execução do comando de instalação única

Copie e cole o comando de instalação oficial no seu terminal: curl -fsSL https://dl.akra13.fr/AKRUpdaterInstaller | sudo bash. Este comando descarrega o script de instalação de forma segura e executa-o diretamente com os privilégios necessários. Não altere a URL nem os parâmetros desta linha de comando.

3

Transferência e configuração automática

O script de instalação configura automaticamente as dependências e prepara os ficheiros do AKR Updater numa fração de segundo. A ferramenta instala os componentes necessários para o serviço web e a gestão de tarefas. Não é necessária qualquer intervenção manual durante esta fase.

4

Acesso ao painel de administração na Web

Assim que o script estiver concluído, abra o seu navegador de Internet habitual num computador. Introduza o endereço IP do seu servidor seguido da porta dedicada 8080 (por exemplo, http://192.168.1.100:8080). A interface web intuitiva do AKR Updater será então apresentada no ecrã.

5

Configuração inicial dos nomes de utilizador e chaves SSH

Introduza os seus dados de acesso na primeira vez que iniciar sessão para configurar o sistema. O AKR Updater irá gerar e encriptar automaticamente uma chave SSH dedicada para proteger as comunicações. Nenhuma palavra-passe é armazenada em texto simples no servidor, garantindo um elevado nível de segurança.

6

Ligação dos serviços de notificação (Discord / Webhook)

Aceda à secção de definições do painel web para associar o seu Webhook ou o seu Bot Discord. Configure os alertas para receber os embeds interativos e os botões de ação rápida. A sua instalação do AKR Updater v1.7.0 está agora totalmente operacional e pronta para gerir as suas máquinas.

Guia de uso

Introdução ao painel de administração web na porta 8080

O painel web do AKR Updater constitui o núcleo da sua gestão centralizada. Acessíveis através da porta 8080, os seus diversos menus oferecem-lhe um controlo visual e intuitivo sobre todo o seu parque de sistemas Linux. Aí, pode adicionar novas máquinas, consultar o seu estado em tempo real e consultar o histórico detalhado de cada operação realizada.

Automatização das atualizações do sistema e da manutenção do SSD

A interface permite-lhe definir regras de planeamento personalizadas para os seus servidores. Pode programar a atualização regular dos pacotes, bem como a execução do comando «trim SSD» para preservar os seus discos. A ferramenta executa estas tarefas em segundo plano, sem necessidade de intervenção manual repetitiva.

Atualização centralizada dos componentes do NetBird

O AKR Updater suporta a manutenção de arquiteturas de rede privada baseadas no NetBird. A partir da interface web, pode monitorizar e iniciar as atualizações dos clientes NetBird, bem como da versão NetBird SelfHosted. Isto garante que a sua infraestrutura de rede se mantém sempre atualizada e totalmente segura.

Como utilizar o bot do Discord e os botões de ação interativos

Ao associar a ferramenta a um bot do Discord, transforma os seus alertas num centro de comando remoto. Quando há pacotes que exigem o reinício da máquina, o bot envia uma mensagem enriquecida na forma de um embed. Basta interagir com os botões integrados na mensagem para executar um reinício imediato ou agendá-lo para mais tarde.

Proteção dos acessos através da encriptação automática das chaves SSH

A arquitetura do AKR Updater elimina os riscos associados ao armazenamento de palavras-passe em texto simples. Aquando da introdução inicial dos seus dados de acesso, a aplicação gera uma chave SSH dedicada que é imediatamente encriptada. Apenas a aplicação tem autorização para utilizar esta chave segura para interagir com os seus servidores remotos.

Descubra uma seleção de conselhos e boas práticas para tirar o máximo partido do AKR Updater nos seus servidores Linux. Estas dicas irão ajudá-lo a otimizar a implementação em contentores LXC e a reforçar a segurança dos seus acessos. Irá também aprender a tirar o máximo partido das funcionalidades interativas do Bot Discord e da programação da limpeza do SSD. Aplique estas recomendações para manter um parque informático estável e com bom desempenho.

Dicas

Opte por uma instalação num contentor LXC

Para obter o melhor desempenho, implemente o AKR Updater num contentor LXC novo e dedicado. A sua natureza leve permite uma execução rápida sem desperdiçar os recursos do seu anfitrião.

Utilize o modo Bot do Discord em vez de um simples Webhook

Configure um bot do Discord em vez de um simples webhook para poder tirar partido dos botões interativos. Isto permitir-lhe-á gerir os reinícios das máquinas diretamente a partir da sua aplicação do Discord.

Programe a limpeza do SSD para os horários de menor movimento

Programe a tarefa de «trim» do SSD para momentos de baixa atividade nos seus servidores. Embora seja rápida, esta operação de manutenção dos discos deve ser executada durante a noite.

Consulte regularmente o histórico na porta 8080

Adquira o hábito de verificar o separador «Histórico» no painel web. Isto dá-lhe uma visão geral precisa dos pacotes atualizados e permite-lhe acompanhar a evolução dos seus servidores.

Centralize a gestão das suas instâncias do NetBird

Aproveite a integração do NetBird SelfHosted com o AKR Updater para sincronizar as versões dos clientes e dos servidores. Desta forma, evitará quaisquer problemas de compatibilidade de rede após uma atualização.

Verifique as regras do firewall para a porta 8080

Certifique-se de que a porta 8080 está devidamente aberta na sua rede local para aceder à interface web. Pode restringir esse acesso apenas aos endereços IP da sua sub-rede de administração.

Aproveite o pedido de instalação rápida

Não perca tempo a compilar ou a descarregar pacotes manualmente. Utilize apenas o comando oficial «curl» para garantir uma implementação sem problemas num segundo.

Planifique os reinícios após a atualização

Caso ocorra uma atualização do kernel do Linux, utilize o botão de agendamento do Discord para adiar o reinício do servidor para um momento em que nenhum utilizador esteja ligado.

Esta secção de resolução de problemas foi concebida para o ajudar a resolver rapidamente quaisquer dificuldades que possam surgir durante a utilização do AKR Updater. Quer esteja a enfrentar um problema de acesso à porta 8080, um erro ao executar o comando Curl ou uma falha nas notificações do Discord, são apresentadas soluções concretas. Cada caso apresenta instruções passo a passo para restabelecer o bom funcionamento da sua ferramenta. Identifique o seu problema e siga o método recomendado.

Resolução de problemas

⚠️ Não é possível aceder à interface web na porta 8080
Verifique, em primeiro lugar, se o serviço AKR Updater está efetivamente a ser executado no seu terminal. Verifique também a firewall da sua distribuição Linux para se certificar de que a porta 8080 permite o tráfego de entrada. Introduza novamente o endereço IP exato, seguido da porta 8080, no seu navegador da Web.
⚠️ Erro ao executar o comando de instalação do Curl
Certifique-se de que o pacote curl está devidamente instalado no seu servidor Linux. Volte a executar cuidadosamente o comando exato: curl -fsSL https://dl.akra13.fr/AKRUpdaterInstaller | sudo bash. Verifique também se o seu servidor dispõe de uma ligação à Internet ativa para descarregar o script.
⚠️ O bot do Discord não responde nem envia notificações
Verifique as credenciais e o token do Bot do Discord introduzidos no painel web do AKR Updater. Certifique-se de que o Bot dispõe das permissões necessárias para escrever mensagens e integrar botões no canal de destino. Teste a configuração enviando uma notificação de teste a partir da interface.
⚠️ Os botões de reinício no Discord não funcionam
Verifique se o servidor onde está a ser executado o AKR Updater continua online e ligado à Internet. O bot do Discord necessita de uma ligação ativa com o painel web para transmitir os comandos de reinicialização. Certifique-se também de que a chave SSH encriptada para o servidor de destino continua válida.
⚠️ Falha na ligação SSH a um servidor do parque
Aceda ao painel de administração na porta 8080 e introduza novamente as credenciais do equipamento. O AKR Updater irá gerar uma nova chave SSH e encriptá-la automaticamente para restabelecer a comunicação. Certifique-se de que o serviço SSH do servidor remoto está a funcionar corretamente.
⚠️ A atualização do NetBird SelfHosted falha
Verifique se as dependências específicas da sua instalação do NetBird estão corretamente configuradas na máquina de destino. Verifique o histórico de erros no painel web do AKR Updater para identificar a etapa que está a bloquear o processo. Certifique-se de que os pacotes NetBird Client e Server não estão bloqueados por outro processo.
⚠️ O SSD Trim não executa nenhuma operação no computador
Verifique se o armazenamento do seu servidor Linux ou do seu contentor suporta efetivamente o comando `trim`. Em alguns ambientes virtualizados, a opção tem de ser ativada ao nível do hipervisor para que a ordem seja transmitida ao disco físico. Consulte os registos de execução na interface web para confirmar o estado.
⚠️ O histórico de atualizações não é apresentado no painel web
Atualize a página do navegador da Web ligada à porta 8080. Se o problema persistir, reinicie o serviço AKR Updater a partir do seu terminal Linux para reiniciar a visualização da interface. Os seus dados históricos guardados anteriormente não serão perdidos.

Consulte os pré-requisitos de hardware e software necessários para que o AKR Updater funcione nas melhores condições no seu servidor Linux. Graças ao seu design extremamente leve, a ferramenta requer muito poucos recursos de processador ou memória. Instala-se na perfeição num ambiente LXC leve, oferecendo simultaneamente um painel web fluido na porta 8080. Verifique as configurações mínimas e recomendadas abaixo antes de proceder à implementação.

Requisitos

Mínimo

SODistribuição Linux moderna (por exemplo: ambiente LXC)
CPU1 núcleo do processador
RAM512 MB de RAM
Armazenamento100 MB de espaço livre
RedeÉ necessária uma ligação à Internet para o download e para os alertas

Recomendado

SODistribuição Linux moderna num contentor LXC dedicado
CPU2 núcleos de processador ou mais
RAM1 GB de RAM
Armazenamento500 MB de espaço livre
RedeLigação à Internet de banda larga com acesso à porta 8080