總覽

前往 GitHub 查看原始碼

OpenThread 邊界路由器 (OTBR) 支援 Docker,可在 不必直接在本機電腦上部署 Docker 容器

本指南著重於在 Raspberry Pi (RPi) 上執行 OTBR Docker 採用 Linux 架構的機器,而且只在這些平台上進行測試。

Raspberry Pi 設定

安裝 Raspberry Pi OS 電腦 RPi 的 OS。請按照下載及安裝 OS 步驟,從 所以請務必使用 Raspberry Pi OS 電腦做為 OS。

安裝完成後,請啟動 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 尚未執行,請啟動:

    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 尚未執行,請啟動:

    sudo dockerd
    

  5. 安裝 Git:

    sudo apt install git
    

  6. OTBR 防火牆指令碼在 Docker 容器內建立規則。 執行 modprobe 來載入 iptables 的核心模組:

    sudo modprobe ip6table_filter
    

Mac 或 Windows

如要在 Mac 或 Windows 上使用 OTBR Docker,請安裝 Docker Toolbox。執行 OTBR 時必須填寫此欄位 Docker 需要掛接虛擬序列埠,而這些序列僅受 Docker 支援 這些工具

取得 OTBR Docker 映像檔

直接從 OpenThread Docker 提取 OTBR 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 邊界路由器存放區 建構內含的 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 .