本指南介绍如何在AlmaLinux或RHEL上安装ThingsBoard IoT Gateway。
前置条件
-安装Python 3.7或更高版本。
步骤1：下载安装包
下载安装包。
1
wget https://github.com/thingsboard/thingsboard-gateway/releases/latest/download/python3-thingsboard-gateway.rpm
步骤2：使用dnf安装网关
以软件包方式安装ThingsBoard IoT Gateway并作为守护进程运行，执行以下命令：
1
sudo dnf install -y ./python3-thingsboard-gateway.rpm
步骤3：检查网关状态
1
systemctl status thingsboard-gateway
输出中可能出现报错，属正常现象，因网关尚未配置连接ThingsBoard：
1
2
3
4
... python3[7563]: ''2019-12-26 09:31:15' - ERROR - mqtt_connector - 181 - Default Broker connection FAIL with error 5 not authorised!'
... python3[7563]: ''2019-12-26 09:31:15' - DEBUG - mqtt_connector - 186 - "Default Broker" was disconnected.'
... python3[7563]: ''2019-12-26 09:31:16' - DEBUG - tb_client - 78 - connecting to ThingsBoard'
... python3[7563]: ''2019-12-26 09:31:17' - DEBUG - tb_client - 78 - connecting to ThingsBoard'
步骤4：配置网关
参考配置指南配置网关。配置生效需重启网关。
1
systemctl restart thingsboard-gateway
离线构建版本
离线构建是ThingsBoard Gateway软件包的特殊变体，专为无互联网环境下的安装与运行设计。离线构建无需在运行时安装依赖即可使用任意连接器，已预打包全部依赖，包括：
-预构建的Python虚拟环境。
-所有必需的Python包。
-应用wheel（.whl）。
适用于隔离、离线或受限网络环境下的部署。
使用场景示例
某公司全部基础设施部署在私有数据中心。其ThingsBoard Gateway需连接网络内的OPC-UA和MQTT源，但因严格防火墙规则无法访问互联网。
前置条件
离线构建需满足与标准包安装相同的前置条件，且需安装Python 3.11，仅在AlmaLinux 9.x（推荐9.6）或更早版本上支持。 AlmaLinux 10等新版本官方仓库不提供Python 3.11，无法保证其他安装方式可用。若检测到Python版本不兼容，安装程序会退出并提示缺少Python 3.11。
安装正确Python版本可执行：
1
2
sudo dnf install -y epel-release
sudo dnf install -y python3.11
安装
步骤1：下载rpm文件
下载安装包。
1
wget https://github.com/thingsboard/thingsboard-gateway/releases/latest/download/python3.11-thingsboard-gateway-offline.rpm
步骤2：使用dnf安装网关
以软件包方式安装ThingsBoard IoT Gateway并作为守护进程运行，执行以下命令：
1
sudo dnf install -y ./python3.11-thingsboard-gateway-offline.rpm
步骤3：检查网关状态
1
systemctl status thingsboard-gateway
故障排查
-
Python版本错误
安装程序会提示如何安装所需版本的详细说明。
-
修复Python后需卸载已安装的ThingsBoard IoT Gateway
安装正确Python版本后，使用以下命令卸载之前安装的网关软件包：
1
sudo rpm -e --noscripts thingsboard-gateway
然后按上文所述安装离线构建包。