跳到主要内容

TDengine 安装及配置

注意

🚧 本页文档仍在撰写中，请过段时间再来看吧

提示

TDengine 是项目的必要依赖

小提示

本文主要面向新手小白，如果您已熟悉安装步骤，或有现成环境，可直接跳过当前步骤

简介​

TDengine 是国内热门的开源时序数据库，在本项目中用于设备数据报文的持久化存储。

安装​

以下是在 Ubuntu Server 24.04 系统上安装 TDengine 的简单步骤，其他系统可参考 TDengine 官方文档进行安装。

注意

此处仅列出简易安装步骤，内容更新可能不及时，如需生产部署，建议直接查阅原始文档。

文档与链接

安装命令：

# 使用 apt 安装
wget -qO - http://repos.taosdata.com/tdengine.key | sudo apt-key add -
echo "deb [arch=amd64] http://repos.taosdata.com/tdengine-stable stable main" | sudo tee /etc/apt/sources.list.d/tdengine-stable.list
sudo apt-get update
apt-cache policy tdengine-tsdb
sudo apt-get install tdengine-tsdb
# 直接留空回车
# 启动
sudo systemctl start taosd
sudo systemctl start taosadapter
sudo systemctl start taoskeeper
sudo systemctl start taos-explorer
# 或者直接 start-all.sh （这个已经配置到环境变量中了，可以直接运行了）
# 查看运行状态
sudo systemctl status taosd taosadapter taoskeeper taos-explorer
小提示
  • 如果需要从外部访问数据库，记得开放服务器防火墙 (ufw)，可参考这篇文档
  • 另外，如果部署在云服务器上，并前往云服务器管理页面的安全组/防火墙（不同云厂商叫法不同）放开对应端口
  • 此外，如果使用宝塔面板，还需要在 安全 - 系统防火墙 通过 添加端口规则 功能放开对应端口，或直接关闭防火墙开关（不推荐）
    （如果使用其他管理面板，可参照此步骤检查是否有防火墙功能，如果有也需要放行端口）
默认密码

TDengine 默认用户名密码为：root / taosdata

默认端口

TDengine 默认端口可参考这篇文档

其他命令：

# 命令行查询
taos

在浏览器中可视化查询 (taosExplorer)​

TDengine 的可视化管理交互工具的 web 服务。

官方文档：https://docs.taosdata.com/reference/components/explorer/

# 如果 taos-explorer 没有启动
sudo systemctl start taos-explorer

# 配置防火墙 (如果需要开放)
sudo ufw allow 6060/tcp
# 开放端口
# sudo ufw allow 6030/tcp
sudo ufw allow 6041/tcp

运行端口：http://<IP>:6060/login (例如 http://192.168.2.66:6060/login)

配置​

注意

TODO

问题排查​

如果 TDengine 数据库节点经常非正常关机，可能导致 TDengine 无法启动。如果数据不重要，那么可以使用如下命令删除所有设备数据，再启动：

注意

执行以下命令会删除整个 TDengine 数据库内的数据，请仅在测试环境使用，不得在生产环境中执行此命令。

使用前请谨慎！三思！再三确认！

# See "systemctl status taosd.service" and "journalctl -xeu taosd.service" for details.

sudo systemctl stop taosd
sudo rm -rf /var/lib/taos/*
sudo systemctl start taosd
sudo systemctl status taosd

后续​

如需了解 TDengine 基础语法，可查阅这篇文档，如需数据备份或恢复，或希望彻底卸载，请查阅升级、迁移与备份。