ThingsBoard Cloud 白标 功能支持使用自定义域名提供个性化主机名供用户访问。 注册有效域名后，ThingsBoard Cloud 会自动申请SSL证书并负责后续续期。 域名注册完成后，可通过域名使用HTTPS安全访问平台。 该功能主要用于Web UI访问，MQTT、CoAP等传输服务可能无法通过自定义域名使用。
域名注册
注意：您必须是所注册域名的所有者。
要使用自己的主机名代替thingsboard.cloud，需先完成注册。请按以下步骤操作：
首先，在DNS服务商网站上添加域名的规范记录，将其映射到eu.thingsboard.cloud。详见如何为域名创建CNAME记录。
完成后即可开始添加域名的流程。
添加域名
可在租户级和客户级注册自有域名。
- 登录您的 ThingsBoard Cloud 账户；
- 进入「安全」部分的「OAuth2.0」页面，在「Domains」标签页点击「+」图标；
- 在「Domain name」字段输入有效域名，点击「Add」按钮；
- 您会看到一个提示，要求在域名的DNS配置中添加CNAME记录。点击"我已添加CNAME记录"按钮。域名验证和证书配置将开始；
- 如果成功，您将在「Domains」标签页看到您的域名。
使用所选域名登录
现在可以使用域名访问 ThingsBoard Cloud Web界面和服务。在浏览器地址栏输入所选域名进行登录。
域名详情
查看已注册域名的详情时，点击该域名即可打开域名详情对话框。 该对话框显示已注册域名的CNAME记录及已签发的“SSL证书”详情，包括当前有效期（Not before 和 Not after）。
SSL证书有效期为90天，ThingsBoard Cloud 会在到期前至少30天自动续期。 除非您修改或删除域名的CNAME记录，否则无需任何操作。
删除域名
删除已注册的域名时，点击要删除域名行中的“trash”图标。在确认对话框中，若确认删除则点击“Yes”。
确认后，域名信息及关联的SSL证书将被删除，无法再通过该域名访问 ThingsBoard Cloud Web界面和服务。 可随时按域名注册流程重新注册同一或不同域名。
如何为域名创建CNAME记录
添加CNAME记录到DNS数据库的步骤因DNS服务商而异。以下为常用DNS服务商的说明链接：
- Amazon Route 53
- GoDaddy
- Cloudflare
- ClouDNS
- Google Cloud DNS
- Name.com
- easyDNS
- DNSimple
- DNSMadeEasy
- No-IP.com
- Infoblox NIOS
- Namecheap
若以上列表中没有您使用的DNS服务商，请在其官网查找或联系其技术支持。
故障排查
首先确认域名的CNAME是否已正确添加：
若为Linux系统，可使用 Google Admin Toolbox 或“dig”命令：
1
dig $YOUR_DOMAIN_NAME any
将 $YOUR_DOMAIN_NAME替换为您的域名。
例如，$YOUR_DOMAIN_NAME为 mycompany.thingsboard.space：
1
dig mycompany.thingsboard.space any
Linux中的“dig”命令用于获取DNS信息，全称为Domain Information Groper，可收集域名服务器相关数据。“dig”可用于诊断DNS问题，也可用于显示DNS信息。
“dig”命令的输出会因域名配置而异。 例如：
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
$ dig mycompany.thingsboard.space any
; <<>> DiG 9.16.1-Ubuntu <<>> mycompany.thingsboard.space any
;; global options: +cmd
;; Got answer:
;; ->>HEADER<<- opcode: QUERY, status: NOERROR, id: 27275
;; flags: qr rd ra; QUERY: 1, ANSWER: 1, AUTHORITY: 0, ADDITIONAL: 1
;; OPT PSEUDOSECTION:
; EDNS: version: 0, flags:; udp: 65494
;; QUESTION SECTION:
;mydomain.thingsboard.online. IN ANY
;; ANSWER SECTION:
mycompany.thingsboard.space. 3600 IN HINFO "RFC8482" ""
;; Query time: 36 msec
;; SERVER: 127.0.0.53#53(127.0.0.53)
;; WHEN: чт чер 29 15:36:44 EEST 2023
;; MSG SIZE rcvd: 77
该输出表明mycompany.thingsboard.space域名未添加CNAME（“ANSWER SECTION”块）。
正确的输出示例：
1
2
3
4
...
;; ANSWER SECTION:
mycompany.thingsboard.space. 3600 IN CNAME eu.thingsboard.cloud
...
若配置无误但问题仍存在，请联系我们获取支持。
下一步
了解如何自定义ThingsBoard登录页和用户界面、配置公司或产品Logo、调整配色方案，请前往白标章节。