Docker 部署 Apache IoTDB 的核心步骤

环境准备 安装 Docker 引擎并确保其版本支持 docker-compose。建议使用 Linux 环境以获得最佳性能，Windows/macOS 需启用虚拟化支持。

镜像拉取 从官方或可信源获取 Apache IoTDB 镜像：

docker pull apache/iotdb:latest

持久化存储配置

数据卷挂载 创建命名卷或绑定宿主机目录以保存时序数据：

docker volume create iotdb_data

运行时通过 -v 参数映射：

docker run -v iotdb_data:/iotdb/data apache/iotdb

配置文件持久化 将 iotdb-engine.properties 等配置挂载到容器外：

docker run -v /host/config:/iotdb/conf apache/iotdb

网络与端口映射

基础端口暴露 默认端口 6667（RPC）、31999（JMX）需映射到宿主机：

docker run -p 6667:6667 -p 31999:31999 apache/iotdb

自定义网络 创建专属网络提升隔离性：

docker network create iotdb_net
docker run --network=iotdb_net --name iotdb apache/iotdb

容器编排实践

docker-compose 示例 编写 docker-compose.yml 整合所有配置：

version: '3'
services:
  iotdb:
    image: apache/iotdb
    ports:
      - "6667:6667"
    volumes:
      - iotdb_data:/iotdb/data
    networks:
      - iotdb_net

volumes:
  iotdb_data:
networks:
  iotdb_net:

集群模式扩展 通过修改配置实现多节点部署，需同步挂载配置目录并设置节点 ID。

性能调优建议

JVM 参数调整 通过环境变量传递内存设置：

docker run -e JAVA_OPTS="-Xms4G -Xmx4G" apache/iotdb

日志管理 将日志输出到宿主机便于排查：

docker run -v /host/logs:/iotdb/logs apache/iotdb

安全加固措施

只读挂载 对不需要写入的目录使用只读模式：

docker run -v /host/conf:/iotdb/conf:ro apache/iotdb

非 root 用户运行 在 Dockerfile 或运行时指定用户：

docker run --user 1000:1000 apache/iotdb

验证与监控

基础功能测试 进入容器执行 CLI 测试连接：

docker exec -it iotdb /iotdb/sbin/start-cli.sh

Prometheus 集成 通过暴露的 JMX 端口采集监控数据，需在配置中启用 JMX 上报。