InfluxDB Docker镜像文档

镜像概述和主要用途

InfluxDB是专为实时分析工作负载构建的开源时序数据库，旨在收集、存储和处理大量事件和时序数据。本镜像为amd64架构的官方InfluxDB镜像，提供了多种版本变体以适应不同的使用需求。

核心功能和特性

• 高性能时序数据存储：针对时间序列数据优化的存储引擎，支持高写入吞吐量和快速查询响应
• 多查询语言支持：支持SQL和InfluxQL查询语言
• 灵活的数据模型：专为时间序列数据设计的标签-字段数据模型
• 水平扩展能力：通过集群模式支持数据量和查询负载的水平扩展
• 集成处理引擎：内置Python处理引擎，支持复杂数据转换和分析
• 多种部署模式：支持单节点、集群和企业级部署

使用场景和适用范围

• 监控系统：服务器、网络、应用程序和传感器数据监控
• 金融分析：市场数据跟踪、交易分析和风险评估
• 行为跟踪：用户行为分析、应用使用模式监控
• 物联网数据处理：设备传感器数据收集和实时分析
• 实时分析：需要快速响应的实时数据处理和分析场景

支持的标签和版本

InfluxDB 3系列

• 3-core, 3.5-core, 3.5.0-core, core - InfluxDB 3 Core (最新OSS版本)
• 3-enterprise, 3.5-enterprise, 3.5.0-enterprise, enterprise - InfluxDB 3 Enterprise (需许可证)

InfluxDB 2系列

• 2, 2.7, 2.7.12, latest - InfluxDB v2
• 2-alpine, 2.7-alpine, 2.7.12-alpine, alpine - InfluxDB v2 Alpine版本

InfluxDB 1系列

• 1.12, 1.12.2 - InfluxDB v1.12
• 1.12-alpine, 1.12.2-alpine - InfluxDB v1.12 Alpine版本
• 1.12-data, 1.12.2-data - InfluxDB v1.12 数据节点
• 1.12-data-alpine, 1.12.2-data-alpine - InfluxDB v1.12 数据节点 Alpine版本
• 1.12-meta, 1.12.2-meta - InfluxDB v1.12 元数据节点
• 1.12-meta-alpine, 1.12.2-meta-alpine - InfluxDB v1.12 元数据节点 Alpine版本
• 1.11, 1.11.8 - InfluxDB v1.11
• 1.11-alpine, 1.11.8-alpine - InfluxDB v1.11 Alpine版本
• 1.11-data, 1.11.9-data - InfluxDB v1.11 数据节点
• 1.11-data-alpine, 1.11.9-data-alpine - InfluxDB v1.11 数据节点 Alpine版本
• 1.11-meta, 1.11.9-meta - InfluxDB v1.11 元数据节点
• 1.11-meta-alpine, 1.11.9-meta-alpine - InfluxDB v1.11 元数据节点 Alpine版本

详细使用方法和配置说明

InfluxDB 3 Core (最新版)

使用Docker Compose部署

创建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

启动服务：

docker compose up -d

使用Docker Run部署

docker run --rm -p 8181:8181 \
  -v $PWD/data:/var/lib/influxdb3/data \
  -v $PWD/plugins:/var/lib/influxdb3/plugins \
  amd64/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

自定义服务器选项

查看所有可用配置选项：

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

常用配置选项：

• --node-id：节点ID，用于集群识别
• --object-store：对象存储类型（file, s3等）
• --data-dir：数据存储目录
• --plugin-dir：插件目录
• --http-bind-address：HTTP服务绑定地址
• --log-level：日志级别（debug, info, warn, error）

推荐工具

• InfluxDB 3 Explorer UI：独立Web界面，用于数据可视化和管理

  docker run -p 8080:8080 influxdata/influxdb3-ui
  

• Telegraf：数据收集代理，支持数百种数据源

  docker run -d --name=telegraf telegraf
  

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 \
  amd64/influxdb:2

环境变量说明：

• DOCKER_INFLUXDB_INIT_MODE：初始化模式，设为"setup"自动创建初始用户
• DOCKER_INFLUXDB_INIT_USERNAME：管理员用户名
• DOCKER_INFLUXDB_INIT_PASSWORD：管理员密码
• DOCKER_INFLUXDB_INIT_ORG：默认组织名称
• DOCKER_INFLUXDB_INIT_BUCKET：默认存储桶名称
• DOCKER_INFLUXDB_INIT_RETENTION：默认数据保留时间（如"7d"表示7天）
• DOCKER_INFLUXDB_INIT_ADMIN_TOKEN：预定义管理员令牌

启动后访问 http://localhost:8086 打开Web界面。

InfluxDB v1

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

通过环境变量配置：

docker run -d -p 8086:8086 \
  -v $PWD:/var/lib/influxdb \
  -e INFLUXDB_DB=metrics \
  -e INFLUXDB_ADMIN_USER=admin \
  -e INFLUXDB_ADMIN_PASSWORD=secret \
  amd64/influxdb:1.11

环境变量说明：

• INFLUXDB_DB：自动创建的数据库名称
• INFLUXDB_ADMIN_USER：管理员用户名
• INFLUXDB_ADMIN_PASSWORD：管理员密码
• INFLUXDB_USER：普通用户名
• INFLUXDB_USER_PASSWORD：普通用户密码
• INFLUXDB_READ_USER：只读用户名
• INFLUXDB_READ_USER_PASSWORD：只读用户密码

镜像变体

标准镜像 (amd64/influxdb:<version>)

这是默认镜像，基于Debian构建，包含完整的依赖项，适合大多数使用场景。如果不确定选择哪个版本，建议使用此版本。

Alpine镜像 (amd64/influxdb:<version>-alpine)

基于Alpine Linux构建，体积更小（约5MB基础镜像），适合对镜像大小有严格要求的场景。由于使用musl libc替代glibc，某些依赖glibc特定功能的应用可能存在兼容性问题。

版本兼容性和迁移

迁移路径

从v1或v2迁移到InfluxDB 3：

1. 双写新数据到现有v1/v2和InfluxDB 3
2. 查询历史数据并写入InfluxDB 3（推荐使用InfluxDB 3 Enterprise进行历史数据查询）

支持和帮助

• 维护者：InfluxData
• 问题反馈：GitHub Issues
• 社区支持：
  • InfluxDB 3 Core/Enterprise：InfluxDB *** Server
  • InfluxDB v2/v1：InfluxDB Community Slack

许可证信息

查看InfluxDB许可信息了解软件许可条款。

本镜像可能包含其他软件组件，这些组件可能具有各自的许可条款。更多信息可在repo-info仓库的influxdb目录中找到。

使用本镜像即表示您同意遵守所有包含软件的相关许可条款。