개요

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

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

Raspberry Pi 설정

RPi에 데스크톱이 있는 Raspberry Pi OS OS를 설치합니다. Raspberry Pi 개요에서 OS 다운로드 및 설치 단계의 안내를 따르되 데스크톱이 있는 Raspberry Pi OS를 OS로 사용해야 합니다. 웹브라우저에서 OTBR 웹 GUI에 액세스해야 하므로 라이트 버전을 사용할 수 없습니다.

설치되면 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 Docker 이미지를 가져오거나 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 실행