Visão geral

Veja o código-fonte no GitHub

O OpenThread Border Router (OTBR) é compatível com o Docker e pode ser executado em um contêiner do Docker em vez de diretamente na sua máquina local.

Este guia se concentra na execução do Docker OTBR no Raspberry Pi (RPi) ou em qualquer máquina baseada em Linux e foi testado apenas nessas plataformas.

Configuração do Raspberry Pi

Instale o SO Raspberry Pi com o computador no RPi. Siga as instruções da etapa Fazer o download e instalar o SO na Visão geral do Raspberry Pi, mas use o SO do Raspberry Pi com o computador como SO. Não é possível usar a versão Lite porque você precisa acessar a GUI na Web do OTBR em um navegador da Web.

Depois da instalação, inicialize a RPi e abra uma janela do terminal.

  1. Atualize o sistema:

    sudo apt-get update
    sudo apt-get upgrade
    

  2. Instale o Docker:

    curl -sSL https://get.docker.com | sh
    
  3. Se você quiser usar o Docker como não raiz, sem exigir sudo antes de cada comando, modifique as configurações do usuário. Saia para que as mudanças entrem em vigor:

    sudo usermod -aG docker $USER
    

  4. Inicie o Docker se ele ainda não estiver em execução:

    sudo dockerd
    

  5. Instale o git:

    sudo apt install git
    

  6. Os scripts de firewall OTBR criam regras dentro do contêiner do Docker. Execute modprobe para carregar os módulos do kernel para iptables:

    sudo modprobe ip6table_filter
    

Configuração do Linux

Use as mesmas instruções da RPi:

  1. Atualize o sistema:

    sudo apt-get update
    sudo apt-get upgrade
    

  2. Instale o Docker:

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

  3. Se você quiser usar o Docker como não raiz, sem exigir sudo antes de cada comando, modifique as configurações do usuário. Saia para que as mudanças entrem em vigor:

    sudo usermod -aG docker $USER
    

  4. Inicie o Docker se ele ainda não estiver em execução:

    sudo dockerd
    

  5. Instale o git:

    sudo apt install git
    

  6. Os scripts de firewall OTBR criam regras dentro do contêiner do Docker. Execute modprobe para carregar os módulos do kernel para iptables:

    sudo modprobe ip6table_filter
    

Mac ou Windows

Para usar o Docker OTBR no Mac ou no Windows, instale o Docker Toolbox. Isso é necessário porque a execução do Docker OTBR envolve a montagem de portas seriais virtuais, que só são compatíveis com o Docker Toolbox nesses sistemas.

Acessar a imagem do Docker OTBR

Consiga a imagem do Docker do OTBR puxando-a diretamente do Hub do Docker do OpenThread ou clonando o repositório do OTBR e criando o Dockerfile incluído localmente.

Recomendamos extrair a imagem do Docker Hub, porque ela foi testada e verificada pela equipe do OpenThread.

Extrair a imagem do Docker Hub

Esta imagem é de um ID de confirmação e80def4.

  1. Extraia a imagem:

    docker pull openthread/otbr:latest
    

  2. Agora ela aparece na sua lista de imagens do Docker:

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

Criar o Dockerfile

Para criar a imagem, clone o repositório do roteador de borda do OpenThread e crie o Dockerfile incluído.

  1. Clone o repositório OTBR:

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

  2. Crie o Dockerfile:

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