nunumaomao/iotdb

Apache IoTDB Docker镜像文档

镜像概述

本镜像为Apache IoTDB的官方Docker化部署包。Apache IoTDB是一款针对物联网场景设计的时序数据库，具备高吞吐量写入、高效查询和数据压缩能力，适用于存储和管理海量物联网设备产生的时序数据。

核心功能与特性

• 时序数据管理：专为物联网时序数据设计，支持高并发写入与查询
• 数据持久化：通过卷挂载实现数据持久化存储，避免容器重启导致数据丢失
• 网络可访问：默认暴露6667端口，支持客户端远程连接
• 轻量级部署：简化部署流程，无需手动配置复杂环境依赖

使用场景

• 物联网设备数据采集与存储
• 工业监控系统时序数据管理
• 智能城市传感器数据处理
• 环境监测数据存储与分析

使用方法

基本部署命令

通过以下命令快速启动IoTDB容器：

bash
docker run -d -p 6667:6667 -v /home/iotdb/local_data:/iotdb/data iotdb:latest

参数说明：

• -d：后台运行容器
• -p 6667:6667：将容器内6667端口映射到主机6667端口（IoTDB默认服务端口）
• -v /home/iotdb/local_data:/iotdb/data：将主机本地目录/home/iotdb/local_data挂载到容器内/iotdb/data目录，用于数据持久化
• iotdb:latest：使用最新版本的IoTDB镜像

验证部署

容器启动后，可通过以下方式验证服务状态：

1. 检查容器运行状态：

   bash
   docker ps | grep iotdb
   

2. 连接IoTDB服务（需安装IoTDB客户端）：

   bash
   iotdb-cli -h localhost -p 6667 -u root -pw root
   

高级配置

自定义配置文件

如需使用自定义配置，可将本地配置文件挂载到容器内配置目录：

bash
docker run -d -p 6667:6667 \
  -v /home/iotdb/local_data:/iotdb/data \
  -v /home/iotdb/conf:/iotdb/conf \
  iotdb:latest

环境变量配置

可通过环境变量调整IoTDB运行参数，例如修改JVM内存配置：

bash
docker run -d -p 6667:6667 \
  -v /home/iotdb/local_data:/iotdb/data \
  -e JAVA_OPTS="-Xms512m -Xmx1024m" \
  iotdb:latest

Docker Compose部署

创建docker-compose.yml文件：

yaml
version: '3'
services:
  iotdb:
    image: iotdb:latest
    ports:
      - "6667:6667"
    volumes:
      - /home/iotdb/local_data:/iotdb/data
      - /home/iotdb/conf:/iotdb/conf
    environment:
      - JAVA_OPTS="-Xms512m -Xmx1024m"
    restart: always

启动服务：

bash
docker-compose up -d

注意事项

• 确保挂载的本地目录具有正确的读写权限
• 生产环境建议指定具体版本号（如iotdb:1.1.0）而非latest
• 如需对外提供服务，建议配置防火墙规则限制访问来源
• 定期备份挂载的本地数据目录，防止数据丢失