linux安装timescaledb核心是两步：先装匹配postgresql主版本的timescaledb二进制包（如timescaledb-2-postgresql-16），再在目标数据库执行create extension if not exists timescaledb cascade；必须配置shared_preload_libraries='timescaledb'并重启服务，且rds用户需内核小版本≥20230330（pg14+）或≥20241030（pg17）。
直接在 Linux 上安装 PostgreSQL 的 TimescaleDB 插件，核心就两步：装对版本的 timescaledb 二进制包（不是源码编译），再在数据库里执行 CREATE EXTENSION。但错一个环节，比如版本不匹配、shared_preload_libraries 没配、或内核小版本太低，就会卡在 ERROR: could not access file "$libdir/timescaledb-1.x" 或 function create_hypertable does not exist。
确认 PostgreSQL 版本和系统发行版再选包
TimescaleDB 的 RPM/DEB 包名严格绑定 PostgreSQL 主版本号，例如：
-
timescaledb-2-postgresql-14→ 只能用于 PostgreSQL 14 -
timescaledb-2-postgresql-15→ 只能用于 PostgreSQL 15 -
timescaledb-2-postgresql-16→ Ubuntu 24.04 默认带的 PostgreSQL 16 就用这个
查当前 PG 版本：sudo -u postgres psql -c "SELECT version();"；查系统发行版：cat /etc/os-release | grep -E "(ID=|VERSION_ID=)"。Ubuntu 24.04（noble）必须用 timescaledb-2-postgresql-16，不能混用 15 或 14 的包——否则 pg_config 路径、库路径、符号表全对不上，CREATE EXTENSION 必报错。
安装 timescaledb 包并配置 shared_preload_libraries
装包只是复制文件，真正启用要让 PostgreSQL 启动时加载 timescaledb 共享库。这一步漏掉，后续所有 SQL 命令都会失败。
- Ubuntu/Debian：
sudo apt install timescaledb-2-postgresql-16（注意替换为你的 PG 主版本） - CentOS/RHEL：
sudo yum install timescaledb-2-postgresql-16（需先配置 timescale 官方 repo） - 编辑
/etc/postgresql/*/main/postgresql.conf（Ubuntu）或/var/lib/pgsql/*/data/postgresql.conf（RHEL），添加一行：shared_preload_libraries = 'timescaledb' - 重启服务：
sudo systemctl restart postgresql（Ubuntu）或sudo systemctl restart postgresql-16（RHEL）
验证是否加载成功：sudo -u postgres psql -c "SHOW shared_preload_libraries;" 应返回 timescaledb；如果返回空或报错，说明配置路径不对或服务没重启。
在目标数据库中执行 CREATE EXTENSION
插件只作用于单个数据库，不是全局生效。你得连到你要用 TimescaleDB 的那个库（比如 my_tsdb），再运行命令。
- 先连库：
sudo -u postgres psql my_tsdb - 执行：
CREATE EXTENSION IF NOT EXISTS timescaledb CASCADE; - 如果提示
extension "timescaledb" already exists，说明已装过；如果提示ERROR: function create_hypertable does not exist，大概率是没重启服务，或连错了库（比如连到了postgres库但扩展只装在my_tsdb） - 验证是否生效：
\dx应看到timescaledb状态为1.7.4或2.15.3（取决于你装的版本）
注意：RDS PostgreSQL 用户不能手动改 postgresql.conf，必须通过控制台安装插件或执行 ALTER EXTENSION timescaledb UPDATE; 升级，且内核小版本必须 ≥ 20230330（PostgreSQL 14+）或 ≥ 20241030（PostgreSQL 17）。
常见报错和绕不过去的坑
这些错误几乎都源于“版本错配”或“配置未生效”，而不是语法问题：
-
ERROR: could not access file "$libdir/timescaledb-2.15": No such file or directory→ 你装的是timescaledb-2-postgresql-16，但 PostgreSQL 实际运行的是 15；或者shared_preload_libraries拼写错误（比如写成timescaleDB或多空格） -
ERROR: extension "timescaledb" is not available→CREATE EXTENSION前没重启服务，或当前用户权限不够（必须是数据库 owner 或 superuser） -
function create_hypertable does not exist→ 扩展装在了 A 库，但你在 B 库里执行函数；或者用了 RDS 但内核小版本太低，插件根本没激活 - Docker 部署时遇到
timescaledb-tune: command not found→ 官方镜像（timescale/timescaledb）自带调优，不用手动跑；自建镜像才需要装timescaledb-tools包
最易被忽略的一点：TimescaleDB v2 要求 PostgreSQL 编译时启用 OpenSSL 支持。如果你用源码编译过 PG，但 configure 时没加 --with-openssl，即使包装上了，CREATE EXTENSION 也会静默失败或启动报错。检查方法：pg_config --configure | grep openssl —— 没输出就说明缺支持。
