نظرة عامة

عرض المصدر على GitHub

يوفّر جهاز توجيه الحدود لـ OpenThread (OTBR) دعمًا لـ Docker، ويمكن تشغيله في حاوية Docker بدلاً من ذلك على جهازك المحلي مباشرة.

يركّز هذا الدليل على تشغيل OTBR Docker على Raspberry Pi (RPi) أو أي جهاز يعمل بنظام التشغيل Linux، وقد تم اختباره على تلك الأنظمة الأساسية فقط.

إعداد Raspberry Pi

ثبِّت نظام التشغيل Raspberry Pi OS مع سطح المكتب على جهاز RPI. اتّبِع التعليمات الواردة في الخطوة تنزيل وتثبيت نظام التشغيل من نظرة عامة على Raspberry Pi، ولكن احرص على استخدام Raspberry Pi OS مع Desktop كنظام التشغيل. لا يمكنك استخدام الإصدار البسيط، نظرًا لأنه يلزمك الدخول إلى واجهة المستخدم التصويرية على الويب عبر OTBR في متصفح ويب.

وبعد اكتمال التثبيت، يمكنك تشغيل 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 لتحميل وحدات kernel لـ 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 لتحميل وحدات kernel لـ iptables:

    sudo modprobe ip6table_filter
    

نظام التشغيل Mac أو Windows

لاستخدام OTBR Docker على نظام التشغيل Mac أو Windows، ثبِّت مجموعة أدوات Docker. ويجب تنفيذ ذلك لأن تشغيل OTBR يتضمن Docker تثبيت منافذ تسلسلية افتراضية، والتي لا يدعمها إلا صندوق أدوات Docker على هذه الأنظمة.

الحصول على صورة Docker عبر OTBR

احصل على صورة OTBR Docker عن طريق سحبها مباشرةً من 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

لإنشاء الصورة بنفسك، يمكنك إنشاء نسخة طبق الأصل من مستودع موجه OpenThread Border Router وإنشاء ملف 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 .