Docker 环境下 IoTDB 单机版快速部署流程

环境准备

确保系统已安装 Docker 和 Docker Compose。通过以下命令验证版本：

docker --version
docker-compose --version

若未安装，参考官方文档完成安装。

拉取 IoTDB 镜像

从 Docker Hub 获取官方镜像：

docker pull apache/iotdb:latest

启动单机版容器

使用以下命令启动容器，默认暴露 6667（RPC）、31999（JMX）、8181（REST）端口：

docker run -d -p 6667:6667 -p 31999:31999 -p 8181:8181 --name iotdb-single apache/iotdb:latest

如需挂载数据目录持久化存储，添加 -v /path/to/local:/iotdb/data 参数。

验证运行状态

检查容器日志确认服务正常启动：

docker logs -f iotdb-single

输出包含 IoTDB has started 即表示成功。

连接与操作

通过 CLI 工具连接数据库：

docker exec -it iotdb-single /iotdb/sbin/start-cli.sh -h 127.0.0.1 -p 6667 -u root -pw root

或使用 REST API 测试：

curl -X GET http://localhost:8181/rest/v1/version

停止与清理

停止容器：

docker stop iotdb-single

删除容器（数据会丢失，除非已挂载卷）：

docker rm iotdb-single

配置调优

修改 iotdb-engine.properties 或 iotdb-datanode.properties 需进入容器：

docker exec -it iotdb-single /bin/bash
vi /iotdb/conf/iotdb-engine.properties

重启容器使配置生效。

监控与管理

通过 JMX 端口（31999）或 Prometheus 监控指标，集成 Grafana 可视化面板。

常见问题

• 端口冲突：调整 -p 参数映射的本地端口。
• 存储不足：挂载外部目录确保数据持久化。
• 性能瓶颈：调整 JVM 参数或配置文件中的内存设置。

---

以上流程覆盖了从部署到运维的关键步骤，适用于开发测试或生产环境快速搭建。