Übersicht

Quelle auf GitHub ansehen

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

Der Schwerpunkt dieses Leitfadens liegt auf der Ausführung von OTBR Docker auf dem Raspberry Pi (RPi) oder einer beliebigen Linux-basierten Maschine. Er wurde nur auf diesen Plattformen getestet.

Raspberry Pi-Einrichtung

Installieren Sie das Raspberry Pi OS mit Desktop-Betriebssystem auf dem RPi. Folgen Sie der Anleitung im Schritt Betriebssystem herunterladen und installieren aus der Raspberry Pi-Übersicht. Achten Sie dabei darauf, Raspberry Pi OS mit dem Computer zu verwenden. als Betriebssystem. Sie können nicht die Lite-Version verwenden, da Sie auf die OTBR Web-GUI in einem Webbrowser zugreifen müssen.

Nach der Installation starten Sie den RPi und öffnen 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 verwenden möchten, ohne vor jedem Befehl sudo verwenden zu müssen, ändern Sie die 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-Firewallskripts erstellen Regeln im Docker-Container. Führen Sie modprobe aus, um die Kernel-Module für iptables zu laden:

    sudo modprobe ip6table_filter
    

Linux-Einrichtung

Gehen Sie genauso vor 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 verwenden möchten, ohne vor jedem Befehl sudo verwenden zu müssen, ändern Sie die 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-Firewallskripts erstellen Regeln im Docker-Container. Führen Sie modprobe aus, um die Kernel-Module für iptables zu laden:

    sudo modprobe ip6table_filter
    

Mac oder Windows

Wenn Sie OTBR Docker auf einem Mac oder Windows verwenden möchten, installieren Sie die Docker Toolbox. Dies ist erforderlich, da das Ausführen von OTBR Docker das Bereitstellen von virtuellen seriellen Ports erfordert. Dies wird nur von der Docker Toolbox auf diesen Systemen unterstützt.

OTBR-Docker-Image abrufen

Rufen Sie das OTBR-Docker-Image ab, indem Sie es direkt aus OpenThread Docker Hub abrufen oder 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 geprüft wurde.

Image aus Docker Hub abrufen

Diese Image-ID entspricht der Commit-ID e80def4.

  1. Rufen Sie das Image ab:

    docker pull openthread/otbr:latest
    

  2. Es sollte nun in Ihrer 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 Sie 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 .