ภาพรวม

ดูแหล่งที่มาบน GitHub

OpenThread Border Router (OTBR) รองรับ Docker และเรียกใช้ในคอนเทนเนอร์ Docker แทนที่จะเรียกใช้ในเครื่องโดยตรงได้

คู่มือนี้มุ่งเน้นที่การเรียกใช้ Docker OTBR บน Raspberry Pi (RPi) หรือเครื่องที่ใช้ Linux และผ่านการทดสอบบนแพลตฟอร์มเหล่านั้นเท่านั้น

การตั้งค่า Raspberry Pi

ติดตั้ง Raspberry Pi OS ที่มี Desktop OS ใน RPi ทำตามวิธีการในขั้นตอนดาวน์โหลดและติดตั้ง OS จากภาพรวมของ Raspberry Pi แต่ให้ใช้ Raspberry Pi OS กับ เดสก์ท็อปเป็นระบบปฏิบัติการ

เมื่อติดตั้งแล้ว ให้เปิดเครื่อง RPi และเปิดหน้าต่างเทอร์มินัล

  1. อัปเดตระบบโดยทำดังนี้

    sudo apt-get update
    sudo apt-get upgrade
    

  2. ติดตั้ง Docker:

    curl -sSL https://get.docker.com | sh
    
  3. หากต้องการใช้ Docker ที่ไม่ใช่รูทโดยไม่ต้องใช้ sudo ก่อนคำสั่งแต่ละรายการ ให้แก้ไขการตั้งค่าผู้ใช้ โปรดออกจากระบบเพื่อให้การเปลี่ยนแปลงมีผล:

    sudo usermod -aG docker $USER
    

  4. เริ่มใช้ Docker หากไม่ได้ทำงานอยู่แล้ว:

    sudo dockerd
    

  5. ติดตั้ง Git:

    sudo apt install git
    

  6. สคริปต์ไฟร์วอลล์ OTBR สร้างกฎภายในคอนเทนเนอร์ Docker เรียกใช้ modprobe เพื่อโหลดโมดูลเคอร์เนลสำหรับ iptables ดังนี้

    sudo modprobe ip6table_filter
    

การตั้งค่า Linux

ใช้วิธีการเดียวกันกับ RPi ดังนี้

  1. อัปเดตระบบโดยทำดังนี้

    sudo apt-get update
    sudo apt-get upgrade
    

  2. ติดตั้ง Docker โดยทำดังนี้

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

  3. หากต้องการใช้ Docker ที่ไม่ใช่รูทโดยไม่ต้องใช้ sudo ก่อนคำสั่งแต่ละรายการ ให้แก้ไขการตั้งค่าผู้ใช้ โปรดออกจากระบบเพื่อให้การเปลี่ยนแปลงมีผล:

    sudo usermod -aG docker $USER
    

  4. เริ่มใช้ Docker หากไม่ได้ทำงานอยู่แล้ว:

    sudo dockerd
    

  5. ติดตั้ง Git:

    sudo apt install git
    

  6. สคริปต์ไฟร์วอลล์ OTBR สร้างกฎภายในคอนเทนเนอร์ Docker เรียกใช้ modprobe เพื่อโหลดโมดูลเคอร์เนลสำหรับ iptables ดังนี้

    sudo modprobe ip6table_filter
    

Mac หรือ Windows

หากต้องการใช้ OTBR Docker ใน Mac หรือ Windows ให้ติดตั้งกล่องเครื่องมือ Docker จำเป็นต้องมีการเชื่อมต่อเนื่องจากการเรียกใช้ OTBR Docker ต้องมีการต่อเชื่อมพอร์ตอนุกรมเสมือนซึ่ง Docker รองรับ ระบบดังกล่าวเท่านั้น

รับอิมเมจ OTBR Docker

รับอิมเมจ Docker OTBR โดยการดึงอิมเมจดังกล่าวจาก OpenThread Docker Hub โดยตรงหรือโคลนที่เก็บ OTBR และสร้าง Dockerfile ที่รวมในเครื่อง

เราขอแนะนำให้ดึงอิมเมจจาก Docker Hub เนื่องจากมีการทดสอบและยืนยันโดยทีม OpenThread

ดึงอิมเมจจาก Docker Hub

รูปภาพนี้มาจากรหัสสัญญาผูกมัด e80def4

  1. ดึงรูปภาพโดยทำดังนี้

    docker pull openthread/otbr:latest
    

  2. ขณะนี้ควรปรากฏในรายการอิมเมจ Docker ของคุณ:

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

สร้าง Dockerfile

หากต้องการสร้างอิมเมจด้วยตนเอง ให้โคลนที่เก็บ Border Router ของ OpenThread และสร้าง Dockerfile ที่รวมอยู่

  1. โคลนที่เก็บ OTBR ด้วยคำสั่งต่อไปนี้

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

  2. สร้าง Dockerfile ดังนี้

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