...

AKR Updater

1.7.3

...

💻 Comando di installazione
curl -fsSL https://dl.akra13.fr/AKRUpdaterInstaller | sudo bash

Questa guida pratica ti descrive in dettaglio l'utilizzo passo dopo passo del software, dalla scoperta dell'interfaccia web all'impostazione delle tue prime attività pianificate. Imparerai anche a collegare il tuo account Discord per gestire i tuoi riavvi da remoto.

Prima di avviare la distribuzione dell'applicazione, scopri la procedura da seguire per configurare rapidamente il tuo host a regola d'arte. L'intera procedura si basa su un unico comando shell eseguito nel tuo terminale Linux.

Installazione

1

Preparazione dell'ambiente Linux

Avvia un sistema Linux o crea un contenitore LXC dedicato e pulito per ospitare il servizio. Assicurati di disporre di un accesso al terminale con i privilegi di amministrazione sudo e di una connessione di rete attiva per scaricare i file necessari.

2

Esecuzione del comando di installazione

Apri il terminale e incolla esattamente il seguente comando: curl -fsSL https://dl.akra13.fr/AKRUpdaterInstaller | sudo bash. Conferma l'esecuzione per avviare lo script ufficiale di installazione automatizzata.

3

Attesa della configurazione automatica

Lascia che il processo di installazione distribuisca i file e configuri i servizi in background. Lo script si esegue in modo autonomo in pochi secondi per preparare i componenti necessari al funzionamento del sistema.

4

Verifica delle porte di rete

Controlla che la porta TCP 8080 sia correttamente accessibile dalla tua rete locale o autorizzala nelle regole del firewall applicativo. Questa porta è indispensabile per comunicare con l'interfaccia grafica di amministrazione ospitata dal software.

5

Accesso al pannello di amministrazione web

Avvia il tuo browser web e vai all'indirizzo IP del tuo server seguito dalla porta 8080 (ad esempio http://IP_SERVER:8080). Arriverai sulla schermata iniziale del pannello dedicato alla gestione dei tuoi server.

6

Aggiunta del primo server remoto

Dal pannello web, registra la tua prima macchina target inserendo il suo indirizzo e le credenziali richieste per il collegamento iniziale. Il sistema genererà la chiave SSH cifrata, sigillando l'accesso sicuro per le future operazioni di manutenzione.

Guida all'uso

Navigazione nel pannello di amministrazione web

La dashboard accessibile sulla porta 8080 centralizza lo stato di tutte le tue macchine registrate. Puoi osservare lo stato globale del tuo parco, verificare le ultime operazioni eseguite e sfogliare lo storico completo delle azioni. Questo spazio costituisce il punto nevralgico per orchestrare i tuoi interventi tecnici senza aprire sessioni SSH multiple.

Pianificazione delle attività e del trim SSD

Dalla sezione di pianificazione, definisci la frequenza con cui i tuoi pacchetti di sistema devono essere ispezionati e aggiornati. Puoi anche integrare l'ottimizzazione trim SSD per mantenere buone prestazioni sui tuoi supporti di archiviazione flash. Una volta registrata, la routine si esegue automaticamente in background secondo il calendario stabilito.

Configurazione degli avvisi e del bot Discord

Per garantire un monitoraggio da remoto, configura i tuoi canali di avviso inserendo un webhook Discord o attivando il bot integrato. In modalità bot, riceverai riquadri dettagliati dopo ogni esecuzione di attività. Queste notifiche arricchite integrano pulsanti di interazione che permettono di riavviare una macchina o di programmarne il riavvio con un semplice clic.

Amministrazione delle istanze NetBird

Se la tua infrastruttura si basa su NetBird, il software supporta la gestione delle versioni dei tuoi componenti. Puoi applicare gli aggiornamenti sia sul client che sull'infrastruttura NetBird SelfHosted direttamente tramite lo strumento. Questa integrazione nativa assicura la coerenza delle versioni della tua rete overlay senza complesse manipolazioni manuali.

Monitoraggio dei log e tracciabilità

Consulta regolarmente lo storico delle operazioni sull'interfaccia per verificare le azioni condotte sulle tue macchine. In caso di anomalia su un servizio a seguito di un aggiornamento, il log ti permette di verificare con precisione quali pacchetti sono stati elaborati e in quale momento. Questa visibilità facilita l'analisi e la manutenzione preventiva dei tuoi ambienti.

Questi consigli d'uso sono stati formulati per aiutarti a sfruttare al meglio il tuo pannello di controllo e a ottimizzare la sicurezza del tuo parco. Metti in pratica queste raccomandazioni per preservare la stabilità dei tuoi ambienti Linux.

Consigli

Privilegia un contenitore LXC dedicato

Installa lo strumento all'interno di un'istanza LXC vergine per isolare l'amministrazione dei tuoi server dai tuoi carichi applicativi abituali. Questo semplifica i backup globali e preserva l'integrità del tuo server di supervisione.

Pianifica al di fuori degli orari di punta

Programma i tuoi cicli di aggiornamento e di trim SSD durante le fasce orarie notturne. In questo modo eviterai qualsiasi rallentamento imprevisto del disco o qualsiasi indisponibilità temporanea per i tuoi utenti.

Sfrutta i pulsanti d'azione Discord

