企业官网建设流程全解析

TDengine 部署安装指南：10 分钟从安装包到跑通第一条查询

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

TDengine 是一款面向物联网、车联网等场景的高性能时序数据库。本指南带你完成 TDengine 安装、服务启动到写入查询的全流程：按平台执行安装包部署，随后走一遍"启动 → 自检 → 写入 → 查询"的验证链路，最后按现象对照排障手册定位常见问题。

部署须知：系统与硬件要求核对表

开始前，按下表核对目标机器，任何一项不达标都应在安装前处理：

⚠️ 架构必须匹配：ARM64 机器拿 x64 包会直接报"cannot execute binary file"，下载前先用uname -m确认。

分平台安装：安装包一键部署步骤

以当前稳定版 vX.Y.Z 为例，版本号按下载中心实际版本替换。

Linux：压缩包安装（推荐，通用性最强）

# 下载与解压安装包（x64 为例） wget https://package.tdengine.com/3.0/TDengine-server-vX.Y.Z-Linux-x64.tar.gz tar -zxvf TDengine-server-vX.Y.Z-Linux-x64.tar.gz cd TDengine-server-vX.Y.Z # 执行官方安装脚本 sudo ./install.sh

Debian/Ubuntu 用户也可用 DEB 包（sudo dpkg -i taos-vX.Y.Z-Linux-x64.deb），CentOS/RHEL 用 RPM 包（sudo rpm -ivh taos-vX.Y.Z-Linux-x64.rpm），两者均依赖包管理器拉取系统依赖，内网离线环境请用上面的 tar.gz 方式。

Windows：客户端安装包

1. 下载 Windows 客户端安装包（.exe）。
2. 双击运行，按向导完成安装，默认目录为C:\TDengine。
3. 安装器会自检 VC++ 运行库，缺失时确认提示即可自动补装。

💡 Windows 客户端用于连接 Linux 上的 TDengine 服务端，安装完成后确认 cmd 中可直接执行taos.exe。

macOS：压缩包安装

tar -zxvf TDengine-server-vX.Y.Z-darwin-arm64.tar.gz cd TDengine-server-vX.Y.Z sudo ./install.sh

arm64 Mac 选 darwin-arm64 包，Intel Mac 选 darwin-x64 包，装完后服务以 launchd 方式管理。

启动与验收：从拉起服务到查回数据

以下命令按顺序执行即可，任何一步失败直接跳到下一节的排障手册。

# 1. 启动全部服务（taosd 核心 + taosadapter 等组件） sudo systemctl start taosd sudo systemctl start taosadapter # 2. 检查核心服务状态，看到 active (running) 即正常 sudo systemctl status taosd

# 3. 压测写入：建 test 库 + meters 超级表，写入 1 亿条记录 taosBenchmark -y

# 4. 进入命令行客户端 taos

在taos>提示符下执行 4 条代表性查询，覆盖计数、聚合、条件过滤、时间窗口：

SELECT COUNT(*) FROM test.meters; -- 全量计数，应为 1 亿 SELECT AVG(current), MAX(voltage) FROM test.meters; -- 跨子表聚合 SELECT COUNT(*) FROM test.meters WHERE location = 'California.SanFrancisco'; -- 标签条件过滤 SELECT _wstart, AVG(current) FROM test.d1001 INTERVAL(10s); -- 10 秒时间窗口

✅ 四条查询均秒级返回且结果符合预期，说明 TDengine 部署完整可用。

排障手册：按现象定位四类常见故障

现象：执行 install.sh 报 "cannot execute binary file"→ 原因：CPU 架构与安装包不匹配（ARM64 机器装了 x64 包，或反之）。 → 解决：uname -m确认架构，下载对应 x64 或 arm64 版本重装。

现象：systemctl start taosd 失败，状态显示 failed→ 原因：进程启动异常，常见为目录权限或端口被占用。 → 解决：sudo journalctl -u taosd -n 50查看报错，并翻看/var/log/taos/下日志文件定位具体原因。

现象：客户端连接超时或拒绝连接→ 原因：6030 端口（原生接口）未开放，或被防火墙/安全组拦截。 → 解决：服务端ss -lntp | grep 6030确认监听，随后放行防火墙；集群场景建议一次性开放 6030–6060 端口段。

现象：Windows 客户端安装中断，提示缺少 VC++ 组件→ 原因：系统未安装或版本过低的 Microsoft Visual C++ Redistributable。 → 解决：接受安装器的自动补装提示；失败则单独安装最新 VC++ 运行库后重试。

进阶路线：装好之后的四条延伸路径

1. 多节点集群：在第二台机器重复安装后，用ALTER SYSTEM系列命令接入节点，参考仓库内 docs/zh/70-Cluster 运维章节。
2. 应用集成：通过 taosAdapter 暴露 REST 接口（端口 6041），或用各语言官方驱动连接 6030 端口，示例代码见 examples/c/demo.c。
3. SQL 进阶：超级表 + 子表建模、流计算、连续查询，继续学习 docs/zh/05-tdengine-sql。
4. 可视化与生态：接入 Grafana 做监控面板，或部署 taosKeeper 采集指标，对应文档见 docs/zh/04-quick-start/09-grafana-integration.md。

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