thingboot-cloud-node

物联网服务器中间件（商业套件）。单静态二进制 + 子命令多进程架构： 设备接入、消息路由、设备影子、OTA、对时、开放平台接口、Web 管理界面等能力合一交付。

• 支持平台：linux/amd64、linux/arm64、windows/amd64
• 外部依赖：Mosquitto（MQTT Broker）、Redis
• 管理界面：局域网 Web（默认 0.0.0.0:8899，首启随机密码）

操作系统要求

系统	要求
Linux	内核 3.10+（CentOS 7 / Ubuntu 16.04 / Debian 9 及更高），amd64 或 arm64；二进制为纯静态编译，无 glibc 版本要求
Windows	Windows 10 / Windows Server 2016 及更高（amd64）

不支持 Windows 7 / 8、Windows Server 2008 / 2012：产品运行时（Go ≥1.21） 在这些系统上无法启动（启动即崩溃），亦无对应版本计划，请升级操作系统。

安装（Linux）

curl -fsSL https://github.com/ThingBoot/thingboot-cloud-node/releases/latest/download/install.sh | sudo bash

脚本完成：架构探测 → 下载并校验 sha256 → 解压到 /opt/thingboot → 创建独立运行用户 → setcap 授权 443 端口 → 注册并启动 systemd 服务 thingboot。

• 钉版本：... | sudo bash -s v1.2.3
• 升级：重跑同一命令（配置与数据保留）
• 卸载：bash install.sh uninstall

首次启动会在日志中打印一次随机管理员密码：

journalctl -u thingboot -n 50

安装（Windows）

下载 thingboot-cloud-node_<版本>_windows_amd64.zip 解压后， 管理员运行 thingboot.exe service install 注册为系统服务， 或前台运行 thingboot.exe serve。详见 安装与部署。

目录布局（安装后）

/opt/thingboot/
├── thingboot            # 单静态二进制（全部功能入口）
├── configs/config.yaml  # 全量配置（含注释，默认值可直接用）
├── logs/                # 每模块一个日志文件，自动轮转
└── data/                # 管理员凭据等运行数据

快速开始

thingboot doctor        # 一键体检：配置/broker/Redis/平台/端口/license
thingboot serve         # 生产模式：拉起全部模块 + Web 管理界面（systemd 跑的就是它）
thingboot run router    # 前台单独调试某个模块

打开 http://<服务器IP>:8899，用首启打印的密码登录，可查看模块状态、 启停模块、查看日志与配置。

文档

• 安装与部署
• 配置说明
• 命令行参考
• License 授权