개요

GitHub에서 소스 보기

OpenThread Border Router (OTBR)는 Docker 지원을 제공하며 로컬 머신에서 직접 실행하는 대신 Docker 컨테이너에서 실행할 수 있습니다.

이 가이드에서는 Raspberry Pi (RPi)에서 OTBR Docker를 실행하는 방법을 중점적으로 설명합니다.

Raspberry Pi 설정

RPi에 데스크톱이 포함된 Raspberry Pi OS OS를 설치합니다. 데스크톱 버전과 Lite 버전 모두 사용할 수 있습니다.

설치가 완료되면 RPi를 부팅하고 터미널 창을 엽니다.

  1. 시스템을 업데이트합니다.

    sudo apt-get update
    sudo apt-get upgrade
    

  2. Docker를 설치합니다.

    curl -sSL https://get.docker.com | sh
    
  3. 각 명령어 앞에 sudo가 필요하지 않도록 Docker를 루트가 아닌 사용자로 사용하려면 사용자 설정을 수정하세요. 변경사항이 적용되도록 로그아웃합니다.

    sudo usermod -aG docker $USER
    

  4. Docker가 아직 실행되고 있지 않으면 Docker를 시작합니다.

    sudo dockerd
    

  5. IP 전달을 사용 설정합니다.

    Linux는 일반적으로 기본적으로 IP 전달을 사용 중지합니다. setup-host 스크립트를 실행하여 호스트 시스템에서 IP 전달을 사용 설정합니다.

    curl -sSL https://raw.githubusercontent.com/openthread/ot-br-posix/refs/heads/main/etc/docker/border-router/setup-host | bash
    

OTBR Docker 이미지 가져오기

OpenThread Docker Hub에서 직접 가져오거나 OTBR 저장소를 클론하고 포함된 Dockerfile을 로컬에서 빌드하여 OTBR Docker 이미지를 가져옵니다.

Docker Hub에서 이미지를 가져오는 것이 좋습니다. OpenThread팀에서 테스트 및 확인한 이미지이기 때문입니다.

Docker Hub에서 이미지 가져오기

  1. 이미지를 가져옵니다.

    docker pull openthread/border-router:latest
    

  2. 이제 Docker 이미지 목록에 표시됩니다.

    docker images
    REPOSITORY                 TAG       IMAGE ID       CREATED       SIZE
    openthread/border-router   latest    08666d77013d   2 hours ago   171MB
    

Dockerfile 빌드

이미지를 직접 만들려면 OpenThread Border Router 저장소를 클론하고 포함된 Dockerfile을 빌드합니다.

  1. git을 설치합니다.

    sudo apt install git
    

  2. OTBR 저장소를 클론합니다.

    cd ~
    git clone https://github.com/openthread/ot-br-posix
    cd ot-br-posix
    

  3. Dockerfile을 빌드합니다.

    docker build --no-cache -t openthread/border-router -f etc/docker/border-router/Dockerfile .