Configura la modalità bot di Discord anziché un webhook passivo per beneficiare dei pulsanti interattivi di riavvio. Questo ti permette di confermare un riavvio del sistema dal tuo cellulare senza doverti connettere alla dashboard.

Monitora i pacchetti del kernel

Presta attenzione alle notifiche che segnalano un aggiornamento del kernel Linux. Pianifica quindi un rapido riavvio dell'host per caricare la nuova versione sicura senza lasciare la macchina in uno stato intermedio.

Verifica le tue chiavi SSH registrées

Poiché lo strumento cifra automaticamente le chiavi SSH generate, fai attenzione a non modificare manualmente i permessi delle directory delle chiavi sui target. Lascia che lo strumento gestisca i suoi accessi per evitare qualsiasi interruzione della comunicazione.

Centralizza i tuoi nodi NetBird

Raggruppa la supervisione dei tuoi client NetBird e del tuo server SelfHosted sulla stessa dashboard. Questo garantisce un'omogeneità perfetta dei protocolli e limita i rischi di incompatibilità tra le versioni della rete.

Consulta lo storico prima di ogni modifica importante

Prima di installare una nuova applicazione pesante su un server remoto, verifica nello storico che l'ultima manutenzione si sia conclusa senza errori. In questo modo partirai da una base software perfettamente sana e aggiornata.

Verifica la connettività della porta 8080

Se gestisci le tue macchine tramite una rete remota, prendi in considerazione di posizionare il pannello web dietro un tunnel sicuro o di filtrare rigorosamente gli indirizzi IP autorizzati a raggiungere la porta 8080.

In caso di imprevisti durante l'accesso al pannello web o la comunicazione con una macchina remota, consulta questa sezione di risoluzione dei problemi. Raccoglie le soluzioni concrete ai blocchi tecnici più comunemente riscontrati.

Risoluzione problemi

⚠️ L'interfaccia web sulla porta 8080 si rifiuta di caricarsi dopo l'installazione
Verifica che il servizio sia attivo sulla tua macchina host consultando i processi in corso nel terminale. Assicurati che il firewall locale non intercetti le connessioni sulla porta 8080 e controlla che l'indirizzo IP utilizzato sia raggiungibile dalla tua postazione.
⚠️ Connessione fallita durante l'aggiunta di una nuova macchina target
Controlla che il server remoto sia raggiungibile in rete e che il servizio SSH funzioni correttamente. Verifica che le credenziali temporanee di amministratore inserite siano esatte affinché il software possa distribuire la sua chiave cifrata iniziale.
⚠️ Gli avvisi Discord non arrivano sul server di discussione
Ispeziona l'URL del webhook o il token del bot Discord configurato nelle impostazioni del pannello. Assicurati che il canale testuale di destinazione conceda i permessi di scrittura e invio di messaggi arricchiti (embed) al bot.
⚠️ I pulsanti interattivi Discord non attivano il riavvio
Assicurati di utilizzare la modalità bot di Discord e non un semplice webhook, poiché quest'ultimo non consente l'interattività. Verifica inoltre che la comunicazione in uscita dal tuo host verso l'API Discord non sia bloccata.
⚠️ L'operazione di trim SSD fallisce su un server specifico
Verifica se l'archiviazione della macchina target si basa effettivamente su un supporto SSD compatibile con il comando fstrim. Nel caso di una macchina virtuale o di un contenitore, l'opzione di emulazione SSD o l'accesso ai comandi di discard deve essere abilitata sull'hypervisor.
⚠️ L'aggiornamento di NetBird SelfHosted non avanza più
Consulta i log dello storico nell'interfaccia web per individuare eventuali conflitti di pacchetti o di contenitori. Assicurati che l'istanza NetBird disponga di uno spazio disco sufficiente per scaricare e decomprimere i nuovi binari.
⚠️ Interruzione del comando curl durante l'installazione iniziale
Verifica la stabilità della tua connessione internet e assicurati che i pacchetti curl e sudo siano correttamente installati sul tuo sistema di base. Riavvia quindi il comando curl -fsSL https://dl.akra13.fr/AKRUpdaterInstaller | sudo bash nel tuo terminale.
⚠️ Il riavvio pianificato non è stato eseguito all'ora prevista
Controlla la sincronizzazione oraria (fuso orario e servizio NTP) tra il server che esegue l'Updater e la macchina remota. Una divergenza di orologio può ritardare l'esecuzione delle pianificazioni programmate.

Prendi visione dei requisiti hardware e di sistema indispensabili per garantire un funzionamento ottimale della dashboard web e delle sue attività in background. Progettato per rimanere molto efficiente, lo strumento si adatta a configurazioni hardware modeste.

Requisiti

Minimo

SODistribuzione Linux moderna (consigliato in nuovo contenitore LXC)
CPUProcessore a 1 core a 64 bit
RAM512 MB di memoria RAM
Spazio1 GB di spazio libero
ReteAccesso a Internet per il download e i repository dei pacchetti

Consigliato

SODistribuzione Linux moderna in contenitore LXC dedicato
CPUProcessore a 2 core
RAM1 GB di memoria RAM o superiore
Spazio5 GB di spazio libero per gli storici e i log
ReteConnessione a banda larga e porta 8080 aperta sulla rete locale