OpenThread Border Router (OTBR) 提供 Docker 支援,且可在 Docker 容器中執行,而非直接在本機電腦上執行。
本指南著重在 Raspberry Pi (RPi) 或任何 Linux 機器上執行 OTBR Docker,且僅在這些平台上進行測試。
Raspberry Pi 設定
在 RPi 上安裝 Raspberry Pi OS with Desktop。按照 Raspberry Pi 總覽中,下載並安裝下載及安裝 OS 步驟中的指示操作,但務必使用 Raspberry Pi OS with Desktop 做為作業系統。您無法使用 Lite 版本,因為您需要透過網路瀏覽器存取 OTBR Web GUI。
安裝完成後,啟動 RPi 並開啟終端機視窗。
更新系統:
sudo apt-get update
sudo apt-get upgrade
安裝 Docker:
curl -sSL https://get.docker.com | sh
如要使用 Docker 作為非根層級,且不需要在每個指令前使用
sudo
,請修改使用者設定。登出即可讓變更生效:sudo usermod -aG docker $USER
如果 Docker 尚未執行,請啟動 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 作為非根層級,且不需要在每個指令前使用
sudo
,請修改使用者設定。登出即可讓變更生效:sudo usermod -aG docker $USER
如果 Docker 尚未執行,請啟動 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 映像檔
如要取得 OTBR Docker 映像檔,您可以直接從 OpenThread Docker Hub 提取映像檔,或是複製 OTBR 存放區並在本機建構內含的 Dockerfile。
建議從 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 Border 路由器存放區並建構隨附的 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 .