三步装好并跑通 TDengine 时序数据库：Linux 安装配置完整指南

三步装好并跑通 TDengine 时序数据库：Linux 安装配置完整指南

【免费下载链接】TDengineHigh-performance, scalable time-series database designed for Industrial IoT (IIoT) scenarios项目地址: https://gitcode.com/GitHub_Trending/tde/TDengine

如果你手边的设备、车辆或产线传感器正在持续吐出带时间戳的数据，你需要一款能高效存取这类数据的时序数据库。TDengine 正是为此而生的开源时序数据库，为物联网、车联网、工业互联网（IIoT）等场景做了深度优化。本文以 Linux x64 为例，带你走完 TDengine 安装全流程：环境自检、安装包落地、服务启动，直到第一条查询结果返回。

动手前先给环境打个勾

安装本身很快，卡住你的往往是环境不达标。开始之前，对照下面这张清单逐项确认，全部打勾再往下走：

• 64 位操作系统，x64 架构（TDengine 的 Linux 主包面向 x64）
• 内存 ≥ 2GB；如果跑生产负载，建议 8GB 起
• 可用磁盘空间 ≥ 10GB（时序数据会持续增长，提前留足更稳妥）
• 发行版支持 systemd，例如 Ubuntu 16.04+、CentOS 7+——后面启动服务全靠它
• 你有sudo权限，安装脚本需要 root 身份

任何一项不满足，先补环境再装库，能省掉后面一大圈排查。

第一阶段：让安装包落地

先到 TDengine 官方下载渠道拿到最新的 Linux 安装包，文件名形如TDengine-server-3.3.0.0-Linux-x64.tar.gz。把它放到任意有写权限的目录（比如~/），然后做两件事：解压、进目录。

# 解压安装包，得到同名目录 tar -zxvf TDengine-server-3.3.0.0-Linux-x64.tar.gz # 进入解压出的安装目录 cd TDengine-server-3.3.0.0

到此为止你只是"准备好了原料"，真正的安装由下一条命令完成。

第二阶段：把重活交给 install.sh 📦

sudo ./install.sh

执行期间脚本会替你干完四件琐碎但容易出错的事：

1. 建系统用户和组——让服务以独立账号运行，而不是裸用 root；
2. 设置环境变量——保证taos、taosd等命令在任何终端里直接可用；
3. 注册 systemd 服务——把taosd挂到系统服务管理器上，之后启停、开机自启都走systemctl；
4. 创建数据与日志目录——/var/lib/taos存数据、/var/log/taos存日志，后面会反复用到。

等脚本跑完并返回提示符，安装即完成，无需手动编译或配置。

第三阶段：拉起服务，确认它真的活着

启动只需一条命令：

sudo systemctl start taosd

但"命令没报错"不等于"服务健康"，所以紧接着用 status 看一眼：

sudo systemctl status taosd

输出里出现Active: active (running)这一行，才算真正启动成功；看到inactive或failed，直接跳到文末的"故障排查"一节。

冒烟测试：四步确认你没白装 ✅

服务活着只是及格线。用下面的小闭环把"装对了"这件事坐实——连接、建库建表、压一把数据、看一眼日志：

1. 连进去。终端里敲taos进入交互式命令行（下称 shell），看到taos>提示符说明客户端和服务端握手成功。

2. 建库建表。在 shell 里执行两条 SQL，各以分号结尾：

CREATE DATABASE demo; -- 建一个测试库 USE demo; CREATE TABLE demo_table (ts TIMESTAMP, val FLOAT); -- 建一张最简单的时间序列表

能顺利执行并切到demo库，说明元数据链路正常。

3. 跑一把压测。退出 shell 后执行：

taosBenchmark -y

它会模拟上万张子表、上亿条记录批量写入，普通服务器上十几秒就能跑完。这一步既能感受写入吞吐，也顺带验证了大规模写入路径。

4. 翻一眼日志。打开/var/log/taos目录下的日志文件，确认没有红色错误刷屏。到这里，一套可用的 TDengine 就算真正立起来了。

日常运维：服务管理与工具速查

装好之后，你最高频的操作就是服务管理，四条命令建议直接背下来：

⚠️ 一个容易忽略的细节：执行stop时，TDengine 会先把未落盘的数据全部安全写盘再退出。数据量越大，这一步耗时越长——停服"卡住"通常不是死锁，而是落盘还没跑完，耐心等一下即可。

除服务管理外，安装包里还有几个值得认识的工具，都在/usr/local/taos/bin下：

• taosd：服务端主程序，所有数据的读写都经它处理；
• taos：命令行 shell，跑 SQL、查状态的第一现场；
• taosdump：数据导入导出工具，做备份迁移时用；
• taosBenchmark：性能测试工具，冒烟测试里出场过；
• taosadapter：RESTful 接口服务，让 HTTP 客户端也能访问库；
• remove.sh：卸载脚本，动作不可逆，执行前务必想清楚。

附录：装完之后，东西都在哪

遇到"配置改哪""数据存哪"这类问题时，对照下表即可：

故障排查：按现象对号入座 🔧

现象一：服务起不来，status 显示 failed。先排查/var/log/taos/taosdlog.0，报错原因通常写得很直白（端口占用、目录权限、残留进程）。定位后处理对应问题，再systemctl restart taosd验证。

现象二：taos客户端连不上服务端。按顺序确认三件事：taosd是否在跑（status 看一眼）、防火墙是否放行服务端口、客户端与服务端是否同一网络可达。三者排查完仍连不上，回到taosdlog找拒绝连接的具体原因。

现象三：查询慢、写入压上量就吃力。硬件没问题的话，大概率是默认参数不匹配你的负载。打开/etc/taos/taos.cfg，按实际内存、磁盘和并发情况调整相关项，改完重启服务生效。

装完之后，然后呢

• 用 数据建模 把"一张表存所有设备"升级为超级表 + 子表 + 标签的正确姿势；
• 跟着 数据写入 和 数据查询 把真实数据灌进去并聚合分析；
• 进阶玩法如流式计算、数据订阅，可直接从 快速上手目录 挑章节往下读。

更深度的参数调优与生产部署建议，以 官方文档 为准——它永远比任何一篇指南更新。

【免费下载链接】TDengineHigh-performance, scalable time-series database designed for Industrial IoT (IIoT) scenarios项目地址: https://gitcode.com/GitHub_Trending/tde/TDengine