OpenThreadBorderRouter-HA

Docker 应用程序 from pureelectricity's Repository

概述

OpenThread Border Router (Home Assistant Optimized) This container runs an OpenThread Border Router (OTBR) specifically tweaked for integration with Home Assistant via the Silicon Labs EFR32MG21 chipset (SkyConnect, ZBT-1, Sonoff ZBDongle-E). CRITICAL PREREQUISITES - READ BEFORE INSTALLING: 1. Enable IPv6 in Unraid: Navigate to Settings > Network Settings. Ensure "Network Protocol" is set to IPv4 + IPv6. If this is disabled, Thread networking will not function. 2. Host Kernel Configuration (Persistence Required): Unraid resets network forwarding rules on every reboot. You must apply the following commands on the Unraid Host to prevent the Thread network from breaking. Commands to run: [code] sysctl -w net.ipv6.conf.all.forwarding=1 sysctl -w net.ipv6.conf.br0.accept_ra=2 sysctl -w net.ipv6.conf.eth0.accept_ra=2 [/code] How to automate this (Choose one): Option A: User Scripts Plugin (Recommended) Install the "User Scripts" plugin. Create a new script with the commands above and set it to run "At Startup of Array". Option B: The Go File (Native) Edit the file /boot/config/go on your flash drive and add the commands to the bottom of the file. This will execute them during the boot sequence. 3. USB Firmware: Your USB stick MUST be flashed with OpenThread RCP Firmware at 460800 baud. (Multiprotocol firmware is not supported). Configuration Notes: - Network Type: Must be Host for mDNS discovery. - WebUI Port: Default is 8099 (to avoid conflict with Unraid Port 80).

运行时参数

网络用户界面: http://[IP]:[PORT:8099]/
网络: host
外壳: bash
特权: true
额外参数: --cap-add=SYS_ADMIN --cap-add=NET_ADMIN --sysctl "net.ipv6.conf.all.disable_ipv6=0" --sysctl "net.ipv4.conf.all.forwarding=1" --sysctl "net.ipv6.conf.all.forwarding=1"

模板配置

Radio Device (Passthrough)Devicerw

Map your physical USB stick here (use /dev/serial/by-id/...). It maps to /dev/ttyUSB0 inside the container.

目标: /dev/ttyUSB0
默认值: /dev/serial/by-id/YOUR_DEVICE_HERE

Radio Path (Internal)Variable

The internal path to the radio. Leave this as /dev/ttyUSB0 matching the internal side of the device mapping above.

目标: DEVICE
默认值: /dev/ttyUSB0
价值: /dev/ttyUSB0

BaudrateVariable

Baudrate for RCP Firmware. SkyConnect/ZBT-1/Sonoff-E usually use 460800.

目标: BAUDRATE
默认值: 460800
价值: 460800

Flow ControlVariable

Hardware Flow Control. Set to 1 for SkyConnect/ZBT-1. Set to 0 if using a generic stick without flow control support.

目标: FLOW_CONTROL
默认值: 1
价值: 1

Backbone InterfaceVariable

The Unraid Host interface connected to your LAN/Internet. Usually br0 or eth0.

目标: BACKBONE_IF
默认值: br0
价值: br0

OTBR WebUI PortVariable

Port for the OTBR Web Interface. Changed from default 80 to prevent conflict with Unraid.

目标: OTBR_WEB_PORT
默认值: 8099
价值: 8099

OTBR REST PortVariable

Port for the REST API (Used by Home Assistant).

目标: OTBR_REST_PORT
默认值: 8081
价值: 8081

Enable NAT64Variable

Enable NAT64 translation.

目标: NAT64
默认值: 1
价值: 1

Enable FirewallVariable

Enable internal firewall.

目标: FIREWALL
默认值: 1
价值: 1

Data StoragePathrw

Persistent storage for Thread credentials and dataset.

目标: /data/thread
默认值: /mnt/user/appdata/otbr

TUN AdapterDevicerw

Required for creating the wpan0 network interface.

目标: /dev/net/tun
默认值: /dev/net/tun
价值: /dev/net/tun

Local TimePathro

Sync time with host.

目标: /etc/localtime
默认值: /etc/localtime
价值: /etc/localtime

Auto-Flash FirmwareVariable

Disable automatic firmware flashing attempts.

目标: AUTOFLASH_FIRMWARE
默认值: 0
价值: 0

Log LevelVariable

Log verbosity (info, debug, warn).

目标: OTBR_LOG_LEVEL
默认值: info
价值: info

类别

Home Automation Tools > Utilities

链接

模板支持登记处 Pro连接

详细信息

存储库

ghcr.io/ownbee/hass-otbr-docker:latest

登记处

https://github.com/ownbee/hass-otbr-docker

最后更新2026-05-31

初见2025-12-15

在Unraid 上运行 OpenThreadBorderRouter-HA 。

OpenThreadBorderRouter-HA 已被列入Unraid OS 的社区应用程序。探索Unraid ，构建灵活的家庭服务器、NAS 或家庭实验室。

探索Unraid OS