개요

OTBR (OpenThread Border Router)은 Docker를 지원하며 로컬 머신이 아닌 Docker 컨테이너에서 실행할 수 있습니다.

이 가이드는 Raspberry Pi (RPi) 또는 모든 Linux 기반 머신에서 OTBR Docker를 실행하는 데 중점을 두며 해당 플랫폼에서만 테스트되었습니다.

Raspberry Pi 설정

RPi에 데스크톱 OS가 포함된 Raspberry Pi OS를 설치합니다. Raspberry Pi 개요의 OS 다운로드 및 설치 단계의 안내를 따르되 OS로 데스크톱이 포함된 Raspberry Pi OS를 사용해야 합니다.

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

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

sudo apt-get update
sudo apt-get upgrade

Docker를 설치합니다.
```
curl -sSL https://get.docker.com | sh
```
각 명령어 앞에 sudo를 사용하지 않고 Docker를 루트가 아닌 기기로 사용하려면 사용자 설정을 수정합니다. 변경사항을 적용하려면 로그아웃합니다.
```
sudo usermod -aG docker $USER
```
아직 실행 중이 아니면 Docker를 시작합니다.
```
sudo dockerd
```
git을 설치합니다.
```
sudo apt install git
```
OTBR 방화벽 스크립트는 Docker 컨테이너 내에 규칙을 생성합니다. modprobe를 실행하여 iptables의 커널 모듈을 로드합니다.
```
sudo modprobe ip6table_filter
```

Linux 설정

RPi와 동일한 안내를 사용합니다.

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

sudo apt-get update
sudo apt-get upgrade

Docker를 설치합니다.
```
curl -sSL https://get.docker.com | sh
```
각 명령어 앞에 sudo를 사용하지 않고 Docker를 루트가 아닌 기기로 사용하려면 사용자 설정을 수정합니다. 변경사항을 적용하려면 로그아웃합니다.
```
sudo usermod -aG docker $USER
```
아직 실행 중이 아니면 Docker를 시작합니다.
```
sudo dockerd
```
git을 설치합니다.
```
sudo apt install git
```
OTBR 방화벽 스크립트는 Docker 컨테이너 내에 규칙을 생성합니다. modprobe를 실행하여 iptables의 커널 모듈을 로드합니다.
```
sudo modprobe ip6table_filter
```

Mac 또는 Windows

Mac 또는 Windows에서 OTBR Docker를 사용하려면 Docker 도구 상자를 설치합니다. 이는 OTBR Docker를 실행할 때 가상 직렬 포트를 마운트해야 하기 때문에 필요합니다. 가상 직렬 포트는 해당 시스템의 Docker 도구 모음에서만 지원됩니다.

OTBR Docker 이미지 가져오기

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

OpenThread팀에서 테스트 및 검증한 Docker Hub에서 이미지를 가져오는 것이 좋습니다.

Docker Hub에서 이미지 가져오기

이 이미지는 커밋 ID(e80def4) 기준입니다.

이미지를 가져옵니다.
```
docker pull openthread/otbr:latest
```

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

docker images
REPOSITORY           TAG          IMAGE ID           CREATED           SIZE
openthread/otbr      latest       98416559dcbd       2 weeks ago       1.15GB

Dockerfile 빌드

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

OTBR 저장소를 클론합니다.

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

Dockerfile을 빌드합니다.

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

OTBR Docker 실행