4、平台基础配置:系统管理员账号登录、租户与客户概念解析、创建第一个租户、创建第一个客户用户、邮件服务器配置

好,咱们继续往下走。上一章我们把 ThingsBoard 装好了,现在它就像一台刚出厂的服务器——干干净净,啥也没有。这一章我们要做的,就是给它「开光」:登录系统管理员账号,搞懂租户和客户到底是个啥,然后亲手创建第一个租户、第一个客户用户,最后把邮件服务器配好。

嗯,这些操作看着简单,但我在项目里见过不少新手在这栽跟头。尤其是租户和客户的概念,搞混了后面全乱套。咱们一步步来。

4.1 系统管理员账号登录

安装完成后,ThingsBoard 默认有一个超级管理员账号。说白了,这就是平台的「上帝视角」——能看到所有租户、所有设备、所有数据。

默认登录信息:

角色 用户名 密码 说明
系统管理员 sysadmin@thingsboard.org sysadmin 最高权限,管理租户和系统配置

打开浏览器,输入你的 ThingsBoard 地址(比如 http://localhost:8080),就会看到登录页面。输入上面的账号密码,点登录。

💡 我的习惯:第一次登录后,我建议立刻改密码。别问我为什么——有一次我在客户现场演示,结果默认密码被旁边的人看到了,场面一度非常尴尬。

登录成功后,你会看到左侧菜单栏。注意看,系统管理员能看到的东西和普通用户完全不同。最上面有个「租户管理」的入口,这就是我们接下来要操作的地方。

4.2 租户与客户概念解析

这两个概念,我敢说 80% 的新手都会搞混。咱们用个生活中的例子来解释。

租户(Tenant)——你可以把它理解成「物业公司」。物业公司管理整栋楼,有自己的管理员、自己的规则、自己的设备。在 ThingsBoard 里,租户就是一个独立的物联网业务实体。比如你给一个智慧园区做平台,这个园区就是一个租户。

客户(Customer)——你可以把它理解成「业主」。业主住在楼里,使用物业公司提供的服务。在 ThingsBoard 里,客户是租户的下级,他们能看到租户分配给他的设备和数据。

举个例子你就明白了:

  • 租户:智慧园区管理公司(管理所有设备、规则、仪表板)
  • 客户:园区里的某家企业(只能看自己那层楼的温湿度数据)
⚠️ 关键点:租户可以创建多个客户,但客户不能创建租户。租户是「房东」,客户是「房客」。这个层级关系一旦搞反,后面权限管理会非常痛苦。

我在项目中遇到过一家做智慧楼宇的公司,他们把每个楼层的租户都当成了「租户」来创建,结果发现跨楼层的数据根本没法共享。后来全部推倒重来,白白浪费了两周时间。你想想看,如果一开始就搞清楚这个层级,哪会有这种事?

4.3 创建第一个租户

好,概念搞清楚了,咱们动手。用系统管理员账号登录后,点击左侧菜单的「租户管理」。

操作步骤:

  1. 点击右上角的「+」号,选择「添加租户」
  2. 在弹出的窗口中,填写租户信息

租户信息示例:

字段 填写内容 说明
标题 智慧园区演示平台 租户的名称,建议用中文,方便识别
租户邮箱 admin@demo-park.com 租户管理员的邮箱,用于接收通知
国家/地区 中国 选填,但建议填上,后面邮件配置会用到
城市 上海 选填
地址 浦东新区张江高科技园区 选填

填好后点击「添加」。嗯,这里要注意:添加成功后,系统会自动生成一个租户管理员账号。这个账号的密码是随机生成的,你需要记下来,或者后面通过邮件重置。

⚠️ 避坑指南:我曾经遇到过一个问题——创建租户时邮箱填错了,结果租户管理员收不到激活邮件。后来我养成了一个习惯:创建完租户后,立刻用租户管理员账号登录一次,确认密码能正常使用。别偷懒,这一步花不了 30 秒。

创建成功后,你会在租户列表里看到刚才添加的「智慧园区演示平台」。点击它,可以查看详情、编辑信息、或者删除。

4.4 创建第一个客户用户

租户有了,接下来要给这个租户添加客户。说白了,就是给「物业公司」添加「业主」。

操作步骤:

  1. 在系统管理员界面,点击左侧菜单的「租户管理」
  2. 找到刚才创建的「智慧园区演示平台」,点击它
  3. 在租户详情页,点击「管理租户」按钮
  4. 你会进入租户自己的管理界面——注意,这里已经不是系统管理员视角了,而是租户管理员视角
  5. 在左侧菜单找到「客户」,点击进入
  6. 点击右上角的「+」号,选择「添加客户」

客户信息示例:

字段 填写内容 说明
标题 A栋-某科技公司 客户的名称,建议包含位置信息
客户邮箱 contact@tech-company.com 客户管理员的邮箱
手机号 13800138000 选填,但建议填上,方便后续通知

点击「添加」后,系统会生成一个客户用户账号。默认情况下,这个账号的密码也是随机生成的。

💡 我的习惯:创建客户后,我会立刻给客户管理员发一封邮件,告诉他账号和初始密码。别指望系统自动发邮件——邮件服务器还没配呢!所以这一步先手动记录密码,后面配好邮件服务器再测试自动发送。

你可能会问:一个租户下能创建多少个客户?答案是:没有硬性限制。但我在实际项目中建议,一个租户下的客户数量不要超过 500 个,否则管理起来会非常混乱。如果客户太多,可以考虑拆分成多个租户。

4.5 邮件服务器配置

这一步很多人会跳过,但我强烈建议你配好。为什么?因为 ThingsBoard 的很多功能都依赖邮件:用户注册、密码重置、告警通知……没有邮件服务器,这些功能全废了。

配置步骤:

  1. 用系统管理员账号登录
  2. 点击左侧菜单的「系统设置」
  3. 找到「邮件」选项卡
  4. 填写邮件服务器信息

邮件服务器配置示例(以 QQ 邮箱为例):

字段 填写内容 说明
邮件服务器主机 smtp.qq.com QQ邮箱的SMTP服务器地址
邮件服务器端口 465 SSL加密端口,587是TLS端口
用户名 your-email@qq.com 你的QQ邮箱地址
密码 你的授权码 注意!不是QQ密码,是SMTP授权码
使用TLS 勾选上,保证安全
发件人邮箱 your-email@qq.com 和用户名保持一致
⚠️ 避坑指南:我曾经在这里卡了整整一天。原因是:我填了QQ邮箱的登录密码,而不是授权码。QQ邮箱的SMTP服务要求使用授权码,这个授权码需要在QQ邮箱的设置里生成。具体路径:QQ邮箱设置 → 账户 → POP3/IMAP/SMTP服务 → 生成授权码。记住,是授权码,不是登录密码!

填好后,点击「保存」。然后点击「发送测试邮件」,输入一个测试邮箱地址,看看能不能收到邮件。如果收到,恭喜你,邮件服务器配置成功。如果没收到,检查以下几点:

  • 端口号是否正确(QQ邮箱465或587)
  • 授权码是否填写正确
  • 防火墙是否开放了对应端口
  • 邮箱是否开启了SMTP服务

嗯,这里再补充一句:如果你用的是企业邮箱或者自建邮件服务器,配置方式类似,只是服务器地址和端口不同。我个人建议,开发测试阶段用QQ邮箱或163邮箱就够了,生产环境再用企业邮箱。

本章小结

这一章我们干了四件事:

  • 用系统管理员账号登录了 ThingsBoard
  • 搞清楚了租户和客户的区别——租户是物业公司,客户是业主
  • 创建了第一个租户「智慧园区演示平台」
  • 在租户下创建了第一个客户「A栋-某科技公司」
  • 配置了邮件服务器,让系统能发邮件

这些基础配置看着简单,但它们是整个平台的基石。下一章,我们要开始往平台里添加设备了——那才是真正好玩的部分。

对了,如果你在配置过程中遇到任何问题,欢迎来找我交流。毕竟,这些坑我都踩过,不想让你再踩一遍。