[AI 공유기] AdGuard Home 예시로 Docker, Image, Container, Portainer 이해하기

AdGuard Home을 성공적으로 설치하셨습니다. 이제 이 예시를 통해 AI Board에서 Docker와 Portainer가 어떻게 작동하는지 빠르게 이해해봅시다. 이것은 단순히 [어떻게 하는지]에 대한 것이 아니라, [왜 이렇게 작동하는지]에 대한 내용도 포함합니다.

 

 

1. AdGuard Home 설치 버튼을 클릭하면 어떤 일이 발생하나요?

    AI Board에서 AdGuard Home의 [설치] 버튼을 클릭하면, 시스템은 자동으로 다음 작업을 수행합니다:

  1. AdGuard Home 이미지가 로컬에 이미 존재하는지 확인하고, 없으면 Docker Hub에서 이미지를 다운로드합니다.
  2. 이미지를 사용하여 새 컨테이너를 만들고, 자원을 할당한 뒤 이름(예: adguardhome)을 부여합니다.
  3. 볼륨을 생성하여 컨테이너의 지정된 경로에 마운트하여, 재시작 후에도 설정과 데이터가 유지되도록 합니다.
  4. 네트워킹 및 포트 매핑을 설정하여 http://<AI Board IP>:3000에서 AdGuard Home에 접속할 수 있도록 합니다.
  5. 컨테이너를 시작하고 상태를 모니터링합니다.

    이 모든 과정이 [설치] 버튼을 클릭한 후 자동으로 진행됩니다.

 

