文档文档

确定您的 InfluxDB 版本

识别您正在使用的 InfluxDB 产品和版本对于访问正确的文档、排查问题以及规划升级至关重要。

确定您的 InfluxDB 版本

如果您不确定您正在使用哪个 InfluxDB 产品,请使用我们的交互式版本检测器来帮助确定它。

检测我的 InfluxDB 版本

快速检测方法

通过 URL 模式

如果您通过 URL 访问 InfluxDB,主机名通常会标明您正在使用的产品

URL 模式产品
*.influxdb.ioInfluxDB Cloud Dedicated
us-east-1-1.aws.cloud2.influxdata.comInfluxDB Cloud Serverless
eu-central-1-1.aws.cloud2.influxdata.comInfluxDB Cloud Serverless
*.influxcloud.netInfluxDB Cloud 1 (旧版)
其他 *.cloud2.influxdata.com 区域InfluxDB Cloud (TSM)

通过默认端口

不同的 InfluxDB 产品使用不同的默认端口

  • 端口 8181:InfluxDB 3(Core 或 Enterprise)
  • 端口 8086:InfluxDB v1 或 v2

通过 HTTP 请求头

发送一个 GET 请求到 /ping 端点以检查 HTTP 响应头,例如:

# InfluxDB 3 (port 8181)
curl -i https://:8181/ping

# InfluxDB v1/v2 (port 8086)
curl -i https://:8086/ping

响应头揭示了您的 InfluxDB 产品:

Headers产品
x-influxdb-version: ^3.*
x-influxdb-build: Core
InfluxDB 3 Core
x-influxdb-version: ^3.*
x-influxdb-build: Enterprise
InfluxDB 3 Enterprise
x-influxdb-version: ^2.*
x-influxdb-build: OSS
InfluxDB OSS v2
x-influxdb-version: ^1.*
x-influxdb-build: OSS
InfluxDB OSS v1
x-influxdb-build: Enterprise
(带有 v1 版本号)
InfluxDB Enterprise v1

SQL version() 函数

SQL version() 函数返回的是 DataFusion 查询引擎的版本,而不是 InfluxDB 产品版本。请使用上述方法来识别您的 InfluxDB 版本。

特定产品的方法

InfluxDB 3 Core 和 Enterprise

使用 influxdb3 命令检查版本

influxdb3 --version

发送一个 GET 请求到 /ping 端点以检查 HTTP 响应头,例如:

curl -i https://:8181/ping

