Übersicht

Quelle auf GitHub ansehen

OpenThread Border Router (OTBR) bietet Docker-Unterstützung und kann in einem Docker-Container anstatt direkt auf deinem lokalen Computer ausgeführt werden.

Dieser Leitfaden konzentriert sich auf die Ausführung von OTBR-Docker auf dem Raspberry Pi (RPi) oder einem beliebigen Linux-basierten Computer. Er wurde nur auf diesen Plattformen getestet.

Raspberry Pi-Einrichtung

Installieren Sie das Raspberry Pi OS mit Desktopbetrieb auf dem RPi. Folgen Sie der Anleitung im Schritt Betriebssystem herunterladen und installieren aus der Raspberry Pi-Übersicht. Verwenden Sie dabei aber Raspberry Pi OS mit Desktop als Betriebssystem.

Starten Sie das RPI nach der Installation und öffnen Sie ein Terminalfenster.

  1. Aktualisieren Sie das System:

    sudo apt-get update
    sudo apt-get upgrade
    

  2. Installieren Sie Docker:

    curl -sSL https://get.docker.com | sh
    
  3. Wenn Sie Docker als Nicht-Root-Instanz verwenden möchten, ohne dass vor jedem Befehl sudo erforderlich ist, ändern Sie Ihre Nutzereinstellungen. Melden Sie sich ab, damit die Änderungen wirksam werden:

    sudo usermod -aG docker $USER
    

  4. Starten Sie Docker, falls es noch nicht ausgeführt wird:

    sudo dockerd
    

  5. Installieren Sie Git:

    sudo apt install git
    

  6. OTBR-Firewall-Skripts erstellen Regeln im Docker-Container. Führen Sie modprobe aus, um die Kernelmodule für iptables zu laden:

    sudo modprobe ip6table_filter
    

Einrichtung unter Linux

Verwende dieselbe Anleitung wie beim RPi:

  1. Aktualisieren Sie das System:

    sudo apt-get update
    sudo apt-get upgrade
    

  2. Installieren Sie Docker:

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

  3. Wenn Sie Docker als Nicht-Root-Instanz verwenden möchten, ohne dass vor jedem Befehl sudo erforderlich ist, ändern Sie Ihre Nutzereinstellungen. Melden Sie sich ab, damit die Änderungen wirksam werden:

    sudo usermod -aG docker $USER
    

  4. Starten Sie Docker, falls es noch nicht ausgeführt wird:

    sudo dockerd
    

  5. Installieren Sie Git:

    sudo apt install git
    

  6. OTBR-Firewall-Skripts erstellen Regeln im Docker-Container. Führen Sie modprobe aus, um die Kernelmodule für iptables zu laden:

    sudo modprobe ip6table_filter
    

Mac oder Windows

Installieren Sie die Docker Toolbox, um OTBR-Docker auf einem Mac oder unter Windows zu verwenden. Dies ist erforderlich, da beim Ausführen von OTBR-Docker virtuelle serielle Ports bereitgestellt werden, die nur von der Docker Toolbox auf diesen Systemen unterstützt werden.

OTBR-Docker-Image abrufen

Rufen Sie das OTBR-Docker-Image direkt aus dem OpenThread Docker Hub ab. Alternativ können Sie das OTBR-Repository klonen und das enthaltene Dockerfile lokal erstellen.

Wir empfehlen, das Image aus Docker Hub abzurufen, da es vom OpenThread-Team getestet und verifiziert wurde.

Image aus Docker Hub herunterladen

Dieses Image stammt von der Commit-ID e80def4.

  1. Rufen Sie das Image ab:

    docker pull openthread/otbr:latest
    

  2. Es sollte jetzt in der Liste der Docker-Images angezeigt werden:

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

Dockerfile erstellen

Um das Image selbst zu erstellen, klonen Sie das OpenThread-Border-Router-Repository und erstellen das enthaltene Dockerfile.

  1. Klonen Sie das OTBR-Repository:

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

  2. Erstellen Sie das Dockerfile:

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