2.3 安装包快速上手

TDengine 下载中心 TDengine All-in-One 产品页面，提供了安装命令，可以快速完成包含 IDMP 在内的所有模块的安装部署，支持 Windows、Linux 等操作系统，详细过程请阅读第 14.13 节

2.3.1 系统要求

安装前，请确保以下前置条件已满足：

TDengine TSDB-Enterprise 3.4.1.7 或更高版本——必须已安装并运行。参见使用安装包部署。
Java 21 或更高版本 (安装命令将自动安装)
glibc 2.28 或更高版本（仅针对 Linux）
Microsoft Visual C++ Redistributable 14.44 或更高版本 (安装命令将自动安装, 仅针对 Windows)
稳定连接互联网
已正确配置的系统时区。请参考操作系统的用户手册进行设置。

如需了解完整的硬件和操作系统要求，请参见部署规划。

2.3.2 安装 TDengine IDMP

请参照 TDengine 下载中心 TDengine All-in-One 产品页面，提供的安装指南进行安装。

提示

在 Windows 系统中，请临时关闭安全防护，再启动 TDengine 安装器；
在 Linux 系统中，需以 root 身份执行命令行；

2.3.3 配置与 TDengine TSDB 的连接

用文本编辑器打开配置文件：

Linux / macOS：/usr/local/taos/idmp/config/application.yml
Windows：C:\TDengine\idmp\config\application.yml

在 tda.default-connection 下，配置连接信息：

tda:
  default-connection:
    enable: true
    auth-type: UserPassword
    url: http://localhost:6041
    username: root
    password: taosdata
    explorer-url: http://localhost:6060

参数	说明
`url`	TDengine REST 接口地址，默认端口 6041
`username`	TDengine 用户名
`password`	TDengine 密码
`explorer-url`	taosExplorer 的访问地址，默认端口 6060。如需远程访问 IDMP，必须将此地址配置为服务器的实际 IP 或域名（例如 `http://192.168.1.100:6060`），否则浏览器将无法连接到 Explorer 服务

（可选）执行以下命令测试与 TDengine TSDB-Enterprise 的连接：

curl --request POST \
  --user root:taosdata \
  --url http://localhost:6041/rest/sql \
  --data 'show databases;'

连接成功时，将返回 TDengine TSDB-Enterprise 的数据库列表。

2.3.4 启动 IDMP 服务

TDengine 安装器安装完成后，IDMP 服务会自动启动；手动启动的命令，如下所示：

Linux/macOS
Windows 安装

sudo svc-tdengine-idmp start

C:\TDengine\idmp\bin\start-tdengine-idmp.bat

或通过 Windows 服务管理器启动 tdengine-idmp-ui 、 tdengine-idmp-backend 、 tdengine-idmp-h2 、 tdengine-idmp-chat 和 tdengine-idmp-cls 五个服务。

默认情况下，TDengine IDMP 服务监听主机的以下端口：

HTTP 访问：http://localhost:6042 或 http://ip:6042
HTTPS 访问：https://localhost:6034 或 https://ip:6034

2.3.5 激活

首次访问时，您需要激活服务。在填写"邮箱"和"组织"后，点击获取激活码，系统会向您填写的邮箱发送一封激活邮件，输入邮件中的激活码后，点击激活，即可完成账户激活。

备注
为方便 AI 相关功能的体验，IDMP 安装后预置了 DeepSeek 的 API key，有效期 7 天。到期后，请在 TDengine IDMP 的管理后台 → 连接更新您的 API key。
激活码验证通过后，会弹出隐私配置对话框，您可以根据需求选择信息采集项，采集的信息将帮助我们改进产品，您的业务及生产数据绝不会被采集，配置完成后，请点击同意。