Argomenti correlati
[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:
- Controlla se l’immagine di AdGuard Home esiste già localmente. Se non esiste, la scarica da Docker Hub.
- Utilizza l’immagine per creare un nuovo container, assegna risorse e gli dà un nome (come adguardhome).
- 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.
- Imposta la rete e il mapping delle porte in modo che tu possa accedere ad AdGuard Home su http://<AI Board IP>:3000.
- 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.