總覽

前往 GitHub 查看原始碼

OpenThread Border Router (OTBR) 提供 Docker 支援,且可在 Docker 容器中執行,而非直接在本機電腦上執行。

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

Raspberry Pi 設定

在 RPi 上安裝 Raspberry Pi OS with Desktop。按照 Raspberry Pi 總覽中,下載並安裝下載及安裝 OS 步驟中的指示操作,但務必使用 Raspberry Pi OS with Desktop 做為作業系統。您無法使用 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 作為非根層級,且不需要在每個指令前使用 sudo,請修改使用者設定。登出即可讓變更生效:

    sudo usermod -aG docker $USER
    

  4. 如果 Docker 尚未執行,請啟動 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 尚未執行,請啟動 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 映像檔

如要取得 OTBR Docker 映像檔,您可以直接從 OpenThread Docker Hub 提取映像檔,或是複製 OTBR 存放區並在本機建構內含的 Dockerfile。

建議從 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 Border 路由器存放區並建構隨附的 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 .