在自定义Docker网络中运行OpenThread边界路由器的问题

第一步：永久配置主机网络参数（必做） #

OTBR依赖主机的IPv4/IPv6转发能力，先把参数写入配置文件避免重启失效：

1. 编辑/etc/sysctl.conf，添加以下内容：

net.ipv6.conf.all.disable_ipv6=0
net.ipv4.conf.all.forwarding=1
net.ipv6.conf.all.forwarding=1

2. 生效配置：

sudo sysctl -p

第二步：确保Docker daemon支持IPv6 #

编辑/etc/docker/daemon.json（不存在则创建），添加IPv6支持：

{
  "ipv6": true,
  "fixed-cidr-v6": "fd00:dead:beef::/64"
}

重启Docker服务：

sudo systemctl restart docker

方案一：带多播支持的自定义桥接网络 #

适合不想改变容器网络拓扑，仅需映射端口的场景：

1. 创建支持IPv6和多播的自定义网络 #

docker network create \
  --driver bridge \
  --subnet=192.168.200.0/24 \
  --gateway=192.168.200.1 \
  --ipv6 \
  --subnet=fd00:dead:beef::/64 \
  --opt com.docker.network.bridge.enable_icc=true \
  --opt com.docker.network.bridge.enable_ip_masquerade=true \
  --opt com.docker.network.bridge.name=otbr-bridge \
  --opt com.docker.network.driver.mtu=1500 \
  --opt com.docker.network.enable_ipv6=true \
  --opt com.docker.network.bridge.enable_multicast=true \
  otbr-net

2. 配置主机iptables允许多播流量 #

确保容器的mDNS多播包能被局域网设备接收：

sudo iptables -I FORWARD -i otbr-bridge -d 224.0.0.0/4 -j ACCEPT
sudo iptables -I FORWARD -o otbr-bridge -s 224.0.0.0/4 -j ACCEPT
sudo ip6tables -I FORWARD -i otbr-bridge -d ff00::/8 -j ACCEPT
sudo ip6tables -I FORWARD -o otbr-bridge -s ff00::/8 -j ACCEPT

3. 启动OTBR容器 #

docker run \
  --sysctl "net.ipv6.conf.all.disable_ipv6=0" \
  --net=otbr-net \
  -p 8080:80 \
  --dns=127.0.0.1 \
  -it \
  --volume /dev/ttyACM0:/dev/ttyACM0 \
  --privileged \
  openthread/otbr \
  --radio-url spinel+hdlc+uart:///dev/ttyACM0

方案二：Macvlan网络（推荐，更适配局域网设备发现） #

让容器直接接入本地局域网二层，拥有独立的局域网IP，Google Home可直接通过mDNS发现，无需端口映射（如果80端口未被局域网其他设备占用）：

1. 确认主机物理网卡信息 #

执行ip addr查看你的物理网卡（比如eth0）、局域网IPv4子网（比如192.168.1.0/24）、IPv4网关（比如192.168.1.1）、IPv6子网（比如2001:db8::/64）、IPv6网关（比如2001:db8::1）。

2. 创建Macvlan网络 #

替换以下参数为你的实际网络信息：

docker network create \
  --driver macvlan \
  --subnet=192.168.1.0/24 \
  --gateway=192.168.1.1 \
  --ipv6 \
  --subnet=2001:db8::/64 \
  --gateway=2001:db8::1 \
  --opt parent=eth0 \
  otbr-macvlan

3. 启动OTBR容器 #

可选指定固定IP避免冲突，替换为你预留的局域网IP：

docker run \
  --sysctl "net.ipv6.conf.all.disable_ipv6=0" \
  --net=otbr-macvlan \
  --ip=192.168.1.100 \
  --ip6=2001:db8::100 \
  --dns=192.168.1.1 \
  -it \
  --volume /dev/ttyACM0:/dev/ttyACM0 \
  --privileged \
  openthread/otbr \
  --radio-url spinel+hdlc+uart:///dev/ttyACM0

注意 #

Macvlan网络下，主机和容器无法直接通信（二层隔离），但局域网内其他设备（如Google Home）可正常访问容器，不影响OTBR的功能。

内容的提问来源于stack exchange，提问作者Cilenco