總覽

在 GitHub 中查看來源

OpenThread 邊界路由器 (OTBR) 支援 Docker,可直接在 Docker 容器中執行,而不需要在本機電腦上執行。

本指南著重於在 Raspberry Pi (RPi) 或任何以 Linux 為基礎的機器上執行 OTBR Docker,且僅已在這些平台上進行測試。

Raspberry Pi 設定

在 RPi 上安裝桌機專用 Raspberry Pi OS OS。從 Raspberry Pi 總覽中下載及安裝 OS 的步驟,但請務必使用電腦專用 Raspberry Pi OS作業系統。您無法使用 Lite 版本,因為需要透過網路瀏覽器存取 OTBR Web GUI。

安裝完成後,請啟動 RPi 並開啟終端機視窗。

  1. 更新系統:

    sudo apt-get update
    sudo apt-get upgrade
    

  2. 安裝 Docker:

    curl -sSL https://get.docker.com | sh
    
  3. 如要使用 Docker 做為非 Root 權限,但不在每次指令前都要求使用 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 做為非 Root 權限,但不在每次指令前都要求使用 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

如要在 Mac 或 Windows 上使用 OTBR Docker,請安裝 Docker 工具箱。執行 OTBR Docker 時牽涉到這些作業需要掛接虛擬序列埠,只有這些系統上的 Docker Toolbox 才支援這項功能。

取得 OTBR Docker 映像檔

您可以直接從 OpenThread Docker Hub Hub 中提取 OTBR Docker 映像檔,或在本機複製 OTBR 存放區並建立包含的 Dockerfile,藉此取得 OTBR Docker 映像檔。

建議您從 Docker Hub 中提取映像檔,因為該映像檔已通過 OpenThread 團隊的測試與驗證。

從 Docker Hub 提取映像檔

此映像檔的修訂版本 ID 為 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 邊界路由器存放區,然後建構隨附的 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 .