注意： 这是influxdb官方镜像的arm64v8架构构建的"按架构"仓库——更多信息，请参见官方镜像文档中的"非amd64架构？"和官方镜像FAQ中的"镜像源在Git中已更改，该怎么办？"。

快速参考

-** 维护者：InfluxData- 获取帮助：**InfluxDB **服务器（InfluxDB 3 Core、InfluxDB 3 Enterprise首选），InfluxDB社区Slack（InfluxDB v2、v1首选）

支持的标签及对应Dockerfile链接

• 1.12, 1.12.2
• 1.12-alpine, 1.12.2-alpine
• 1.11, 1.11.8
• 1.11-alpine, 1.11.8-alpine
• 2, 2.7, 2.7.12, latest
• 2-alpine, 2.7-alpine, 2.7.12-alpine, alpine
• 3-core, 3.5-core, 3.5.0-core, core
• 3-enterprise, 3.5-enterprise, 3.5.0-enterprise, enterprise

快速参考（续）

-** 问题反馈：[*] 支持的架构：(更多信息) amd64，arm64v8- 镜像 artifact 详情：repo-info 仓库的 repos/influxdb/ 目录（历史记录）（镜像元数据、传输大小等） - 镜像更新：official-images 仓库的 library/influxdb 标签official-images 仓库的 library/influxdb 文件（历史记录） - 本描述来源：**docs 仓库的 influxdb/ 目录（历史记录）

什么是 InfluxDB？

!logo

InfluxDB是专为收集、存储和处理大量事件和时序数据设计的时序数据库平台。适用于监控（传感器、服务器、应用程序、网络）、财务分析和行为跟踪等场景。

启动 InfluxDB 3 Core

通过 docker compose

influxdb 的 compose.yaml 示例：

# compose.yaml
name: influxdb3
services:
  influxdb3-core:
    container_name: influxdb3-core
    image: influxdb:3-core
    ports:
      - 8181:8181
    command:
      - influxdb3
      - serve
      - --node-id=node0
      - --object-store=file
      - --data-dir=/var/lib/influxdb3/data
      - --plugin-dir=/var/lib/influxdb3/plugins
    volumes:
      - type: bind
        source: ~/.influxdb3/core/data
        target: /var/lib/influxdb3/data
      - type: bind
        source: ~/.influxdb3/core/plugins
        target: /var/lib/influxdb3/plugins

或者，可使用以下命令启动 InfluxDB 3 Core：

docker run --rm -p 8181:8181 \
  -v $PWD/data:/var/lib/influxdb3/data \
  -v $PWD/plugins:/var/lib/influxdb3/plugins \
  arm64v8/influxdb:3-core influxdb3 serve \
    --node-id=my-node-0 \
    --object-store=file \
    --data-dir=/var/lib/influxdb3/data \
    --plugin-dir=/var/lib/influxdb3/plugins

InfluxDB 3 Core 启动时包含：

• 数据持久化路径：/var/lib/influxdb3/data
• 启用 Python 处理引擎，带有插件目录
• HTTP API 监听端口 8181

使用 InfluxDB 3 Core

启动 InfluxDB 3 服务器后，请遵循快速入门指南创建授权令牌，并通过内置的 influxdb3 CLI 或 HTTP API 开始写入、查询和处理数据。

InfluxDB 3 Core 推荐工具

搭配 InfluxDB 3 Core 使用以下工具：

• InfluxDB 3 Explorer UI：专为 InfluxDB 3 设计的独立 Web 界面，用于可视化、查询和管理数据。Docker Hub 地址
• Telegraf：从数百个数据源收集、转换指标并直接发送到 InfluxDB 3。Docker Hub 地址
• 官方客户端库：通过支持的 Python、Go、JavaScript 等语言库将 InfluxDB 3 集成到应用程序中。

自定义服务器选项

使用可用的服务器选项自定义实例：

docker run --rm arm64v8/influxdb:3-core influxdb3 serve --help

可用的 InfluxDB 版本

• arm64v8/influxdb:3-core - 最新开源版（InfluxDB 3 Core）
• arm64v8/influxdb:2 - 上一代开源版（InfluxDB v2）
• arm64v8/influxdb:1.11 - InfluxDB v1

arm64v8/influxdb:3-core - 最新开源版

