TDengine 下载安装与部署指南从 tar.gz 到 systemd 的完整实战【免费下载链接】tdengineTDengine is an open source, high-performance, cloud native time-series database optimized for Internet of Things (IoT), Connected Cars, Industrial IoT and DevOps.项目地址: https://gitcode.com/taosdata/tdengine导读本文以 TDengine 官方安装文档为核心系统讲解 Community EditionTDengine TSDB-OSS在 Linux、Windows、macOS 三种平台上的安装方式、服务启动与管理、systemd 定制化配置以及安装后的目录布局。结合本仓库 packaging/tools/install.sh 与 packaging/cfg/taos.cfg 等源码深入解析安装脚本的交互逻辑与配置文件的核心参数帮助你完成从下载、安装、启动到首次配置的完整闭环。一、安装包类型与发行形态TDengine 标准服务端安装包包含以下组件taosdTDengine 核心数据库服务进程taosAdapter负责 RESTful / WebSocket 等协议接入的适配器taosc客户端驱动动态库taosshell命令行交互客户端taosdump数据备份与导出工具taosBenchmark性能压测工具TDinsight 安装脚本Grafana 监控面板部署脚本示例代码examples各语言连接器示例。如果只需要服务端与 C/C 客户端支持可以选用Lite 包。从安装脚本的变量定义可以看到包模式在仓库中的体现# packaging/tools/install.sh verModeedge # cluster(enterprise) / edge(community) pkgModefull # lite(community lite, only taosd and taos)当pkgMode为lite时services列表仅包含taosdtools仅包含taos、taosBenchmark、remove.sh与startPre.sh而 full 模式则额外包含taosadapter、taoskeeper、taos-explorer等服务见 install.sh。TDengine 提供以下发行形态平台发行格式LinuxDeb 包、RPM 包、通用 tar.gz 包、apt-get 软件源Windows客户端安装程序.exemacOS安装包.pkg下文安装步骤中的下载列表针对Community EditionTDengine TSDB-OSS。Enterprise Edition 需要从产品下载中心获取对应平台与版本的安装包。二、系统要求Linux 运行时最低要求Linux 内核3.10.0-1160.83.1.el7.x86_64 或更高GLIBC 2.17 或更高x64 架构ARM 架构要求GLIBC 2.27 或更高。源码编译要求从源码构建 TDengine 额外需要CMake 3.26.4 或更高GCC 9.3.1 或更高。三、Linux 安装五种方式3.1 tar.gz 通用包安装# 1. 下载通用 Linux 包从官方下载列表获取 # 2. 解压并安装 tar -zxvf tdengine-tsdb-oss-{{VERSION}}-linux-x64.tar.gz sudo ./install.sh非交互安装sudo ./install.sh -e no查看全部选项./install.sh -hinstall.sh支持的命令行选项在仓库中定义如下Usage: install.sh [OPTIONS] -h 显示帮助 -v [server | client] 安装类型server 或 client -e [yes | no] 是否交互式设置 FQDN -d [install dir] 自定义安装目录 -s 静默模式安装源码位置packaging/tools/install.sh关键交互流程源码依据执行./install.sh时安装脚本会依次完成以下工作对应 install.sh 的主流程检测服务管理方式优先检测 systemd其次service命令否则直接以进程方式运行检测用户权限非 root 安装要求 systemd ≥ 232CentOS/RHEL 8、Ubuntu 18.04、Debian 9、SUSE 15并需要可用的 user bussystemctl --user否则会提示先通过ssh usernamehost登录或由 root 执行loginctl enable-linger user询问安装目录默认 root 模式安装到/usr/local/taos非 root 模式安装到$HOME/taos可通过-d指定设置 FQDN交互提示 Host name or IP (assigned to this machine) which can be accessed by your tools or apps (must not be localhost)并将结果写入taos.cfg的fqdn项若填写的是非回环 IP还会尝试写入/etc/hosts询问是否加入已有集群提示 Enter FQDN:port (like h1.taosdata.com:6030) of an existing TDengine cluster node to join直接回车留空则作为第一个节点自建集群填入已有节点地址则写入firstEp配置写入monitor 1、monitorFQDN fqdn、dataDir、logDir等配置项并创建/etc/taos/taos.cfg。版本兼容性检查升级安装检测到已存在taosd时脚本会对比新旧版本的libtaos.so版本号与vercomp.txt中记录的最低兼容版本若旧版本低于 3.0.0.0会提示强制升级prompt_force1。3.2 Deb 包安装Ubuntu# 1. 下载 Ubuntu 包 # 2. 安装 sudo dpkg -i tdengine-tsdb-oss-{{VERSION}}-linux-x64.deb3.3 RPM 包安装Red Hat# 1. 下载 Red Hat 包 # 2. 安装 sudo rpm -ivh tdengine-tsdb-oss-{{VERSION}}-linux-x64.rpm3.4 apt-get 软件源安装Debian / Ubuntu配置 stable 软件源并安装wget -qO - http://repos.taosdata.com/tdengine.key | sudo apt-key add - echo deb [archamd64] 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需要beta 包时将软件源行替换为echo deb [archamd64] http://repos.taosdata.com/tdengine-beta beta main | sudo tee /etc/apt/sources.list.d/tdengine-beta.list该方式仅支持 Debian 与 Ubuntu。3.5 安装注意事项版本 ≥ 3.0.6.0taosTools 不再单独发行自 TDengine v3.0.6.0 起taosTools 中的工具taosdump、taosBenchmark 等已并入 TDengine 服务端安装包首个节点 FQDN 留空安装第一个节点时遇到Enter FQDN:提示应直接回车后续节点则输入集群中任意可用节点的 FQDN或在启动新节点前完成firstEp配置。四、Windows 客户端安装下载 Windows 客户端安装程序运行安装程序并按照界面提示操作。默认安装目录为C:\TDengine也可自行选择安装根目录若所选路径不以TDengine结尾安装程序会在其下创建TDengine目录。例如选择D:\apps会安装到D:\apps\TDengine选择D:\apps\TDengine则不会创建重复目录升级安装会沿用已有安装目录不允许更改。自 TDengine v3.1.0.0 起Community Edition 仅提供 Windows 客户端包。安装程序要求Microsoft Visual C Redistributable 2015-2022 x64 14.44 或更高必要时可安装其自带的运行时。五、macOS 安装下载 macOS 安装包运行安装程序。若 macOS 阻止运行可按住 Control 键点击安装包选择打开。macOS 平台的安装同样支持自定义安装目录参考 how-to-install.md安装后需执行source $HOME/.bashrc使taos相关环境变量生效也可通过 launchctl 管理服务见下文。六、启动与管理服务6.1 Linuxsystemdsudo systemctl start taosd sudo systemctl start taosadapter sudo systemctl start taoskeeper sudo systemctl start taos-explorer也可直接运行一键脚本start-all.sh。单个服务可使用systemctl stop、restart、status管理。若系统无 systemd可直接运行/usr/local/taos/bin/taosd安装脚本会按优先级自动选择服务管理方式systemd → sysvinit/service → 裸进程并对不同发行版写入对应的 init 脚本见 install.sh 中的install_service_on_sysvinit与install_service_on_systemd。systemd unit 关键配置仓库中的 taosd.service值得关注[Service] Typesimple ExecStart/usr/bin/taosd ExecStartPre/usr/local/taos/bin/startPre.sh TimeoutStopSec1000000s LimitNOFILE1048576 LimitNPROCinfinity LimitCOREinfinity TimeoutStartSec0 Restartalways StartLimitBurst3 StartLimitInterval900s EnvironmentFile-/etc/default/taosd OOMScoreAdjust-100其中Restartalways与StartLimitBurst3 / StartLimitInterval900s定义了崩溃后自动重启及限频策略——这正是下文「systemd drop-in 定制」示例所修改的字段。安装时脚本还会把ExecStart替换为实际安装目录如/usr/local/taos/bin/taosd -c /etc/taos/taos.cfg见 install.sh。6.2 Windows安装 Windows 服务端包后安装程序会把实际安装目录加入PATH环境变量。重新打开管理员命令行窗口进入实际安装目录执行start-all.bat start-all.bat status start-all.bat stop仅启动服务、跳过连通性检查与 Snode/Xnode 初始化时使用start-all.bat -S6.3 macOSlaunchctlsudo launchctl start com.tdengine.taosd sudo launchctl start com.tdengine.taosadapter sudo launchctl start com.tdengine.taoskeeper sudo launchctl start com.tdengine.taos-explorer也可使用start-all.sh。macOS 下的 plist 文件可在仓库 packaging/tools 目录中找到com.taosdata.taosd.plist、com.taosdata.taosadapter.plist、com.taosdata.taoskeeper.plist、com.taosdata.taos-explorer.plist。七、用 systemd Drop-in 定制 taosd 启动参数drop-in 文件可以在不修改官方 unit 文件的前提下覆盖或追加启动设置且升级时保留。以下示例将启动重试的统计窗口改为 60 秒sudo mkdir -p /etc/systemd/system/taosd.service.d sudo tee /etc/systemd/system/taosd.service.d/60-retry.conf /dev/null EOF [Service] StartLimitInterval60s EOF sudo systemctl daemon-reload sudo systemctl restart taosd要点drop-in 只需包含需要覆盖或新增的字段其余字段沿用原 unit 文件修改后必须systemctl daemon-reload才能生效该机制同样适用于taosadapter、taoskeeper、taos-explorer等其他服务。八、安装目录布局与关键配置8.1 默认目录结构Linux路径用途/usr/local/taos/binTDengine 可执行文件/usr/local/taos/driver动态库/usr/local/taos/examples连接器示例/usr/local/taos/include公共 C 头文件/etc/taos/taos.cfg默认配置文件/var/lib/taos默认数据目录/var/log/taos默认日志目录可执行文件清单taosd、taos、taosdump、taosBenchmark、taosadapter以及维护脚本remove.sh、set_core.sh、start-all.sh、stop-all.sh、startPre.sh、TDinsight.sh、set_taos_malloc.sh等见 install.sh。安装脚本还会在/usr/bin下创建软链接如taos、taosd并把libtaos.so.3、libtaosws.so.3等链接到/usr/lib与/usr/lib64随后执行ldconfig刷新动态库缓存。8.2 核心配置文件 taos.cfg默认配置文件位于/etc/taos/taos.cfg仓库中的模板见 packaging/cfg/taos.cfg。以下是与安装部署直接相关的核心参数参数默认值/示例说明fqdnhostname本 dnode 对外提供服务的 FQDN可为 IP 地址安装时交互写入serverPort6030dnode 对外服务端口firstEphostname:6030启动时连接集群中第一个 dnode 的端点首个节点留空secondEp空当firstEp不可用时的备用端点dataDir/var/lib/taos数据文件目录logDir/var/log/taos日志文件目录tempDir/tmp/临时文件目录maxShellConns5000dnode 可接受的最大连接数monitor1是否启用系统监控安装时追加写入monitorFQDN安装时写入监控服务taoskeeper所在 FQDNsupportVnodes0该 dnode 支持的 vnode 数量上限0 表示不限制statusInterval1dnode 向 mnode 上报状态的时间间隔秒1~10minimalDataDirGB2.0数据目录剩余空间低于该值GB时 dnode 拒绝启动minimalLogDirGB1.0日志目录剩余空间低于该值时停止写日志asyncLog1日志异步写入开关numOfLogLines10000000单个日志文件的最大行数logKeepDays0日志文件保留天数0 表示不限制compressMsgSize-1RPC 消息压缩阈值-1 不压缩 / 0 全部压缩 / 0 超过该大小压缩enableCoreFile1服务崩溃时是否生成 core 文件安装脚本在首次安装时还会向taos.cfg追加monitor 1与monitorFQDN fqdn并确保dataDir、logDir与实际安装目录一致见 install.sh。其余服务taosadapter/taoskeeper/taos-explorer的 TOML 配置则由install_adapter_config、install_keeper_config、install_explorer_config等函数根据安装时的 FQDN 自动生成。8.3 其他组件的配置文件组件配置文件说明taosadapter/etc/taos/taosadapter.tomlRESTful / WebSocket 接入配置taoskeeper/etc/taos/taoskeeper.toml监控采集服务配置taos-explorer/etc/taos/explorer.tomlWeb 管理界面配置taosx/etc/taos/taosx.toml数据迁移工具链配置企业版8.4 非 root 安装的差异非 root 安装时-d $HOME/taos目录结构变为安装目录$HOME/taos配置目录$HOME/taos/cfg数据与日志也在安装目录内可执行文件软链接$HOME/.local/binsystemd user unit$HOME/.config/systemd/user服务管理命令为systemctl --user安装脚本会把PATH与LD_LIBRARY_PATH追加到$HOME/.bashrc需source $HOME/.bashrc或重开终端生效为保证重启后服务自启需要 root 执行loginctl enable-linger user。九、安装后的验证与常见问题9.1 验证安装# 检查服务状态 sudo systemctl status taosd # 查看版本 taosd -V # 使用 CLI 连接首个节点FQDN 安装时已写入配置 taos -h serverFqdn # 查看数据与日志目录 ls -la /var/lib/taos ls -la /var/log/taos9.2 首次安装必须注意若为升级安装脚本会检测到已有taosd提示 Welcome to TDengine Update ...并询问是否继续版本低于 3.0.0.0 的旧数据目录/var/lib/taos/dnode/dnodeCfg.json会被识别并提示先清理安装程序会把安装主目录写入{installDir}/.install_path后续升级时会自动读取该文件以沿用原安装路径无需重新指定-d见 install.sh。9.3 网络与 FQDN 配置安装完成后如需调整网络参数IPv6、TLS 等请参阅 Network and FQDN Configuration。例如启用 IPv6 时需在taos.cfg中配置serverIPv6 :: firstEp ipv6_address1:port secondEp ipv_address2:port fqdn ipv6_address1 enableIPv6 1总结本文完整覆盖了 TDengine 在 Linuxtar.gz / Deb / RPM / apt-get、Windows 与 macOS 三种平台下的安装流程、服务启动方式与安装目录布局并通过 install.sh 的源码揭示了安装脚本的交互逻辑FQDN 设置、集群加入、目录选择、版本兼容检查与 systemd 服务注册细节同时结合 taos.cfg 说明了部署后最常用的核心配置参数。按本文步骤完成安装后即可使用taosCLI 连接首个节点开始创建数据库并写入时序数据多节点集群的规划与部署可进一步参考本目录下的 01-planning.md 与 03-deployment 章节。【免费下载链接】tdengineTDengine is an open source, high-performance, cloud native time-series database optimized for Internet of Things (IoT), Connected Cars, Industrial IoT and DevOps.项目地址: https://gitcode.com/taosdata/tdengine创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考