總覽

透過集合功能整理內容 你可以依據偏好儲存及分類內容。

前往 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 做為作業系統。無法使用網路瀏覽器版本,因為您需要透過網路瀏覽器存取 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 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 .