响应在请求头主体中包含版本信息

  • Headers:
    • x-influxdb-version:版本号(例如 3.8.0
    • x-influxdb-buildCoreEnterprise
  • JSON 主体:包含 versionrevisionprocess_id

响应示例

HTTP/1.1 200 OK
x-influxdb-build: Core
x-influxdb-version: 3.8.0

{"version":"3.8.0","revision":"abc123def","process_id":"..."}

InfluxDB 3 Enterprise 中,/ping 端点默认需要身份验证。请使用 管理员令牌 (admin token) 或具有 system:ping:read 权限的 系统令牌 (system token)

SQL version() 函数

SQL version() 函数返回的是 DataFusion 查询引擎的版本,而不是 InfluxDB 产品版本。请使用上述方法来识别您的 InfluxDB 版本。

InfluxDB 集群版

使用 influxctl CLI 检查您的集群版本

influxctl version

查看集群信息

influxctl cluster list

InfluxDB OSS v2

使用 influxd 检查版本

influxd version

示例输出

InfluxDB 2.7.12 (git: x0x000xx0x) build_date: 2024-MM-DDThh:mm:ssZ

查询 /health 端点并提取版本信息

curl -s https://:8086/health | jq -r '.version'

InfluxDB UI 会显示版本号

  • 在登录页面上
  • 在主登录页面的右侧列中
  • 在用户菜单下拉列表中

更多详细信息,请参见 如何识别我的 InfluxDB 版本?

InfluxDB Cloud (Serverless, Dedicated, TSM)

对于 InfluxDB Cloud 产品,请通过以下方式查看版本信息:

  • 账户设置:版本详情显示在您的账户仪表板中
  • UI 页脚:版本号可能显示在 Web 界面的底部
  • HTTP 请求头:API 响应包含版本请求头
  • URL 模式:请参阅上方的 通过 URL 模式

InfluxDB OSS v1 和 Enterprise v1

使用 influxd 检查版本

influxd version

检查 /ping 端点的请求头

curl -i https://:8086/ping

查找 x-influxdb-version 请求头(例如 1.11.7)。

了解 InfluxDB 产品

InfluxData 提供多种 InfluxDB 产品以满足不同的使用场景

产品许可证托管方式查询语言默认端口
InfluxDB 3 Core免费自托管 (Self-hosted)SQL, InfluxQL8181
InfluxDB 3 Enterprise付费自托管 (Self-hosted)SQL, InfluxQL8181
InfluxDB Cloud Serverless免费/付费云端 (Cloud)SQL, InfluxQL, FluxN/A
InfluxDB Cloud Dedicated付费云端 (Cloud)SQL, InfluxQLN/A
InfluxDB 集群版付费自托管 (Kubernetes)SQL, InfluxQL自定义
InfluxDB OSS v2免费自托管 (Self-hosted)InfluxQL, Flux8086
InfluxDB Cloud (TSM)免费/付费云端 (Cloud)InfluxQL, FluxN/A
InfluxDB OSS v1免费自托管 (Self-hosted)InfluxQL8086
InfluxDB Enterprise v1付费自托管 (Self-hosted)InfluxQL, Flux8086
InfluxDB Cloud 1付费云端 (旧版)InfluxQLN/A

关键特性

  • InfluxDB 3 产品使用 SQL 和 InfluxQL,运行在 8181 端口(自托管),并提供更佳的性能和可扩展性
  • InfluxDB v2 产品使用 InfluxQL 和 Flux,运行在 8086 端口(自托管),并使用基于 Bucket(存储桶)的数据模型
  • InfluxDB v1 产品使用 InfluxQL,运行在 8086 端口(自托管),并使用基于 Database(数据库)的数据模型

了解 InfluxDB 产品

如需完整比较 InfluxDB 版本和部署选项,请参阅 InfluxDB 平台概述

故障排除

无法访问您的 InfluxDB 实例?

如果您无法直接访问您的 InfluxDB 实例

  1. 使用上方的 交互式版本检测器咨询 InfluxData AI
  2. 回答关于您设置的问题:
    • 许可证类型(付费或免费)
    • 托管模式(云端或自托管)
    • 服务器使用年限
    • 查询语言偏好
  3. 根据您的回答获取产品推荐

仍然不确定?

如果您仍不确定,请参阅 支持与反馈 选项。


此页面是否有帮助?

感谢您的反馈!


InfluxDB OSS 2.9.0:API 令牌默认进行哈希处理

InfluxDB OSS 2.9.0 增强了令牌安全性 —— 令牌在磁盘上默认进行哈希处理。现有令牌在首次启动时会被哈希,之后无法恢复。请在升级前保存您仍然需要的所有明文令牌。

查看 InfluxDB OSS 2.9.0 发行说明

哈希令牌的认证方式与未哈希令牌完全相同 —— 客户端和集成功能可继续正常工作。

2.9.0 中的其他新特性

  • 可配置的备份压缩
  • 恢复对包含哈希令牌的备份的支持
  • 更严格的边缘数据复制(Edge Data Replication)队列验证
  • Flux 升级
  • 压缩可靠性改进

Explorer 1.9 的主要增强功能

Explorer 1.9 现已发布,支持 InfluxQL、AI 辅助的 Flux 转 SQL 转换器(测试版)以及新的实时示例数据模拟器。

查看 Explorer 1.9 发行说明

Explorer 1.9 包含多项新功能和改进,使查询、可视化和管理数据变得更加轻松。

亮点

  • Flux 转 SQL 转换器(测试版):通过 AI 辅助转换器将 Flux 查询转换为 SQL。
  • InfluxQL 支持:在数据浏览器(Data Explorer)和仪表板中使用 InfluxQL 查询数据,并保存和加载 InfluxQL 查询。
  • InfluxQL 可视化:根据 InfluxQL 结果渲染折线图和柱状图,并支持按标签进行序列分组。
  • 查询错误历史记录:在查询工具中查看查询错误历史记录。
  • 实时示例数据模拟器:使用新的鸟类数据和信号发生器模拟器生成连续的实时示例数据。

更多详细信息,请参阅 Explorer 1.9 发行说明

InfluxDB 3.10 现已发布

InfluxDB 3 Core 3.10 增加了自动目录格式升级、可配置的查询并发限制以及处理引擎改进。

InfluxDB 3 Core 3.10 的关键更新

  • 目录格式升级:在 3.10 首次启动时,磁盘目录会自动从 v2 格式升级到 v3 格式。迁移是单向的——升级前请务必备份您的目录。
  • --max-concurrent-queries:限制并发查询(可在运行时调整)。
  • GET /ready 端点,用于就绪探针。
  • 处理引擎:跨数据库查询和触发器锁定标志。

更多信息,请参阅 InfluxDB 3 Core 发行说明

InfluxDB 3.10 现已发布

InfluxDB 3 Enterprise 3.10 增加了自动备份与恢复、行级删除和用户管理功能,并改进了自动目录格式升级和性能预览。

InfluxDB 3 Enterprise 3.10 的关键更新

  • 目录格式升级:在 3.10 首次启动时,磁盘目录会自动从 v2 格式升级到 v3 格式。迁移是单向的——升级前请务必备份您的目录。
  • 自动备份与恢复(测试版)
  • 行级删除
  • 用户管理(认证和 RBAC)— 预览版
  • 性能预览改进

备份与恢复、行级删除以及性能预览需要升级到企业级存储引擎(选择性加入测试版)。测试版和预览版功能可能会发生重大变更,不建议用于生产环境。

更多信息,请参阅 InfluxDB 3 Enterprise 发行说明

Telegraf Enterprise 现已全面上市(General Availability)

Telegraf Enterprise 现已全面上市,同时发布的还有 Telegraf Controller v1.0

Telegraf Enterprise 将 Telegraf Controller(一个用于 Telegraf 的集中式管理控制台)与 InfluxData 的官方支持相结合。通过单一系统管理配置、监控集群健康状况并操作数以万计的 Telegraf 代理。

InfluxDB Docker 的 latest 标签将指向 InfluxDB 3 Core

2026 年 9 月 15 日起,InfluxDB Docker 镜像的 latest 标签将指向 InfluxDB 3 Core。为避免意外升级,请在 Docker 部署中使用特定版本标签。

如果使用 Docker 来安装和运行 InfluxDB,latest 标签将指向 InfluxDB 3 Core。为避免意外升级,请在您的 Docker 部署中使用特定的版本标签。例如,如果使用 Docker 运行 InfluxDB v2,请将 latest 版本标签替换为 Docker pull 命令中的特定版本标签 — 例如

docker pull influxdb:2