4、平台基础配置:系统管理员账号登录、租户与客户概念解析、创建第一个租户、创建第一个客户用户、邮件服务器配置
好,咱们继续往下走。上一章我们把 ThingsBoard 装好了,现在它就像一台刚出厂的服务器——干干净净,啥也没有。这一章我们要做的,就是给它「开光」:登录系统管理员账号,搞懂租户和客户到底是个啥,然后亲手创建第一个租户、第一个客户用户,最后把邮件服务器配好。
嗯,这些操作看着简单,但我在项目里见过不少新手在这栽跟头。尤其是租户和客户的概念,搞混了后面全乱套。咱们一步步来。
4.1 系统管理员账号登录
安装完成后,ThingsBoard 默认有一个超级管理员账号。说白了,这就是平台的「上帝视角」——能看到所有租户、所有设备、所有数据。
默认登录信息:
| 角色 | 用户名 | 密码 | 说明 |
|---|---|---|---|
| 系统管理员 | sysadmin@thingsboard.org | sysadmin | 最高权限,管理租户和系统配置 |
打开浏览器,输入你的 ThingsBoard 地址(比如 http://localhost:8080),就会看到登录页面。输入上面的账号密码,点登录。
登录成功后,你会看到左侧菜单栏。注意看,系统管理员能看到的东西和普通用户完全不同。最上面有个「租户管理」的入口,这就是我们接下来要操作的地方。
4.2 租户与客户概念解析
这两个概念,我敢说 80% 的新手都会搞混。咱们用个生活中的例子来解释。
租户(Tenant)——你可以把它理解成「物业公司」。物业公司管理整栋楼,有自己的管理员、自己的规则、自己的设备。在 ThingsBoard 里,租户就是一个独立的物联网业务实体。比如你给一个智慧园区做平台,这个园区就是一个租户。
客户(Customer)——你可以把它理解成「业主」。业主住在楼里,使用物业公司提供的服务。在 ThingsBoard 里,客户是租户的下级,他们能看到租户分配给他的设备和数据。
举个例子你就明白了:
- 租户:智慧园区管理公司(管理所有设备、规则、仪表板)
- 客户:园区里的某家企业(只能看自己那层楼的温湿度数据)
我在项目中遇到过一家做智慧楼宇的公司,他们把每个楼层的租户都当成了「租户」来创建,结果发现跨楼层的数据根本没法共享。后来全部推倒重来,白白浪费了两周时间。你想想看,如果一开始就搞清楚这个层级,哪会有这种事?
4.3 创建第一个租户
好,概念搞清楚了,咱们动手。用系统管理员账号登录后,点击左侧菜单的「租户管理」。
操作步骤:
- 点击右上角的「+」号,选择「添加租户」
- 在弹出的窗口中,填写租户信息
租户信息示例:
| 字段 | 填写内容 | 说明 |
|---|---|---|
| 标题 | 智慧园区演示平台 | 租户的名称,建议用中文,方便识别 |
| 租户邮箱 | admin@demo-park.com | 租户管理员的邮箱,用于接收通知 |
| 国家/地区 | 中国 | 选填,但建议填上,后面邮件配置会用到 |
| 城市 | 上海 | 选填 |
| 地址 | 浦东新区张江高科技园区 | 选填 |
填好后点击「添加」。嗯,这里要注意:添加成功后,系统会自动生成一个租户管理员账号。这个账号的密码是随机生成的,你需要记下来,或者后面通过邮件重置。
创建成功后,你会在租户列表里看到刚才添加的「智慧园区演示平台」。点击它,可以查看详情、编辑信息、或者删除。
4.4 创建第一个客户用户
租户有了,接下来要给这个租户添加客户。说白了,就是给「物业公司」添加「业主」。
操作步骤:
- 在系统管理员界面,点击左侧菜单的「租户管理」
- 找到刚才创建的「智慧园区演示平台」,点击它
- 在租户详情页,点击「管理租户」按钮
- 你会进入租户自己的管理界面——注意,这里已经不是系统管理员视角了,而是租户管理员视角
- 在左侧菜单找到「客户」,点击进入
- 点击右上角的「+」号,选择「添加客户」
客户信息示例:
| 字段 | 填写内容 | 说明 |
|---|---|---|
| 标题 | A栋-某科技公司 | 客户的名称,建议包含位置信息 |
| 客户邮箱 | contact@tech-company.com | 客户管理员的邮箱 |
| 手机号 | 13800138000 | 选填,但建议填上,方便后续通知 |
点击「添加」后,系统会生成一个客户用户账号。默认情况下,这个账号的密码也是随机生成的。
你可能会问:一个租户下能创建多少个客户?答案是:没有硬性限制。但我在实际项目中建议,一个租户下的客户数量不要超过 500 个,否则管理起来会非常混乱。如果客户太多,可以考虑拆分成多个租户。
4.5 邮件服务器配置
这一步很多人会跳过,但我强烈建议你配好。为什么?因为 ThingsBoard 的很多功能都依赖邮件:用户注册、密码重置、告警通知……没有邮件服务器,这些功能全废了。
配置步骤:
- 用系统管理员账号登录
- 点击左侧菜单的「系统设置」
- 找到「邮件」选项卡
- 填写邮件服务器信息
邮件服务器配置示例(以 QQ 邮箱为例):
| 字段 | 填写内容 | 说明 |
|---|---|---|
| 邮件服务器主机 | smtp.qq.com | QQ邮箱的SMTP服务器地址 |
| 邮件服务器端口 | 465 | SSL加密端口,587是TLS端口 |
| 用户名 | your-email@qq.com | 你的QQ邮箱地址 |
| 密码 | 你的授权码 | 注意!不是QQ密码,是SMTP授权码 |
| 使用TLS | 是 | 勾选上,保证安全 |
| 发件人邮箱 | your-email@qq.com | 和用户名保持一致 |
填好后,点击「保存」。然后点击「发送测试邮件」,输入一个测试邮箱地址,看看能不能收到邮件。如果收到,恭喜你,邮件服务器配置成功。如果没收到,检查以下几点:
- 端口号是否正确(QQ邮箱465或587)
- 授权码是否填写正确
- 防火墙是否开放了对应端口
- 邮箱是否开启了SMTP服务
嗯,这里再补充一句:如果你用的是企业邮箱或者自建邮件服务器,配置方式类似,只是服务器地址和端口不同。我个人建议,开发测试阶段用QQ邮箱或163邮箱就够了,生产环境再用企业邮箱。
本章小结
这一章我们干了四件事:
- 用系统管理员账号登录了 ThingsBoard
- 搞清楚了租户和客户的区别——租户是物业公司,客户是业主
- 创建了第一个租户「智慧园区演示平台」
- 在租户下创建了第一个客户「A栋-某科技公司」
- 配置了邮件服务器,让系统能发邮件
这些基础配置看着简单,但它们是整个平台的基石。下一章,我们要开始往平台里添加设备了——那才是真正好玩的部分。
对了,如果你在配置过程中遇到任何问题,欢迎来找我交流。毕竟,这些坑我都踩过,不想让你再踩一遍。