TDengine 3.x 在 Ubuntu 22.04 离线安装与开机自启（实测）

适用场景

内网工控服务器不能 apt 在线安装，需要用 deb 安装包离线部署 TDengine 3.x，并配置开机自启动，保证断电重启后自动恢复。

第一步：准备离线安装包

在能联网的机器上，从 TDengine 官方下载对应 Ubuntu 版本的服务端、客户端 deb 包（注意架构 x64/ARM 要匹配），拷贝到目标服务器，例如 /opt/packages。

第二步：安装服务端与客户端

cd /opt/packages
sudo dpkg -i tdengine-*-server*.deb
sudo dpkg -i tdengine-*-client*.deb

如提示依赖缺失，在有网环境用 apt download 连带依赖一起下载，再离线 dpkg 安装。

第三步：启动与开机自启

sudo systemctl start taosd          # 启动
sudo systemctl enable taosd         # 开机自启
sudo systemctl status taosd         # 查看状态

TDengine 安装后默认已注册 systemd 服务，enable 后断电重启会自动拉起。

第四步：命令行验证

taos
taos> SHOW DATABASES;
taos> CREATE DATABASE demo KEEP 365 DURATION 10;
taos> USE demo;

能进入 taos shell 并建库，说明安装成功。

关键初始配置

配置文件一般在 /etc/taos/taos.cfg，常用项：

• firstEp / fqdn：单机用本机，集群要保证主机名可解析
• serverPort：默认 6030，注意防火墙放行
• 建库时用 KEEP 设数据保留天数、DURATION 设数据文件时间跨度，避免历史无限膨胀

部署 Explorer（可选可视化）

TDengine Explorer/可视化工具可单独部署，通过浏览器查看库表和数据，便于运维，但要注意端口访问控制，不要直接暴露到公网。

常见坑

1. 客户端连不上：先查 fqdn 主机名能否解析、6030 端口是否通
2. 时间不同步：时序库对时间敏感，务必配 NTP 对时
3. 重启后没起来：用 journalctl -u taosd 看日志，多为数据目录权限或磁盘问题

离线环境一次部署好服务自启和对时，后续基本免维护。