總覽

在 GitHub 上查看來源

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

本指南著重於在 Raspberry Pi (RPi) 上執行 OTBR Docker。

Raspberry Pi 設定

在 RPi 上安裝 Raspberry Pi OS with Desktop 作業系統。電腦版和 Lite 版皆可使用。

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

  1. 更新系統:

    sudo apt-get update
    sudo apt-get upgrade
    

  2. 安裝 Docker:

    curl -sSL https://get.docker.com | sh
    
  3. 如果您想以非 root 使用者身分使用 Docker,且不必在每個指令前加上 sudo,請修改使用者設定。登出以利變更生效:

    sudo usermod -aG docker $USER
    

  4. 啟動 Docker (如果尚未執行的話):

    sudo dockerd
    

  5. 啟用 IP 轉送

    Linux 通常會預設停用 IP 轉送。執行 setup-host 指令碼,在主機系統上啟用 IP 轉送功能。

    curl -sSL https://raw.githubusercontent.com/openthread/ot-br-posix/refs/heads/main/etc/docker/border-router/setup-host | bash
    

取得 OTBR Docker 映像檔

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

建議您從 Docker Hub 提取映像檔,因為該檔案已由 OpenThread 團隊測試及驗證。

從 Docker Hub 提取映像檔

  1. 提取映像檔:

    docker pull openthread/border-router:latest
    

  2. 它現在應該會顯示在 Docker 映像檔清單中:

    docker images
    REPOSITORY                 TAG       IMAGE ID       CREATED       SIZE
    openthread/border-router   latest    08666d77013d   2 hours ago   171MB
    

建構 Dockerfile

如要自行建立映像檔,請複製 OpenThread Border Router 存放區,並建構所附 Dockerfile。

  1. 安裝 Git:

    sudo apt install git
    

  2. 複製 OTBR 存放區:

    cd ~
    git clone https://github.com/openthread/ot-br-posix
    cd ot-br-posix
    

  3. 建構 Dockerfile:

    docker build --no-cache -t openthread/border-router -f etc/docker/border-router/Dockerfile .