Tổng quan

Xem nguồn trên GitHub

OpenThread Border Router (OTBR) hỗ trợ Docker và có thể chạy trong vùng chứa Docker thay vì trực tiếp trên máy cục bộ của bạn.

Hướng dẫn này tập trung vào cách chạy OTBR Docker trên Raspberry Pi (RPi) hoặc bất kỳ máy chạy trên Linux nào, và chỉ mới được thử nghiệm trên các nền tảng đó.

Thiết lập Piaspberry Pi

Cài đặt hệ điều hành Raspberry Pi OS với máy tính trên RPi. Làm theo các hướng dẫn trong bước Download and Install OS (Tải và cài đặt hệ điều hành) từ phần Tổng quan về Raspberry Pi, nhưng hãy nhớ sử dụng Raspberry Pi OS với máy tính. Bạn không thể sử dụng phiên bản Lite, vì bạn cần truy cập OTBR Web GUI trong trình duyệt web.

Sau khi cài đặt, hãy khởi động RPi và mở một cửa sổ dòng lệnh.

  1. Cập nhật hệ thống:

    sudo apt-get update
    sudo apt-get upgrade
    

  2. Cài đặt Docker:

    curl -sSL https://get.docker.com | sh
    
  3. Nếu bạn muốn sử dụng Docker dưới dạng không phải gốc, mà không yêu cầu sudo trước mỗi lệnh, hãy sửa đổi chế độ cài đặt người dùng. Đăng xuất để các thay đổi có hiệu lực:

    sudo usermod -aG docker $USER
    

  4. Khởi động Docker nếu nó chưa chạy:

    sudo dockerd
    

  5. Cài đặt git:

    sudo apt install git
    

  6. Tập lệnh tường lửa OTBR tạo các quy tắc bên trong vùng chứa Docker. Chạy modprobe để tải các mô-đun hạt nhân cho iptables:

    sudo modprobe ip6table_filter
    

Thiết lập Linux

Làm theo các hướng dẫn như RPi:

  1. Cập nhật hệ thống:

    sudo apt-get update
    sudo apt-get upgrade
    

  2. Cài đặt Docker:

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

  3. Nếu bạn muốn sử dụng Docker dưới dạng không phải gốc, mà không yêu cầu sudo trước mỗi lệnh, hãy sửa đổi chế độ cài đặt người dùng. Đăng xuất để các thay đổi có hiệu lực:

    sudo usermod -aG docker $USER
    

  4. Khởi động Docker nếu nó chưa chạy:

    sudo dockerd
    

  5. Cài đặt git:

    sudo apt install git
    

  6. Tập lệnh tường lửa OTBR tạo các quy tắc bên trong vùng chứa Docker. Chạy modprobe để tải các mô-đun hạt nhân cho iptables:

    sudo modprobe ip6table_filter
    

Máy Mac hoặc Windows

Để sử dụng OTBR Docker trên máy Mac hoặc Windows, hãy cài đặt Docker Toolbox. Điều này là bắt buộc vì đang chạy OTBR Docker bao gồm các cổng nối tiếp ảo, chỉ được Hộp công cụ Docker hỗ trợ trên các hệ thống đó.

Tải hình ảnh Docker OTBR

Lấy hình ảnh OTBR Docker bằng cách kéo trực tiếp từ OpenThread Docker Hub (Trung tâm Docker Docker) hoặc bằng cách sao chép kho lưu trữ OTBR và tạo Dockerfile được bao gồm cục bộ.

Bạn nên lấy hình ảnh từ Docker Hub, vì hình ảnh này đã được nhóm OpenThread kiểm thử và xác minh.

Kéo hình ảnh từ Docker Hub

Hình ảnh này thuộc về Cam kết e80def4.

  1. Kéo hình ảnh:

    docker pull openthread/otbr:latest
    

  2. Bây giờ, hình ảnh đó sẽ xuất hiện trong danh sách hình ảnh Docker của bạn:

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

Tạo Dockerfile

Để tự tạo hình ảnh, hãy sao chép kho lưu trữ OpenThread Border Router và tạo Dockerfile đi kèm.

  1. Nhân bản kho lưu trữ OTBR:

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

  2. Tạo Dockerfile:

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