Panoramica

Visualizza sorgente su GitHub

Il router OpenThread Border Router (OTBR) offre il supporto Docker e può essere eseguito in un container Docker anziché direttamente sulla macchina locale.

Questa guida si concentra sull'esecuzione di OTBR Docker su Raspberry Pi (RPi) o su qualsiasi macchina basata su Linux ed è stata testata solo su tali piattaforme.

Configurazione di Raspberry Pi

Installa il sistema operativo Raspberry Pi con Desktop sul RPi. Segui le istruzioni riportate nel passaggio Scarica e installa il sistema operativo dalla panoramica di Raspberry Pi, ma assicurati di utilizzare Raspberry Pi OS con desktop. come sistema operativo. Non puoi utilizzare la versione Lite, poiché devi accedere alla GUI web OTBR in un browser web.

Al termine dell'installazione, avvia l'RPi e apri una finestra del terminale.

1. Aggiorna il sistema:

   sudo apt-get update
   sudo apt-get upgrade
   

2. Installa Docker:

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

3. Se vuoi utilizzare Docker come non-root, senza richiedere sudo prima di ogni comando, modifica le impostazioni dell'utente. Esci affinché le modifiche abbiano effetto:

   sudo usermod -aG docker $USER
   

4. Avvia Docker se non è già in esecuzione:

   sudo dockerd
   

5. Installa git:

   sudo apt install git
   

6. Gli script firewall OTBR creano regole all'interno del container Docker. Esegui modprobe per caricare i moduli del kernel per iptables:

   sudo modprobe ip6table_filter
   

Configurazione di Linux

Segui le stesse istruzioni dell'RPi:

1. Aggiorna il sistema:

   sudo apt-get update
   sudo apt-get upgrade
   

2. Installa Docker:

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

3. Se vuoi utilizzare Docker come non-root, senza richiedere sudo prima di ogni comando, modifica le impostazioni dell'utente. Esci affinché le modifiche abbiano effetto:

   sudo usermod -aG docker $USER
   

4. Avvia Docker se non è già in esecuzione:

   sudo dockerd
   

5. Installa git:

   sudo apt install git
   

6. Gli script firewall OTBR creano regole all'interno del container Docker. Esegui modprobe per caricare i moduli del kernel per iptables:

   sudo modprobe ip6table_filter
   

Mac o Windows

Per utilizzare Docker OTBR su Mac o Windows, installa Strumenti per Docker. Ciò è necessario perché l'esecuzione di OTBR Docker comporta il montaggio di porte seriali virtuali, che è supportata solo da Docker Toolbox su tali sistemi.

Ottenere l'immagine Docker OTBR

Recupera l'immagine Docker OTBR eseguendo il pull direttamente da OpenThread Docker Hub o clonando il repository OTBR e creando localmente il Dockerfile incluso.

Ti consigliamo di eseguire il pull dell'immagine da Docker Hub, poiché è stato testato e verificato dal team OpenThread.

Esegui il pull dell'immagine da Docker Hub

Questa immagine risale al e80def4.

1. Esegui il pull dell'immagine:

   docker pull openthread/otbr:latest
   

2. Dovrebbe apparire nell'elenco delle immagini Docker:

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

Creare il Dockerfile

Per creare l'immagine manualmente, clona il repository del router di confine OpenThread e crea il Dockerfile incluso.

1. Clona il repository OTBR:

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

2. Crea il Dockerfile:

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