TDengine Linux 完整安装配置指南-育师

TDengine Linux 完整安装配置指南

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

TDengine 是面向工业物联网、车联网等场景的时序数据库，擅长扛住海量传感器的高频写入。如果你的目标是在一台 Linux 机器上先把单节点库跑起来供开发调试，路径很短：拉包、跑 install.sh、用 taos 探活。跑之前确认一下环境：

64 位 x64 架构，2GB 以上内存（生产建议 8GB+）
至少 10GB 可用磁盘（数据目录可用空间低于 2GB 时 taosd 会拒绝启动）
带 systemd 的系统（Ubuntu 16.04+ / CentOS 7+）
root 权限（非 root 也能装，但只能注册用户级服务）

Phase 1 拉取与部署

1. 解包安装包

从 TDengine 官网拿到对应版本的TDengine-server-<版本号>-Linux-x64.tar.gz，在一个空目录里解开。预期生成一个与包同名的目录，里面有 install.sh 和程序文件：

tar -zxvf TDengine-server-3.3.0.0-Linux-x64.tar.gz

2. 执行安装脚本

进入解包目录，用 root 身份跑脚本，它会自动注册 taosd 服务、建好数据/日志/配置目录并写入初始配置：

cd TDengine-server-3.3.0.0 sudo ./install.sh

交互式安装会先让你填 FQDN，不想要这步就换下面的开关，装完最后会打印服务状态：

sudo ./install.sh -s # 静默安装，全部默认项 sudo ./install.sh -q /opt/tdengine # 静默 + 自定义安装目录（落在 /opt/tdengine/taos） sudo ./install.sh -e no # 跳过 FQDN 交互

root 装默认落在/usr/local/taos，普通用户装落在$HOME/taos，后面找文件都认这两个位置。✅

Phase 2 拉起与探活

3. 拉起服务

脚本一般会自动拉起 taosd，没有的话手动执行：

sudo systemctl start taosd

4. 一条链路确认活着

依次看服务状态、客户端版本、连上查版本，三步都有正常输出才算装通：

sudo systemctl status taosd # 预期 active (running) taos -V # 预期打印客户端版本号 taos # 预期进入交互式命令行 SELECT SERVER_VERSION(); # taos 内执行，预期返回版本号

进 taos 后建议先把默认账号的密码改掉：ALTER USER root PASSWORD '你的强密码';

Phase 3 日常运维

5. 调配置

主配置文件是/etc/taos/taos.cfg（普通用户装在$HOME/taos/cfg/taos.cfg），改serverPort、timezone、dataDir这类参数后重启生效：

sudo vi /etc/taos/taos.cfg sudo systemctl restart taosd

6. 查日志

运行日志统一在/var/log/taos，taosd 主日志是taosdlog.*，行为不对劲先去这翻：

tail -100 /var/log/taos/taosdlog.0

7. 回滚

用rmtaos回滚，默认保留数据、日志和配置，确认要清数据再追加-e yes。⚠️ 执行前建议备份/var/lib/taos：

sudo rmtaos # 保留数据/日志/配置 sudo rmtaos -e yes # 连数据一起删

命令速查

sudo systemctl start taosd # 拉起 sudo systemctl stop taosd # 停止，先等数据落盘 sudo systemctl restart taosd # 重启 sudo systemctl status taosd # 探活 sudo systemctl enable taosd # 开机自启

⚠️ 数据量大时 stop 会明显变慢，这是落盘过程，别直接 kill。

装完磁盘上多了什么

路径	内容
`/usr/local/taos`	主安装目录（bin / driver / include / examples）
`/etc/taos/taos.cfg`	主配置文件
`/var/lib/taos`	数据存储
`/var/log/taos`	运行日志
`/usr/bin`	命令软链（taos、taosd、taosdump 等）

bin里常用的几个：taosd（服务端进程）、taos（命令行）、taosdump（数据导入导出）、taosBenchmark（压测）、taosadapter（REST/WS 接口）。

排障速查

taosd 起不来→ 数据目录可用空间低于 minimalDataDirGB 默认值 2.0 →df -h /var/lib/taos查一下并腾空间
客户端连不上→ 6030-6042 端口没放行或 taosd 没在跑 → 先systemctl status taosd，再放行防火墙
stop 卡很久→ 正在把内存数据写盘，属正常 → 等它自己结束，不做 kill -9
装新版后客户端报驱动错误→/usr/lib64下旧版 libtaos 还在 → 重跑一次 install.sh 刷新软链

按上面走完，你就有一个能直接写入的 TDengine 了；更多配置项、Docker 与集群方式，翻仓库内的官方文档：docs/zh/04-quick-start/

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

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考