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