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

TDengine 部署安装指南10 分钟从安装包到跑通第一条查询【免费下载链接】TDengineHigh-performance, scalable time-series database designed for Industrial IoT (IIoT) scenarios项目地址: https://gitcode.com/GitHub_Trending/tde/TDengineTDengine 是一款面向物联网、车联网等场景的高性能时序数据库。本指南带你完成 TDengine 安装、服务启动到写入查询的全流程按平台执行安装包部署随后走一遍启动 → 自检 → 写入 → 查询的验证链路最后按现象对照排障手册定位常见问题。部署须知系统与硬件要求核对表开始前按下表核对目标机器任何一项不达标都应在安装前处理检查项最低要求生产环境建议操作系统LinuxDebian/Ubuntu、CentOS/RHEL 等macOS 仅支持客户端与单机体验同左Windows 仅提供客户端CPU 架构x86_64 或 ARM64需与安装包架构一致4 核起步内存1 GB16 GB磁盘10 GB 可用空间100 GB 以上 SSD权限Linux 具备sudo权限同左Windows 客户端前置安装 Microsoft Visual C Redistributable 最新版同左⚠️ 架构必须匹配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.shDebian/Ubuntu 用户也可用 DEB 包sudo dpkg -i taos-vX.Y.Z-Linux-x64.debCentOS/RHEL 用 RPM 包sudo rpm -ivh taos-vX.Y.Z-Linux-x64.rpm两者均依赖包管理器拉取系统依赖内网离线环境请用上面的 tar.gz 方式。Windows客户端安装包下载 Windows 客户端安装包.exe。双击运行按向导完成安装默认目录为C:\TDengine。安装器会自检 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.sharm64 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 运行库后重试。进阶路线装好之后的四条延伸路径多节点集群在第二台机器重复安装后用ALTER SYSTEM系列命令接入节点参考仓库内 docs/zh/70-Cluster 运维章节。应用集成通过 taosAdapter 暴露 REST 接口端口 6041或用各语言官方驱动连接 6030 端口示例代码见 examples/c/demo.c。SQL 进阶超级表 子表建模、流计算、连续查询继续学习 docs/zh/05-tdengine-sql。可视化与生态接入 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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考