• 基于对象存储的最新版本，使用 InfluxDB 3 存储引擎、Apache Arrow 和 DataFusion SQL
• 亚 10 毫秒查询响应，支持无限基数
• 兼容 SQL 和 InfluxQL 查询
• 内置 Python 处理引擎
• 专为实时监控和近期数据设计
• 包含 InfluxDB v1 和 v2 兼容 API

arm64v8/influxdb:2

• 基于 TSM 存储引擎构建
• 支持 Flux 查询语言
• 集成 UI 和仪表盘
• 包含支持 InfluxQL 的 v1 兼容 API

arm64v8/influxdb:1.11

• 基于 TSM 存储引擎构建
• 原始版本，使用 InfluxQL 查询语言
• 为现有部署提供稳定支持

arm64v8/influxdb:3-enterprise（需许可证）

在 InfluxDB 3 Core 基础上增加无限数据保留、压缩、集群和高可用性。

安装说明请参见 InfluxDB 3 Enterprise 安装文档。

InfluxDB v1 Enterprise（需许可证）

• arm64v8/influxdb:1.11-data - 集群数据节点
• arm64v8/influxdb:1.11-meta - 集群协调元节点（端口 8091）

安装说明请参见 InfluxDB v1 Enterprise Docker 文档。

版本兼容性

迁移路径

从 v1 或 v2 迁移到 InfluxDB 3：

1. 双写新数据到 v1/v2 和 InfluxDB 3。
2. 从 v1/v2 查询历史数据并写入 InfluxDB 3。建议使用 InfluxDB 3 Enterprise 实现历史查询能力。

使用 InfluxDB v2

InfluxDB v2 是旧版本。新部署建议使用 InfluxDB 3 Core。

执行以下命令启动 InfluxDB v2 并使用自定义配置初始化：

docker run -d -p 8086:8086 \
  -v $PWD/data:/var/lib/influxdb2 \
  -v $PWD/config:/etc/influxdb2 \
  -e DOCKER_INFLUXDB_INIT_MODE=setup \
  -e DOCKER_INFLUXDB_INIT_USERNAME=my-user \
  -e DOCKER_INFLUXDB_INIT_PASSWORD=my-password \
  -e DOCKER_INFLUXDB_INIT_ORG=my-org \
  -e DOCKER_INFLUXDB_INIT_BUCKET=my-bucket \
  arm64v8/influxdb:2

容器启动后，访问 http://localhost:8086 查看 UI。

详细说明请参见 InfluxDB v2 Docker Compose 文档。

使用 InfluxDB v1

InfluxDB v1 是旧版本。新部署建议使用 InfluxDB 3 Core。

docker run -d -p 8086:8086 \
  -v $PWD:/var/lib/influxdb \
  arm64v8/influxdb:1.11

此命令启动 InfluxDB v1 并包含：

• HTTP API 监听端口 8086
• 数据持久化到当前目录

更多信息请参见 InfluxDB v1 Docker 文档。v1 Enterprise 安装请参见 InfluxDB Enterprise v1 文档。

镜像变体

arm64v8/influxdb 镜像有多种变体，每种针对特定使用场景设计。

arm64v8/influxdb:<version>

这是默认镜像。如果不确定需求，建议使用此版本。它既可作为临时容器（挂载源代码并启动容器运行应用），也可作为构建其他镜像的基础。

arm64v8/influxdb:<version>-alpine

此镜像基于流行的 Alpine Linux 项目，来自 alpine 官方镜像。Alpine Linux 比大多数发行版基础镜像小得多（约 5MB），因此通常生成更精简的镜像。

当最终镜像大小是首要考虑因素时，此变体非常有用。需要注意的是，它使用 musl libc 而非 glibc 及相关库，因此软件可能因 libc 依赖/假设而遇到问题。更多讨论参见 Hacker News 评论线程。

为最小化镜像大小，Alpine 基础镜像通常不包含额外相关工具（如 git 或 bash）。如需添加，请在基于此镜像的 Dockerfile 中自行安装（不熟悉的话，参见 alpine 镜像描述 中的安装示例）。

许可证

查看此镜像包含软件的许可证信息。

与所有 Docker 镜像一样，本镜像可能包含其他软件，这些软件可能使用其他许可证（如基础发行版中的 Bash 等，以及主要软件的任何直接或间接依赖）。

部分可自动检测的额外许可证信息可能位于 repo-info 仓库的 influxdb/ 目录。

对于任何预构建镜像的使用，镜像用户有责任确保对本镜像的任何使用符合其中包含的所有软件的相关许可证。