概要

GitHub でソースを見る

OpenThread ボーダー ルーター（OTBR）は Docker のサポートを提供し、ローカルマシン上ではなく Docker コンテナで実行できます。

このガイドでは、Raspberry Pi（RPi）または任意の Linux ベースのマシンで OTBR Docker を実行する方法に焦点を当てており、これらのプラットフォームでのみテストされています。

Raspberry Pi の設定

RPi に Raspberry Pi OS with Desktop OS をインストールします。Raspberry Pi の概要から OS をダウンロードしてインストールするの手順を行います。ただし、必ず OS として Raspberry Pi OS with Desktop を使用してください。ウェブブラウザで OTBR ウェブ GUI にアクセスする必要があるため、Lite バージョンは使用できません。

インストールが完了したら、RPi を起動してターミナル ウィンドウを開きます。

1. システムを更新します。

   sudo apt-get update
   sudo apt-get upgrade
   

2. Docker をインストールします。

   curl -sSL https://get.docker.com | sh
   

3. 各コマンドの前に sudo を必要とせずに Docker を非 root として使用する場合は、ユーザー設定を変更します。ログアウトして変更を有効にします。

   sudo usermod -aG docker $USER
   

4. Docker をまだ実行していない場合は起動します。

   sudo dockerd
   

5. git をインストールします。

   sudo apt install git
   

6. OTBR ファイアウォール スクリプトが Docker コンテナ内にルールを作成します。modprobe を実行して iptables のカーネル モジュールを読み込みます。

   sudo modprobe ip6table_filter
   

Linux の設定

RPi と同じ手順を使用します。

1. システムを更新します。

   sudo apt-get update
   sudo apt-get upgrade
   

2. Docker をインストールします。

   curl -sSL https://get.docker.com | sh
   

3. 各コマンドの前に sudo を必要とせずに Docker を非 root として使用する場合は、ユーザー設定を変更します。ログアウトして変更を有効にします。

   sudo usermod -aG docker $USER
   

4. Docker をまだ実行していない場合は起動します。

   sudo dockerd
   

5. git をインストールします。

   sudo apt install git
   

6. OTBR ファイアウォール スクリプトが Docker コンテナ内にルールを作成します。modprobe を実行して iptables のカーネル モジュールを読み込みます。

   sudo modprobe ip6table_filter
   

Mac または Windows

Mac または Windows で OTBR Docker を使用するには、Docker Toolbox をインストールします。これが必要なのは、OTBR Docker を実行するときに、仮想シリアルポートのマウントが必要になるためです。仮想ポートは、これらのシステムの Docker Toolbox でのみサポートされます。

OTBR Docker イメージを取得する

OTBR Docker イメージを取得するには、OpenThread Docker Hub から直接 pull するか、OTBR リポジトリのクローンを作成して、含まれている Dockerfile をローカルにビルドします。

Docker Hub からイメージを pull することをおすすめします。これは、OpenThread チームによってテストされ、検証されたためです。

Docker Hub からイメージを pull する

このイメージは e80def4 のコミット ID 時点のものです。

1. イメージを pull します。

   docker pull openthread/otbr:latest
   

2. Docker イメージのリストに表示されます。

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

Dockerfile をビルドする

イメージを自分で作成するには、OpenThread ボーダー ルーター リポジトリのクローンを作成し、含まれている Dockerfile をビルドします。

1. OTBR リポジトリのクローンを作成します。

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

2. Dockerfile を作成します。

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