Ringkasan

Lihat sumber di GitHub

OpenThread Border Router (OTBR) menyediakan dukungan untuk Docker, dan dapat dijalankan di container Docker, bukan di mesin lokal Anda secara langsung.

Panduan ini berfokus pada menjalankan OTBR Docker pada Raspberry Pi (RPi) atau mesin berbasis Linux apa pun, dan hanya diuji di platform tersebut.

Penyiapan Raspberry Pi

Instal OS Raspberry Pi OS dengan Desktop di RPi. Ikuti petunjuk dalam langkah Download and Install OS dari Ringkasan Raspberry Pi, tetapi pastikan untuk menggunakan Raspberry Pi OS dengan Desktop sebagai OS. Anda tidak dapat menggunakan versi Lite, karena Anda perlu mengakses UI Web GOTBR di browser web.

Setelah diinstal, booting RPi dan buka jendela terminal.

  1. Update sistem:

    sudo apt-get update
    sudo apt-get upgrade
    

  2. Instal Docker:

    curl -sSL https://get.docker.com | sh
    
  3. Jika Anda ingin menggunakan Docker sebagai non-root, tanpa memerlukan sudo sebelum setiap perintah, ubah setelan pengguna. Logout agar perubahan diterapkan:

    sudo usermod -aG docker $USER
    

  4. Mulai Docker jika belum berjalan:

    sudo dockerd
    

  5. Instal git:

    sudo apt install git
    

  6. Skrip firewall OTBR membuat aturan di dalam container Docker. Jalankan modprobe untuk memuat modul kernel iptables:

    sudo modprobe ip6table_filter
    

Penyiapan Linux

Gunakan petunjuk yang sama seperti RPi:

  1. Update sistem:

    sudo apt-get update
    sudo apt-get upgrade
    

  2. Instal Docker:

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

  3. Jika Anda ingin menggunakan Docker sebagai non-root, tanpa memerlukan sudo sebelum setiap perintah, ubah setelan pengguna. Logout agar perubahan diterapkan:

    sudo usermod -aG docker $USER
    

  4. Mulai Docker jika belum berjalan:

    sudo dockerd
    

  5. Instal git:

    sudo apt install git
    

  6. Skrip firewall OTBR membuat aturan di dalam container Docker. Jalankan modprobe untuk memuat modul kernel iptables:

    sudo modprobe ip6table_filter
    

Mac atau Windows

Untuk menggunakan Docker OTBR di Mac atau Windows, instal Docker Toolbox. Ini diperlukan karena menjalankan OTBR Docker melibatkan pemasangan port serial virtual, yang hanya didukung oleh Docker Toolbox pada sistem tersebut.

Mendapatkan image OTBR Docker

Dapatkan image Docker OTBR dengan menariknya langsung dari Hub Docker OpenThread, atau dengan meng-clone repositori OTBR dan mem-build Dockerfile yang disertakan secara lokal.

Sebaiknya ambil image dari Docker Hub, karena image tersebut telah diuji dan diverifikasi oleh tim OpenThread.

Mengambil image dari Docker Hub

Image ini per ID Komitmen e80def4.

  1. Ambil gambar:

    docker pull openthread/otbr:latest
    

  2. File tersebut kini akan muncul dalam daftar image Docker:

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

Mem-build Dockerfile

Untuk membuat image sendiri, clone repositori OpenThread Border Router dan build Dockerfile yang disertakan.

  1. Clone repositori OTBR:

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

  2. Build Dockerfile:

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