drpsychick/influxdb Docker镜像文档

镜像概述和主要用途

drpsychick/influxdb是基于官方InfluxDB镜像构建的多架构Docker镜像，支持amd64和arm64/v8架构。该镜像专为云环境设计，可通过环境变量实现InfluxDB配置的完全自定义，适用于时序数据存储、监控数据收集等场景的容器化部署。

核心功能和特性

• 多架构支持：同时提供amd64（x86_64）和arm64/v8架构镜像，适配不同硬件环境。
• 非Alpine基础镜像：基于非Alpine系统构建，提升兼容性和稳定性。
• TOML配置工具：集成toml_update工具（轻量级Go程序），支持通过环境变量直接读取、修改和生成合法的InfluxDB配置文件（TOML格式）。
• 简化配置逻辑：摒弃传统多变量拼接方式，支持直接通过环境变量指定配置项，变量名顺序无关，配置更直观易读。
• 云环境就绪：支持通过环境变量动态调整配置，无需预先挂载配置文件，适合容器编排平台（如Kubernetes、Docker Compose）部署。

使用场景和适用范围

• 时序数据存储：作为InfluxDB的容器化部署方案，适用于存储和查询时序数据（如监控指标、传感器数据）。
• 多架构环境：需在x86服务器或ARM设备（如树莓派）上统一部署InfluxDB的场景。
• 云原生部署：在云平台或容器编排系统中，通过环境变量快速配置InfluxDB实例，简化配置管理。

使用方法

注意：2021-07-08不兼容更新

该镜像已从Alpine基础镜像迁移至非Alpine基础镜像，并通过toml_update工具管理配置文件，配置方式有重大变更：

• 不再支持多行变量
• 变量名顺序不再影响配置结果
• 配置环境变量格式更简洁直观

旧格式（已废弃）：

IFX_GLOBAL=reporting-disabled = false
IFX_COORDINATOR=[coordinator]
IFX_COORDINATOR_BASE=write-timeout = "30s"\nmax-concurrent-queries = 10

新格式（当前支持）：

IFX_GLOBAL1=reporting-disabled=false
IFX_COORDINATOR1=coordinator.write-timeout="30s"
IFX_COORDINATOR2=coordinator.max-concurrent-queries=10

快速启动步骤

1. 生成默认环境变量文件

# 导出默认环境变量模板到本地influxdb.env
docker run --rm -it drpsychick/influxdb:latest cat /default.env > influxdb.env

# 查看默认配置（可选）
docker run --rm -it --env-file influxdb.env drpsychick/influxdb:latest influxd config

2. 自定义配置

编辑influxdb.env文件，根据需求修改配置项。注意：等号后不可有空格（除非值包含在引号内）：

# 示例：禁用数据上报
IFX_GLOBAL1=reporting-disabled=true
# 示例：配置协调器超时时间
IFX_COORDINATOR1=coordinator.write-timeout="30s"

3. 测试并启动容器

# 测试配置（仅检查配置是否合法，不启动服务）
docker run --rm -it --env-file influxdb.env --name influxdb-test drpsychick/influxdb:latest --test

# 启动InfluxDB服务（映射8086端口供外部访问）
docker run --rm -it --env-file influxdb.env --name influxdb --publish 8086:8086 drpsychick/influxdb:latest

验证连接

服务启动后，通过HTTP接口测试连接：

curl http://localhost:8086/query --data-urlencode "q=SHOW DATABASES"

配置说明

核心配置变量

• CONF_UPDATE：指定InfluxDB配置文件路径，默认值为/etc/influxdb/influxdb.conf（通常无需修改）。
• CONF_PREFIX：配置环境变量前缀，默认值为IFX（所有配置项需以该前缀开头，如IFX_XXX）。

自定义配置项格式

通过IFX_<任意名称>=<section.key>=<value>格式的环境变量自定义InfluxDB配置，其中：

• <section>：配置文件中的章节名（如global、coordinator、http）。
• <key>：章节下的配置项名（如write-timeout、max-concurrent-queries）。
• <value>：配置项值（字符串需用双引号包裹，如"30s"）。

示例：

# 配置HTTP服务端口
IFX_HTTP1=http.bind-address=":8086"
# 配置数据存储路径
IFX_DATA1=data.dir="/var/lib/influxdb/data"
# 配置日志级别
IFX_MONITOR1=monitor.log-level="info"

Docker部署示例

1. docker run命令

docker run -d \
  --name influxdb \
  --publish 8086:8086 \
  --volume /path/to/local/data:/var/lib/influxdb/data \  # 持久化数据
  --env-file influxdb.env \
  drpsychick/influxdb:latest

2. docker-compose配置

version: '3'
services:
  influxdb:
    image: drpsychick/influxdb:latest
    container_name: influxdb
    ports:
      - "8086:8086"
    volumes:
      - ./data:/var/lib/influxdb/data  # 本地目录持久化数据
    env_file:
      - ./influxdb.env
    restart: unless-stopped

注意事项

• Docker环境变量限制：Docker仅支持简单变量，不可包含双引号、单引号或换行符，配置值中的字符串需用双引号包裹时，直接写在环境变量中（如coordinator.write-timeout="30s"）。
• 配置优先级：环境变量定义的配置项会覆盖默认配置文件中的值，无需修改原始配置模板。
• 持久化数据：通过-v参数挂载/var/lib/influxdb/data目录，避免容器重启后数据丢失。