Ü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.

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

Raspberry Pi-Einrichtung

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

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 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, wenn es nicht bereits 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 Kernelmodule für iptables zu laden:

    sudo modprobe ip6table_filter
    

Linux-Einrichtung

Verwenden Sie 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 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, wenn es nicht bereits 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 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 OTBR-Docker virtuelle serielle Ports bereitstellt, die nur von der Docker Toolbox auf diesen Systemen unterstützt werden.

OTBR-Docker-Image abrufen

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

Dieses Bild 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 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 .