[AI Router] Comprendere Docker, Image, Container e Portainer con l’esempio di AdGuard Home

Hai installato AdGuard Home con successo. Ora, utilizziamo questo esempio per capire rapidamente come funzionano Docker e Portainer sulla tua AI Board. Non riguarda solo [come si fa], ma anche [perché funziona in questo modo].

 

 

1. Cosa succede quando fai clic su Installa per AdGuard Home?

    Quando fai clic sul pulsante [Installa] per AdGuard Home sulla tua AI Board, il sistema automaticamente:

  1. Controlla se l’immagine di AdGuard Home esiste già localmente. Se non esiste, la scarica da Docker Hub.
  2. Utilizza l’immagine per creare un nuovo container, assegna risorse e gli dà un nome (come adguardhome).
  3. Crea un volume e lo monta nel percorso specificato del container, assicurando che le tue impostazioni e i tuoi dati rimangano anche dopo un riavvio.
  4. Imposta la rete e il mapping delle porte in modo che tu possa accedere ad AdGuard Home su http://<AI Board IP>:3000.
  5. Avvia il container e ne monitora lo stato.

    Tutto questo avviene automaticamente dopo che hai cliccato su [Installa].

 

2. Visualizzare AdGuard Home su Portainer

    Portainer è uno strumento di gestione Docker basato sul web che ti permette di gestire facilmente container, immagini e volumi dal browser.

    Accedi a Portainer: Puoi accedere a Portainer dall’interfaccia UI di AI Board, oppure direttamente tramite URL (di solito https://<nome host della tua AI board>:9443)。

    Dopo aver effettuato l'accesso, clicca sulla dashboard per entrare nell'interfaccia di gestione.

 

    Pagina dei container:

  • Clicca su [Container] nel menu a sinistra per vedere tutti i container in esecuzione. AdGuard Home di solito è chiamato adguardhome.
  • Clicca sul nome del container per visualizzare il suo stato, i log e l'utilizzo delle risorse. Puoi anche avviarlo, fermarlo o riavviarlo da qui.

 

 

    Pagina delle immagini:

  • Clicca su [Immagini] per vedere tutte le immagini scaricate, incluso AdGuard Home.

 

    Pagina dei volumi:

  • Clicca su [Volumi] per vedere tutta la memoria persistente. Trova il volume relativo ad AdGuard Home—qui sono archiviate le tue impostazioni e i tuoi dati.

 

3. Cosa sono Docker, Image, Container e Portainer?

  • Docker: Una piattaforma che ti permette di eseguire applicazioni in ambienti isolati (container), rendendo il deployment e la gestione del software semplici e coerenti. Con Docker su AI Board, puoi installare varie app (come AdGuard Home, HomeAssistant) sul tuo router, ognuna funzionante in modo indipendente.
  • Docker Hub: Docker Hub è un repository online di immagini dove puoi cercare e scaricare immagini già pronte. Puoi installarle con pochi comandi oppure tramite Portainer.
  • Image: Il modello per un'applicazione, contenente tutto il codice e le librerie necessarie per eseguirla. Le immagini sono statiche e immodificabili; diventano container solo quando le avvii. Puoi creare più container dalla stessa immagine.
  • Container: L'istanza attiva di un'immagine (un mini server). Ogni container ha il suo ambiente, impostazioni e risorse. Eliminare un container non influisce sull'immagine, e puoi sempre ricrearlo. Per i dati persistenti, i container utilizzano i volumi.
  • Volume: Memorizza i dati che devono persistere (come configurazioni o database) anche se il container viene eliminato o ricreato.
  • Portainer: Uno strumento di gestione grafica per Docker, che ti permette di visualizzare, controllare e risolvere i problemi dei container, delle immagini e dei volumi tramite un'interfaccia web.

 

4. Come Sono Collegati?

  • Scarica o crea un'immagine (modello)
  • Usa Docker per avviare un container (mini server)
  • Il container utilizza un volume per memorizzare dati importanti
  • Portainer ti aiuta a gestire tutto in modo visivo

 

5. Un'Analogia nella Vita Reale

    Immagina di gestire una panetteria

  • L'immagine è la tua ricetta della torta, che elenca tutti i passaggi e gli ingredienti.
  • Il container è una torta che prepari seguendo la ricetta; puoi cuocere molte torte.
  • Il volume è come un quaderno, dove annoti le modifiche speciali della torta e le preferenze dei clienti, così da non perderle anche se prepari una nuova torta.
  • Docker è la tua cucina, che garantisce che ogni torta sia preparata in una propria postazione, seguendo il processo standard.
  • Portainer è il cruscotto della tua panetteria, che ti mostra quali torte sono in forno, quali ricette hai e dove sono conservate le tue note.

 

6. Pratica

    Più usi Portainer, più velocemente padroneggerai la flessibilità di Docker. Ecco alcuni esercizi consigliati:

  • Vai alla pagina dei Container, seleziona adguardhome, fai clic su Rimuovi per eliminare il container, poi usa Docker Compose YAML per crearne uno nuovo. Non preoccuparti—ricreare un container è semplice. Provalo alcune volte per familiarizzare con il procedimento.

  • Vai alla pagina Stack, crea un nuovo Stack, incolla lo YAML di Docker Compose di AdGuard Home e distribuisci un nuovo container.

  • Inserisci adguardhome nel campo Nome.

  • Incolla lo YAML seguente e clicca su Distribuisci lo stack.

 

versione: "3.8"
servizi:
   adguardhome:
        immagine: adguard/adguardhome:ultimo
        nome_contenitore: adguardhome
        riavvia: a meno che-fermato
        modalità_rete: "host"
        ambiente:
             # Definisci la porta predefinita dell'interfaccia web
          - ADGUARD_HOME_DEFAULT_WEB_PORT=3000
        volumi:
          - adgh_work:/opt/adguardhome/work
          -adgh_conf:/opt/adguardhome/conf
          - /etc/hosts:/etc/hosts:ro
volumi:
   adgh_work:
   adgh_conf:
  • Una volta completato, vedrai il nuovo container AdGuard Home creato.

 

 

 

 

Come ottenere l'(Utility / Firmware)?

Puoi scaricare i driver, il software, il firmware e i manuali utente più recenti nel Centro Download ASUS.

Se hai bisogno di ulteriori informazioni sul Centro Download ASUS, consulta questo link.