[Roteador IA] Entendendo Docker, Image, Container e Portainer com o Exemplo do AdGuard Home

Você instalou o AdGuard Home com sucesso. Agora, vamos usar este exemplo para entender rapidamente como o Docker e o Portainer funcionam na sua AI Board. Isso não é apenas sobre [como fazer isso], mas também [por que funciona dessa maneira].

 

 

1. O que acontece quando você clica em Instalar para AdGuard Home?

    Quando você clica no botão [Instalar] para o AdGuard Home na sua AI Board, o sistema automaticamente:

  1. Verifica se a imagem do AdGuard Home já existe localmente. Se não existir, faz o download dela do Docker Hub.
  2. Usa a imagem para criar um novo container, aloca recursos e atribui um nome (como adguardhome).
  3. Cria um volume e o monta no caminho especificado do container, garantindo que suas configurações e dados persistam mesmo após reinicializações.
  4. Configura a rede e o mapeamento de portas para que você possa acessar o AdGuard Home em http://<IP da AI Board>:3000.
  5. Inicia o container e monitora seu status.

    Tudo isso acontece automaticamente após você clicar em [Instalar].

 

2. Visualizando o AdGuard Home no Portainer

    Portainer é uma ferramenta de gerenciamento Docker baseada na web que permite gerenciar facilmente containers, imagens e volumes pelo navegador.

    Entrar no Portainer: Você pode acessar o Portainer pela interface da AI Board ou diretamente via URL (geralmente https://<nome do host da AI Board>:9443)。

    Após fazer login, clique no painel para acessar a interface de gerenciamento.

 

    Página de Containers:

  • Clique em [Containers] no menu à esquerda para ver todos os containers em execução. AdGuard Home geralmente recebe o nome adguardhome.
  • Clique no nome do container para visualizar seu status, logs e uso de recursos. Você também pode iniciar, parar ou reiniciar aqui.

 

 

    Página de Imagens:

  • Clique em [Images] para ver todas as imagens baixadas, incluindo AdGuard Home.

 

    Página de Volumes:

  • Clique em [Volumes] para ver todo o armazenamento persistente. Encontre o volume relacionado ao AdGuard Home—é aqui que suas configurações e dados são armazenados.

 

3. O que são Docker, Image, Container e Portainer?

  • Docker: Uma plataforma que permite executar aplicações em ambientes isolados (containers), tornando a implantação e o gerenciamento de software simples e consistentes. Com Docker na AI Board, você pode instalar vários aplicativos (como AdGuard Home, HomeAssistant) no seu roteador, cada um executando de forma independente.
  • Docker Hub: Docker Hub é um repositório de imagens online onde você pode pesquisar e baixar imagens prontas. Você pode instalá-las com alguns comandos ou via Portainer.
  • Image: O projeto de uma aplicação, contendo todo o código e bibliotecas necessários para executá-la. As imagens são estáticas e imutáveis; apenas quando você as inicia é que se tornam containers. Você pode criar múltiplos containers a partir da mesma imagem.
  • Container: A instância em execução de uma imagem (um mini servidor). Cada container tem seu próprio ambiente, configurações e recursos. Excluir um container não afeta a imagem, e você pode sempre recriá-lo. Para dados persistentes, os containers usam volumes.
  • Volume: Armazena dados que precisam persistir (como configurações ou bancos de dados), mesmo que o container seja excluído ou recriado.
  • Portainer: Uma ferramenta gráfica de gerenciamento para Docker, permitindo que você visualize, controle e solucione problemas de containers, imagens e volumes através de uma interface web.

 

4. Como Eles Se Relacionam?

  • Baixe ou crie uma imagem (plano)
  • Use Docker para iniciar um container (mini servidor)
  • O container utiliza um volume para armazenar dados importantes
  • Portainer ajuda você a gerenciar tudo visualmente

 

5. Uma Analogia da Vida Real

    Imagine que você administra uma padaria

  • A imagem é sua receita de bolo, listando todos os passos e ingredientes.
  • O container é um bolo que você assa a partir da receita; você pode assar vários bolos.
  • O volume é como um caderno, armazenando ajustes especiais de cada bolo e preferências dos clientes, para que você não os perca mesmo se fizer um novo bolo.
  • Docker é sua cozinha, garantindo que cada bolo seja assado em sua própria estação de trabalho, seguindo o processo padrão.
  • Portainer é o painel da sua padaria, mostrando quais bolos estão assando, quais receitas você tem, e onde suas anotações estão guardadas.

 

6. Prática

    Quanto mais você usar o Portainer, mais rápido você vai dominar a flexibilidade do Docker. Aqui estão alguns exercícios sugeridos:

  • Vá para a página de Containers, selecione adguardhome, clique em Remover para apagar o container e depois use Docker Compose YAML para criar um novo. Não se preocupe — recriar um container é rápido. Tente algumas vezes para se familiarizar com o processo.

  • Vá para a página Stack, crie uma nova Stack, cole o YAML do Docker Compose do AdGuard Home e faça o deploy de um novo container.

  • Digite adguardhome no campo Nome.

  • Cole o YAML abaixo e clique em Deploy the stack.

 

versão: "3.8"
serviços:
   adguardhome:
        imagem: adguard/adguardhome:latest
        nome_do_container: adguardhome
        reiniciar: a menos que-parado
        modo_de_rede: "host"
        ambiente:
             # Definir porta padrão da interface web
          - ADGUARD_HOME_DEFAULT_WEB_PORT=3000
        volumes:
          - adgh_work:/opt/adguardhome/work
          -adgh_conf:/opt/adguardhome/conf
          - /etc/hosts:/etc/hosts:ro
volumes:
   adgh_work:
   adgh_conf:
  • Depois de concluir, você verá o novo container do AdGuard Home criado.

 

 

 

 

Como obter a (Utilitário / Firmware)?

Você pode baixar os drivers, softwares, firmwares e manuais de usuário mais recentes no Centro de Download ASUS.

Se você precisar de mais informações sobre o Centro de Download ASUS, por favor consulte este link.