本指南介绍如何在Ubuntu 22.04 LTS / 24.04 LTS上安装ThingsBoard IoT Gateway。
前置条件
-系统最低要求符合该OS的官方最低要求； -安装Python 3.7或更高版本。
步骤1：下载deb文件
下载安装包。
1
wget https://github.com/thingsboard/thingsboard-gateway/releases/latest/download/python3-thingsboard-gateway.deb
步骤2：使用apt安装网关
以软件包方式安装ThingsBoard IoT Gateway并作为守护进程运行，执行以下命令：
1
sudo apt install ./python3-thingsboard-gateway.deb -y
deb包将自动安装IoT Gateway所需的库：
1.系统库：libffi-dev, libglib2.0-dev, libxml2-dev, libxslt-dev, libssl-dev, zlib1g-dev, python3-dev, python3-pip。
- Python模块：importlib, importlib-metadata, jsonschema, pymodbus, lxml, jsonpath-rw, paho-mqtt, pyserial, PyYAML, simplejson, pyrsistent。
步骤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。若Python版本不兼容，安装程序会退出并提示如何安装正确版本。
安装正确Python版本可执行：
1
2
3
sudo add-apt-repository ppa:deadsnakes/ppa -y
sudo apt-get update
sudo apt-get install -y python3.11 python3.11-venv
安装
步骤1：下载deb文件
下载安装包。
1
wget https://github.com/thingsboard/thingsboard-gateway/releases/latest/download/python3.11-thingsboard-gateway-offline.deb
步骤2：使用apt安装网关
以软件包方式安装ThingsBoard IoT Gateway并作为守护进程运行，执行以下命令：
1
sudo apt install ./python3.11-thingsboard-gateway-offline.deb -y
步骤3：检查网关状态
1
systemctl status thingsboard-gateway
故障排查
-
Python版本错误
安装程序会提示如何安装所需版本的详细说明。
-
修复Python后需卸载已安装的ThingsBoard IoT Gateway
安装正确Python版本后，使用以下命令卸载之前安装的网关软件包：
1
sudo dpkg --purge python3-thingsboard-gateway
然后按上文所述安装离线构建包。