OpenThread 边界路由器 (OTBR) 支持 Docker,可在 Docker 容器中运行,而不是直接在本地机器上运行。
本指南重点介绍如何在 Raspberry Pi (RPi) 上运行 OTBR Docker。
Raspberry Pi 设置
在 RPi 上安装 Raspberry Pi OS with Desktop 操作系统。桌面版和精简版均可使用。
安装完成后,启动 RPi 并打开一个终端窗口。
更新系统:
sudo apt-get update
sudo apt-get upgrade
安装 Docker:
curl -sSL https://get.docker.com | sh
如果您想以非 root 用户身份使用 Docker,而不必在每次使用命令之前输入
sudo
,请修改您的用户设置。退出账号以使更改生效:sudo usermod -aG docker $USER
启动 Docker(如果尚未运行):
sudo dockerd
启用 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 拉取映像
拉取映像:
docker pull openthread/border-router:latest
它现在应该会显示在您的 Docker 映像列表中:
docker images
REPOSITORY TAG IMAGE ID CREATED SIZE openthread/border-router latest 08666d77013d 2 hours ago 171MB
构建 Dockerfile
如需自行创建映像,请克隆 OpenThread 边界路由器代码库并构建其中包含的 Dockerfile。
安装 git:
sudo apt install git
克隆 OTBR 代码库:
cd ~
git clone https://github.com/openthread/ot-br-posix
cd ot-br-posix
构建 Dockerfile:
docker build --no-cache -t openthread/border-router -f etc/docker/border-router/Dockerfile .