概览

在 GitHub 上查看源代码

OpenThread 边界路由器 (OTBR) 支持 Docker,可在 Docker 容器中运行,而不是直接在本地机器上运行。

本指南重点介绍如何在 Raspberry Pi (RPi) 上运行 OTBR Docker。

Raspberry Pi 设置

在 RPi 上安装 Raspberry Pi OS with Desktop 操作系统。桌面版和精简版均可使用。

安装完成后,启动 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 边界路由器代码库并构建其中包含的 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 .