2. Portainer에서 AdGuard Home 확인하기

    Portainer는 웹 기반 Docker 관리 도구로, 브라우저에서 컨테이너, 이미지, 볼륨을 쉽게 관리할 수 있습니다.

    Portainer 로그인： Portainer는 AI Board UI에서 접근할 수 있으며, 또는 URL(일반적으로 https://<your AI board host name>:9443)로 직접 접속할 수 있습니다.

    로그인 후, 대시보드를 클릭하여 관리 인터페이스로 진입하세요.

 

    컨테이너 페이지:

  • 왼쪽 메뉴에서 [Containers]를 클릭하면 실행 중인 모든 컨테이너를 볼 수 있습니다. AdGuard Home은 일반적으로 adguardhome으로 표시됩니다.
  • 컨테이너 이름을 클릭하면 상태, 로그, 리소스 사용량을 확인할 수 있습니다. 이곳에서 시작, 중지, 재시작도 가능합니다.

 

 

    이미지 페이지:

  • [Images]를 클릭하면 다운로드된 모든 이미지(AdGuard Home 포함)를 볼 수 있습니다.

 

    볼륨 페이지:

  • Click [볼륨]을 클릭하면 모든 영구 저장소를 볼 수 있습니다. AdGuard Home과 관련된 볼륨을 찾으세요—여기에 설정과 데이터가 저장되어 있습니다.

 

3. Docker, 이미지, 컨테이너, 그리고 Portainer란 무엇인가요?

  • Docker: 애플리케이션을 격리된 환경(컨테이너)에서 실행할 수 있게 해주는 플랫폼으로, 소프트웨어 배포와 관리가 쉽고 일관적입니다. AI Board에서 Docker를 사용하면 각 애플리케이션(예: AdGuard Home, HomeAssistant)을 라우터에 독립적으로 설치할 수 있습니다.
  • Docker Hub: Docker Hub는 온라인 이미지 저장소로, 여기에서 다양한 이미지를 검색하고 다운로드할 수 있습니다. 몇 가지 명령어나 Portainer를 통해 이미지를 설치할 수 있습니다.
  • 이미지: 애플리케이션의 설계도이며, 실행에 필요한 모든 코드와 라이브러리를 포함합니다. 이미지는 고정되어 변경되지 않으며, 실행할 때 비로소 컨테이너가 됩니다. 하나의 이미지에서 여러 컨테이너를 만들 수 있습니다.
  • 컨테이너: 이미지의 실행 인스턴스(미니 서버)입니다. 각 컨테이너는 자체 환경, 설정, 리소스를 가지고 있습니다. 컨테이너를 삭제해도 이미지는 영향을 받지 않으며 언제든지 다시 생성할 수 있습니다. 영구적인 데이터는 컨테이너가 볼륨을 사용하여 저장합니다.
  • 볼륨: 컨테이너가 삭제되거나 다시 생성되더라도 유지해야 하는 데이터(예: 설정 파일이나 데이터베이스)를 저장합니다.
  • Portainer: Docker를 위한 그래픽 관리 도구로, 웹 인터페이스를 통해 컨테이너, 이미지, 볼륨을 확인하고 제어하며 문제를 해결할 수 있습니다.

 

4. 어떻게 연결되어 있나요?

  • 이미지(청사진)를 다운로드하거나 직접 만듭니다
  • Docker를 사용해 컨테이너(미니 서버)를 시작합니다
  • 컨테이너는 중요한 데이터를 저장하기 위해 볼륨을 사용합니다
  • Portainer는 모든 것을 시각적으로 관리할 수 있도록 도와줍니다

 

5. 실생활 비유

    당신이 제과점을 운영한다고 상상해 보세요

  • 이미지는 케이크 레시피로, 모든 단계와 재료가 나와 있습니다.
  • 컨테이너는 레시피로 구운 케이크입니다; 여러 개의 케이크를 구울 수 있습니다.
  • 볼륨은 노트북과 같아서, 각 케이크의 특별한 비법과 고객의 취향을 기록합니다. 새로운 케이크를 구워도 이 기록을 잃지 않습니다.
  • Docker는 주방으로, 각 케이크가 자신의 작업대에서 표준 절차에 따라 구워지도록 합니다.
  • Portainer는 제과점 대시보드로, 어떤 케이크가 굽고 있는지, 어떤 레시피가 있는지, 그리고 노트가 어디에 저장되어 있는지 보여줍니다.

 

6. 연습

    Portainer를 더 많이 사용할수록 Docker의 유연함을 더 빠르게 익힐 수 있습니다. 아래는 추천 연습입니다:

  • 컨테이너 페이지로 이동하여 adguardhome을 선택한 후 제거를 클릭해 컨테이너를 삭제한 다음, Docker Compose YAML을 사용해 새 컨테이너를 만듭니다. 걱정하지 마세요—컨테이너를 다시 만드는 것은 빠릅니다. 몇 번 반복해 보면서 프로세스에 익숙해지세요.

  • Stack 페이지로 이동하여, 새 Stack을 생성하고, AdGuard Home Docker Compose YAML을 붙여넣은 후 새로운 컨테이너를 배포하세요.

  • Name 필드에 adguardhome을 입력하세요.

  • 다음 YAML을 붙여넣고 Deploy the stack을 클릭하세요.

 

버전: "3.8"
서비스:
   adguardhome:
        이미지: adguard/adguardhome:최신
        컨테이너_이름: adguardhome
        재시작: 중지되지 않는 한
        네트워크_모드: "호스트"
        환경변수:
             # 기본 웹 인터페이스 포트 정의
          - ADGUARD_HOME_DEFAULT_WEB_PORT=3000
        볼륨:
          - adgh_work:/opt/adguardhome/work
          -adgh_conf:/opt/adguardhome/conf
          - /etc/hosts:/etc/hosts:ro
volumes:
   adgh_work:
   adgh_conf:
  • 작업이 완료되면 새 AdGuard Home 컨테이너가 생성된 것을 볼 수 있습니다.

 

 

 

 

(유틸리티 / 펌웨어)를 얻는 방법?

최신 driver, 소프트웨어, 펌웨어 및 사용자 설명서는 ASUS 다운로드 센터에서 다운로드할 수 있습니다.

ASUS 다운로드 센터에 대해 더 많은 정보가 필요하다면, 이 링크를 참고해 주세요.

.