文档文档

InfluxDB OSS v2

InfluxDB 文件系统布局

InfluxDB 文件系统布局取决于用于安装 InfluxDB 的操作系统、安装方法或容器化平台。

InfluxDB 文件结构

InfluxDB 文件结构包括以下内容

Engine 路径

指向 存储引擎的目录路径，InfluxDB 在其中存储时间序列数据，包括以下目录

要自定义此路径，请使用 engine-path 配置选项。

Bolt 路径

指向 Boltdb 数据库的文件路径，Boltdb 是一个基于文件的键值存储，用于存储非时间序列数据，例如 InfluxDB 用户、仪表板和任务。要自定义此路径，请使用 bolt-path 配置选项。

SQLite 路径

指向 SQLite 数据库的文件路径，SQLite 是一个 SQL 数据库，用于存储非时间序列数据，例如 InfluxDB Notebooks 和注释。要自定义此路径，请使用 sqlite-path 配置选项。

Configs 路径

指向 influx CLI 连接配置 (configs) 的文件路径。

要使用自定义路径，请将 --configs-path 标志与 influx CLI 命令一起传递。

InfluxDB 配置文件

某些操作系统和软件包管理器在磁盘上存储默认的 InfluxDB (influxd) 配置文件。有关使用 InfluxDB 配置文件的更多信息，请参阅 配置选项。

文件系统布局

macOS Linux Windows Docker Kubernetes

macOS 默认路径

路径默认
Engine 路径~/.influxdbv2/engine/
Bolt 路径~/.influxdbv2/influxd.bolt
SQLite 路径~/.influxdbv2/influxd.sqlite
Configs 路径~/.influxdbv2/configs

macOS 文件系统概述

  • ~/.influxdbv2/
    • engine/
      • data/
        • TSM 目录和文件
      • wal/
        • WAL 目录和文件
    • configs
    • influxd.bolt
    • influxd.sqlite

在 Linux 上安装 InfluxDB 时，您可以下载并安装 influxd 二进制文件，也可以使用软件包管理器。您使用哪种安装方法决定了文件系统布局。

作为独立二进制文件安装

Linux 默认路径（独立二进制文件）

路径默认
Engine 路径~/.influxdbv2/engine/
Bolt 路径~/.influxdbv2/influxd.bolt
SQLite 路径~/.influxdbv2/influxd.sqlite
Configs 路径~/.influxdbv2/configs

Linux 文件系统概述（独立二进制文件）

  • ~/.influxdbv2/
    • engine/
      • data/
        • TSM 目录和文件
      • wal/
        • WAL 目录和文件
    • configs
    • influxd.bolt
    • influxd.sqlite

作为软件包安装

InfluxDB 2.7 支持基于 .deb- 和 .rpm- 的 Linux 软件包管理器。每个软件包的文件系统布局都相同。

Linux 默认路径（软件包）

路径默认
Engine 路径/var/lib/influxdb/engine/
Bolt 路径/var/lib/influxdb/influxd.bolt
SQLite 路径/var/lib/influxdb/influxd.sqlite
Configs 路径/var/lib/influxdb/configs
默认配置文件路径/etc/influxdb/config.toml

Linux 文件系统概述（软件包）

  • /var/lib/influxdb/
    • engine/
      • data/
        • TSM 目录和文件
      • wal/
        • WAL 目录和文件
    • configs
    • influxd.bolt
    • influxd.sqlite
  • /etc/influxdb/
    • config.toml (influxd 配置文件)

Windows 默认路径

路径默认
Engine 路径%USERPROFILE%\.influxdbv2\engine\
Bolt 路径%USERPROFILE%\.influxdbv2\influxd.bolt
SQLite 路径%USERPROFILE%\.influxdbv2\influxd.sqlite
Configs 路径%USERPROFILE%\.influxdbv2\configs

Windows 文件系统概述

  • %USERPROFILE%\.influxdbv2\
    • engine\
      • data\
        • TSM 目录和文件
      • wal\
        • WAL 目录和文件
    • configs
    • influxd.bolt
    • influxd.sqlite

InfluxDB Docker 镜像可从 Docker Hub 和 Quay.io 获取。每个镜像都有唯一的 InfluxDB 文件系统布局。

