Aperçu

Afficher la source sur GitHub

Le routeur de bordure OpenThread (OTBR) fournit une compatibilité avec Docker et peut être exécuté dans un conteneur Docker plutôt que directement sur votre machine locale.

Ce guide s'appuie sur l'exécution de Docker OTBR sur le Raspberry Pi (RPi) ou sur n'importe quelle machine basée sur Linux. Il n'a été testé que sur ces plates-formes.

Configuration de Raspberry Pi

Installez le système d'exploitation Raspberry Pi OS with Desktop sur le RPi. Suivez les instructions de l'étape Télécharger et installer le système d'exploitation de la page de présentation de Raspberry Pi, mais veillez à utiliser Raspberry Pi OS with Desktop. en tant qu'OS. Vous ne pouvez pas utiliser la version simplifiée, car vous devez accéder à l'IUG Web dans un navigateur Web.

Une fois le RPi installé, démarrez-le et ouvrez une fenêtre de terminal.

  1. Mettez à jour le système :

    sudo apt-get update
    sudo apt-get upgrade
    

  2. Installez Docker :

    curl -sSL https://get.docker.com | sh
    
  3. Si vous souhaitez utiliser Docker en tant qu'utilisateur non racine, sans exiger sudo avant chaque commande, modifiez vos paramètres utilisateur. Déconnectez-vous pour que les modifications prennent effet :

    sudo usermod -aG docker $USER
    

  4. Démarrez Docker s'il n'est pas déjà en cours d'exécution :

    sudo dockerd
    

  5. Installez git :

    sudo apt install git
    

  6. Les scripts de pare-feu OTBR créent des règles dans le conteneur Docker. Exécutez modprobe pour charger les modules du noyau pour iptables :

    sudo modprobe ip6table_filter
    

Configuration pour Linux

Suivez les mêmes instructions que pour le RPI:

  1. Mettez à jour le système :

    sudo apt-get update
    sudo apt-get upgrade
    

  2. Installez Docker :

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

  3. Si vous souhaitez utiliser Docker en tant qu'utilisateur non racine, sans exiger sudo avant chaque commande, modifiez vos paramètres utilisateur. Déconnectez-vous pour que les modifications prennent effet :

    sudo usermod -aG docker $USER
    

  4. Démarrez Docker s'il n'est pas déjà en cours d'exécution :

    sudo dockerd
    

  5. Installez git :

    sudo apt install git
    

  6. Les scripts de pare-feu OTBR créent des règles dans le conteneur Docker. Exécutez modprobe pour charger les modules du noyau pour iptables :

    sudo modprobe ip6table_filter
    

Mac ou Windows

Pour utiliser OTBR Docker sous Mac ou Windows, installez Docker Toolbox. Cette opération est nécessaire, car l'exécution de OTBR sur Docker implique l'installation de ports série virtuels, qui ne sont compatibles qu'avec la boîte à outils Docker sur ces systèmes.

Obtenir l'image Docker OTBR

Récupérez l'image Docker OTBR en la extrayant directement depuis le hub Docker OpenOpen ou en clonant le dépôt OTBR et en créant le fichier Dockerfile inclus localement.

Nous vous recommandons d'extraire l'image de Docker Hub, car elle a été testée et validée par l'équipe OpenThread.

Extraire l'image de Docker Hub

Cette image date du commit e80def4.

  1. Extrayez l'image :

    docker pull openthread/otbr:latest
    

  2. Il doit maintenant s'afficher dans votre liste d'images Docker :

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

Créer le fichier Dockerfile

Pour créer l'image vous-même, clonez le dépôt du routeur de bordure OpenThread et créez le fichier Dockerfile inclus.

  1. Clonez le dépôt OTBR :

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

  2. Créez le fichier Dockerfile :

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