OpenThread 邊界路由器 (OTBR) 支援 Docker,可直接在 Docker 容器中執行,而不需要在本機電腦上執行。
本指南著重於在 Raspberry Pi (RPi) 或任何以 Linux 為基礎的機器上執行 OTBR Docker,且僅已在這些平台上進行測試。
Raspberry Pi 設定
在 RPi 上安裝桌機專用 Raspberry Pi OS OS。從 Raspberry Pi 總覽中下載及安裝 OS 的步驟,但請務必使用電腦專用 Raspberry Pi OS作業系統。您無法使用 Lite 版本,因為需要透過網路瀏覽器存取 OTBR Web GUI。
安裝完成後,請啟動 RPi 並開啟終端機視窗。
更新系統:
sudo apt-get update
sudo apt-get upgrade
安裝 Docker:
curl -sSL https://get.docker.com | sh
如要使用 Docker 做為非 Root 權限,但不在每次指令前都要求使用
sudo
,請修改使用者設定。登出變更以生效:sudo usermod -aG docker $USER
如果 Docker 尚未執行,請將其啟動:
sudo dockerd
安裝 Git:
sudo apt install git
OTBR 防火牆指令碼會在 Docker 容器中建立規則。執行
modprobe
來載入iptables
的核心模組:sudo modprobe ip6table_filter
Linux 設定
請使用與 RPi 相同的操作說明:
更新系統:
sudo apt-get update
sudo apt-get upgrade
安裝 Docker:
curl -sSL https://get.docker.com | sh
如要使用 Docker 做為非 Root 權限,但不在每次指令前都要求使用
sudo
,請修改使用者設定。登出變更以生效:sudo usermod -aG docker $USER
如果 Docker 尚未執行,請將其啟動:
sudo dockerd
安裝 Git:
sudo apt install git
OTBR 防火牆指令碼會在 Docker 容器中建立規則。執行
modprobe
來載入iptables
的核心模組:sudo modprobe ip6table_filter
Mac 或 Windows
如要在 Mac 或 Windows 上使用 OTBR Docker,請安裝 Docker 工具箱。執行 OTBR Docker 時牽涉到這些作業需要掛接虛擬序列埠,只有這些系統上的 Docker Toolbox 才支援這項功能。
取得 OTBR Docker 映像檔
您可以直接從 OpenThread Docker Hub Hub 中提取 OTBR Docker 映像檔,或在本機複製 OTBR 存放區並建立包含的 Dockerfile,藉此取得 OTBR Docker 映像檔。
建議您從 Docker Hub 中提取映像檔,因為該映像檔已通過 OpenThread 團隊的測試與驗證。
從 Docker Hub 提取映像檔
此映像檔的修訂版本 ID 為 e80def4
。
提取映像檔:
docker pull openthread/otbr:latest
您的 Docker 映像檔清單中現在會顯示這個名稱:
docker images
REPOSITORY TAG IMAGE ID CREATED SIZE openthread/otbr latest 98416559dcbd 2 weeks ago 1.15GB
建構 Dockerfile
如要自行建立映像檔,請複製 OpenThread 邊界路由器存放區,然後建構隨附的 Dockerfile。
複製 OTBR 存放區:
cd ~
git clone https://github.com/openthread/ot-br-posix
cd ot-br-posix
建構 Dockerfile:
docker build --no-cache -t openthread/otbr -f etc/docker/Dockerfile .