Descripción general

Ver código fuente en GitHub

OpenThread Border Router (OTBR) proporciona compatibilidad con Docker y se puede ejecutar en un contenedor de Docker, en lugar de hacerlo directamente en tu máquina local.

Esta guía se centra en la ejecución de Docker de OTBR en Raspberry Pi (RPi) o en cualquier máquina basada en Linux, y solo se probó en esas plataformas.

Configuración de Raspberry Pi

Instala el SO Raspberry Pi con computadoras de escritorio en el RPi. Sigue las instrucciones que se indican en el paso Descarga e instala el SO de la descripción general de Raspberry Pi, pero asegúrate de usar Raspberry Pi OS con computadora de escritorio como SO. No puedes usar la versión Lite, ya que debes acceder a la GUI web de OTBR en un navegador web.

Una vez instalado, inicia el RPi y abre una ventana de la terminal.

  1. Actualiza el sistema:

    sudo apt-get update
    sudo apt-get upgrade
    

  2. Instala Docker:

    curl -sSL https://get.docker.com | sh
    
  3. Si deseas usar Docker como un usuario no raíz, sin requerir sudo antes de cada comando, modifica la configuración del usuario. Sal de la cuenta para que se apliquen los cambios:

    sudo usermod -aG docker $USER
    

  4. Inicia Docker si aún no se está ejecutando:

    sudo dockerd
    

  5. Instala Git:

    sudo apt install git
    
    .

  6. Las secuencias de comandos de firewall de OTBR crean reglas dentro del contenedor de Docker. Ejecuta modprobe a fin de cargar los módulos de kernel para iptables:

    sudo modprobe ip6table_filter
    

Configuración de Linux

Usa las mismas instrucciones que el RPi:

  1. Actualiza el sistema:

    sudo apt-get update
    sudo apt-get upgrade
    

  2. Instala Docker:

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

  3. Si deseas usar Docker como un usuario no raíz, sin requerir sudo antes de cada comando, modifica la configuración del usuario. Sal de la cuenta para que se apliquen los cambios:

    sudo usermod -aG docker $USER
    

  4. Inicia Docker si aún no se está ejecutando:

    sudo dockerd
    

  5. Instala Git:

    sudo apt install git
    
    .

  6. Las secuencias de comandos de firewall de OTBR crean reglas dentro del contenedor de Docker. Ejecuta modprobe a fin de cargar los módulos de kernel para iptables:

    sudo modprobe ip6table_filter
    

Mac o Windows

Para usar Docker de OTBR en Mac o Windows, instala la Caja de herramientas de Docker. Esto es necesario, ya que ejecutar OTBR de Docker implica activar puertos en serie virtuales, que solo son compatibles con la caja de herramientas de Docker en esos sistemas.

Obtén la imagen de Docker de OTBR

Obtén la imagen de Docker de OTBR; para ello, extráela directamente de OpenThread Docker Hub o clona el repositorio de OTBR y compila el Dockerfile incluido de forma local.

Recomendamos extraer la imagen de Docker Hub, ya que el equipo de OpenThread la probó y verificó.

Extrae la imagen de Docker Hub

Esta imagen corresponde al ID de confirmación e80def4.

  1. Extrae la imagen:

    docker pull openthread/otbr:latest
    

  2. Ahora debería aparecer en tu lista de imágenes de Docker:

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

Compila el Dockerfile

Para crear la imagen, clona el repositorio del router de borde de OpenThread y compila el Dockerfile incluido.

  1. Clona el repositorio de OTBR:

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

  2. Compila el Dockerfile:

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