Temas relacionados
[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:
- Verifica se a imagem do AdGuard Home já existe localmente. Se não, faz o download dela do Docker Hub.
- Usa a imagem para criar um novo container, aloca recursos e dá um nome a ele (como adguardhome).
- Cria um volume e monta no caminho especificado do container, garantindo que suas configurações e dados permaneçam mesmo após reiniciar.
- 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 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.