Docker Hub

对于 InfluxDB v2，InfluxDB Docker Hub 镜像使用 /var/lib/influxdb2 而不是 /var/lib/influxdb，以便您可以在 升级过程中轻松挂载 InfluxDB 1.x 和 2.x 数据的单独卷。

Docker Hub 默认路径

路径默认
Engine 路径/var/lib/influxdb2/engine/
Bolt 路径/var/lib/influxdb2/influxd.bolt
SQLite 路径/var/lib/influxdb2/influxd.sqlite
Configs 路径/etc/influxdb2/influx-configs (如果在容器内使用自动化 setup 模式或 influx setup 设置 InfluxDB)；否则为 /etc/influxdb2/configs。

Docker Hub 文件系统概述

  • /var/lib/influxdb2/
    • engine/
      • data/
        • TSM 目录和文件
      • wal/
        • WAL 目录和文件
    • influxd.bolt
    • influxd.sqlite
  • /etc/influxdb2/
    • configs
    • influx-configs

Quay.io

Quay 默认路径

路径默认
Engine 路径/root/.influxdbv2/engine/
Bolt 路径/root/.influxdbv2/influxd.bolt
SQLite 路径/root/.influxdbv2/influxd.sqlite
Configs 路径/root/.influxdbv2/configs

Quay 文件系统概述

  • /root/.influxdbv2/
    • engine/
      • data/
        • TSM 目录和文件
      • wal/
        • WAL 目录和文件
    • configs
    • influxd.bolt
    • influxd.sqlite

Kubernetes 默认路径

路径默认
Engine 路径/var/lib/influxdb2/engine/
Bolt 路径/var/lib/influxdb2/influxd.bolt
SQLite 路径/var/lib/influxdb2/influxd.sqlite
Configs 路径/etc/influxdb2/configs

Kubernetes 文件系统概述

  • /var/lib/influxdb2/
    • engine/
      • data/
        • TSM 目录和文件 +
      • wal/
        • WAL 目录和文件
    • influxd.bolt
    • influxd.sqlite
  • /etc/influxdb2/
    • configs

TSM 目录和文件布局

TSM 目录和文件存储在 Engine 路径内的 data 目录中。下图相对于 文件系统布局。

  • …/data/
    • 000xX00xxXx000x0/ (存储桶 ID)
      • _series/ (序列目录)
        • 00/ (内部分片索引)
          • 0000 (内部分片索引文件)
      • autogen
        • 0123/ (分片 ID)
          • index (索引目录)
            • L0-00000001.tsl (TSI 索引的预写式日志)
            • L0-00000001.tsi (序列索引)
            • MANIFEST (索引清单)

WAL 目录和文件布局

WAL 目录和文件存储在 Engine 路径内的 data 目录中。下图相对于 文件系统布局。

  • …/wal/
    • 000xX00xxXx000x0/ (存储桶 ID)
      • autogen/
        • 0123/ (分片 ID)
          • _01234.wal (WAL 文件)
存储 内部原理

此页面是否对您有帮助？

感谢您的反馈！

© 2025 InfluxData, Inc.

您的 InfluxDB OSS URL 是什么？

自定义您的 InfluxDB OSS URL，我们将为您更新代码示例。

默认
自定义

有关更多信息，请参阅 InfluxDB OSS URL。

感谢您的反馈！

请告诉我们如何做得更好

谢谢！

不用了，谢谢

Flux 的未来

Flux 即将进入维护模式。您可以继续像目前一样使用它，而无需对您的代码进行任何更改。

阅读更多

现已全面上市

InfluxDB 3 Core 和 Enterprise

快速启动。更快扩展。

获取更新

InfluxDB 3 Core 是一个开源、高速、最近数据引擎，可实时收集和处理数据，并将其持久化到本地磁盘或对象存储。InfluxDB 3 Enterprise 构建在 Core 的基础上，增加了高可用性、读取副本、增强的安全性以及数据压缩，从而实现更快的查询和优化的存储。InfluxDB 3 Enterprise 的免费层可供非商业家用或业余爱好者使用。

有关更多信息，请查看