Tổng quan

Xem nguồn trên GitHub

Bộ định tuyến biên giới OpenThread (OTBR) cung cấp 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 việc chạy OTBR Docker trên Raspberry Pi (RPi) hoặc bất kỳ máy nào dựa trên Linux và chỉ mới được thử nghiệm trên các nền tảng đó.

Thiết lập Raspberry Pi

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

Sau khi cài đặt, hãy khởi động RPi và mở cửa sổ đầu cuối.

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 thư mục 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 ứng dụng này 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

Hãy làm theo hướng dẫn tương tự 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 thư mục 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 ứng dụng này 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
   

Mac hoặc Windows

Để sử dụng OTBR Docker trên Mac hoặc Windows, hãy cài đặt Docker Toolbox. Đây là yêu cầu bắt buộc khi bạn chạy OTBR Docker liên quan đến việc kết nối các cổng nối tiếp ảo, chỉ được Docker Hộp công cụ hỗ trợ trên các hệ thống đó.

Lấy hình ảnh OTBR Docker

Lấy hình ảnh OTBR Docker bằng cách kéo hình ảnh đó trực tiếp từ OpenThread Docker Hub hoặc bằng cách sao chép kho lưu trữ OTBR và xây dựng Dockerfile đi kè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 thử nghiệm và xác minh.

Lấy hình ảnh từ Docker Hub

Hình ảnh này có tên trong Mã cam kết e80def4.

1. Kéo hình ảnh:

   docker pull openthread/otbr:latest
   

2. Lúc này, 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ữ Trình định tuyến đường biên OpenOpen và tạo Dockerfile đi kèm.

1. Sao chép 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 .