[AI Router] 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. Não é apenas sobre [como fazer], mas também [por que funciona dessa forma].

 

 

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, faz o download dela do Docker Hub.
  2. Usa a imagem para criar um novo container, aloca recursos e dá um nome a ele (como adguardhome).
  3. Cria um volume e monta no caminho especificado do container, garantindo que suas configurações e dados permaneçam mesmo após reiniciar.
  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 diretamente no navegador.

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

    Após fazer login, clique no painel para entrar na interface de gerenciamento.

 

    Página de Containers:

  • Clique em [Containers] no menu à esquerda para ver todos os containers em execução. AdGuard Home geralmente é chamado de adguardhome.
  • Clique no nome do container para visualizar seu status, logs e uso de recursos. Você também pode iniciar, parar ou reiniciar ele 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, Imagem, Container e Portainer?

  • Docker: Uma plataforma que permite executar aplicações em ambientes isolados (containers), tornando a implantação e gerenciamento de software simples e consistente. Com Docker na AI Board, você pode instalar vários aplicativos (como AdGuard Home, HomeAssistant) no seu roteador, cada um rodando de forma independente.
  • Docker Hub: Docker Hub é um repositório online de imagens onde você pode pesquisar e baixar imagens prontas. Você pode instalá-las com alguns comandos ou via Portainer.
  • Imagem: O plano 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; somente quando você as inicia, elas se tornam containers. Você pode criar vários 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ê sempre pode recriá-lo. Para dados persistentes, 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 de gerenciamento gráfico 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 o 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 é o bolo que você assa a partir da receita; você pode assar muitos bolos.
  • O volume é como um caderno, armazenando as modificações especiais de cada bolo e as preferências dos clientes, para que você não as perca mesmo se assar 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 seu painel da padaria, mostrando quais bolos estão sendo assados, quais receitas você tem e onde suas anotações estão guardadas.

 

6. Prática

    Quanto mais você usar o Portainer, mais rápido 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 excluir o container, depois use o 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.

  • Acesse a página Stack, crie uma nova Stack, cole o YAML Docker Compose do AdGuard Home e implante um novo container.

  • Digite adguardhome no campo Nome.

  • Cole o YAML seguinte e clique em Implantar a 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 contêiner do AdGuard Home criado.

 

 

 

 

Como obter a (Utilidade / Firmware)?

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

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