初始化数据库并启动
正文与配图来自原稿。适合源码调试；生产更推荐 Docker 部署。依赖组件版本以你检出的 TBMQ 分支文档为准。
0、前提环境
| 组件 | 说明 |
|---|---|
| JDK 17 | 新版本 TBMQ 要求；IDEA 需能识别该 JDK（原稿建议 IDEA 2022+） |
| Zookeeper | 若你使用的版本/配置仍依赖 ZK（部分部署由 Kafka 生态带上） |
| Kafka | TBMQ 消息与集群状态骨干，本地必须可连 |
| PostgreSQL | 存用户、凭证等元数据 |
辅：官方 Docker 编排会自带 Kafka / Redis / Postgres 等，免去手工搭中间件；本篇按「本机已有 Kafka + PG」的开发方式写。
1、创建数据库
1.1、改配置
编辑应用配置（原稿中的 thingsboard-mqtt-broker.yml，新版本可能是 application.yml / 环境变量），填好 PostgreSQL 地址、库名、账号密码：
1.2、建库
在 PostgreSQL 中创建空库（名称与配置一致）：
1.3、跑安装启动类
运行 ThingsboardMqttBrokerInstallApplication（安装/迁移入口），等待退出成功。用 Navicat 等工具确认表已生成：
只做一次（或版本升级时按官方 Upgrade 说明再跑）。重复乱跑可能冲突，以日志为准。
2、启动程序
2.1、配置 Kafka
在同一配置文件中改 Kafka bootstrap 等，指向本机或开发集群：
确保 Topic 可由 TBMQ 自动创建或已按文档预置；Kafka / ZK（若需要）已启动。
2.2、启动服务
运行 ThingsboardMqttBrokerApplication 主类。
日志无致命错误后：
- HTTP UI：常见为
8083（以配置为准） - MQTT：
1883/ TLS8883 - WebSocket：常见
8084（官方 Getting Started 默认 WebSocket 示例）
登录默认系统管理员（辅，官方文档）：
| 字段 | 默认值 |
|---|---|
| Username | sysadmin@thingsboard.org |
| Password | sysadmin |
首次登录建议立刻改密。然后创建 MQTT Credentials，再用 MQTTX / mosquitto 验证。
3、排障提示
- 连不上库：检查 PG 地址、库名、权限、防火墙
- 启动报 Kafka：检查 bootstrap、监听地址（容器用 host 名 vs localhost）
- UI 起不来：看
ui是否随应用打包；纯后端调试时确认端口未占用
4、小结
改 yml → 建库 → InstallApplication → 配 Kafka → BrokerApplication。
源码编译见 编译 TBMQ；服务器一键部署见 安装部署。