Przegląd

Wyświetl źródło na GitHubie

OpenThread Border Router (OTBR) zapewnia obsługę Dockera i można je uruchamiać w kontenerze Dockera, a nie bezpośrednio na komputerze lokalnym.

Ten przewodnik dotyczy uruchamiania OTBR Dockera na Raspberry Pi (RPi) lub na dowolnym komputerze z systemem Linux. Został przetestowany tylko na tych platformach.

Konfiguracja Raspberry Pi

Zainstaluj system operacyjny Raspberry Pi na komputerze w RPi. Wykonaj instrukcje podane w kroku Pobieranie i instalowanie systemu operacyjnego w przeglądzie Raspberry Pi, ale pamiętaj, aby jako systemu operacyjnego używać Raspberry Pi OS z komputerem.

Po zainstalowaniu uruchom RPi i otwórz okno terminala.

1. Zaktualizuj system:

   sudo apt-get update
   sudo apt-get upgrade
   

2. Zainstaluj Dockera:

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

3. Jeśli chcesz używać Dockera jako użytkownika innego niż root bez konieczności wymagania sudo przed każdym poleceniem, zmodyfikuj ustawienia użytkownika. Wyloguj się, aby zmiany zaczęły obowiązywać:

   sudo usermod -aG docker $USER
   

4. Uruchom Dockera, jeśli jeszcze nie jest uruchomiony:

   sudo dockerd
   

5. Zainstaluj git:

   sudo apt install git
   

6. Skrypty zapory sieciowej OTBR tworzą reguły w kontenerze Dockera. Uruchom modprobe, aby wczytać moduły jądra systemu operacyjnego iptables:

   sudo modprobe ip6table_filter
   

Konfiguracja Linuksa

Postępuj zgodnie z tymi samymi instrukcjami co w przypadku RPi:

1. Zaktualizuj system:

   sudo apt-get update
   sudo apt-get upgrade
   

2. Zainstaluj Dockera:

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

3. Jeśli chcesz używać Dockera jako użytkownika innego niż root bez konieczności wymagania sudo przed każdym poleceniem, zmodyfikuj ustawienia użytkownika. Wyloguj się, aby zmiany zaczęły obowiązywać:

   sudo usermod -aG docker $USER
   

4. Uruchom Dockera, jeśli jeszcze nie jest uruchomiony:

   sudo dockerd
   

5. Zainstaluj git:

   sudo apt install git
   

6. Skrypty zapory sieciowej OTBR tworzą reguły w kontenerze Dockera. Uruchom modprobe, aby wczytać moduły jądra systemu operacyjnego iptables:

   sudo modprobe ip6table_filter
   

Mac lub Windows

Aby używać OTBR Dockera na Macu lub komputerze z systemem Windows, zainstaluj Docker Toolbox. Jest to wymagane, ponieważ uruchamianie OTBR Dockera polega na podłączeniu wirtualnych portów szeregowych, które są obsługiwane tylko przez DockerToolbox w tych systemach.

Pobieranie obrazu Dockera OTBR

Pobierz obraz Dockera OTBR, pobierając go bezpośrednio z OpenThread Docker Hub lub sklonując repozytorium OTBR i lokalnie skompilując dołączony plik Dockerfile.

Zalecamy pobranie obrazu z Docker Hub, ponieważ został on przetestowany i zweryfikowany przez zespół OpenThread.

Pobieranie obrazu z Docker Hub

Ten obraz jest w aktualnym stanie zatwierdzenia: e80def4.

1. Pobierz obraz:

   docker pull openthread/otbr:latest
   

2. Powinien pojawić się na liście obrazów Dockera:

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

Tworzenie pliku Dockerfile

Aby samodzielnie utworzyć obraz, skopiuj repozytorium OpenThread Border Router i skompiluj dołączony plik Dockerfile.

1. Sklonuj repozytorium OTBR:

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

2. Utwórz plik Dockerfile:

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