Docker 环境准备

确保已安装 Docker 并启动服务。通过以下命令检查 Docker 版本：

docker --version

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

拉取 IoTDB 镜像

从 Docker Hub 获取官方 IoTDB 镜像：

docker pull apache/iotdb:latest

指定版本可替换 latest 为具体版本号。

启动单机容器

运行以下命令启动容器，映射端口至主机：

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

• 6667：默认客户端端口
• 31999：JMX 监控端口
• 8181：Web 控制台端口

验证服务状态

检查容器是否正常运行：

docker ps -f name=iotdb

若状态为 Up，表示服务已启动。

连接 IoTDB 控制台

通过 CLI 工具连接服务：

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

成功连接后，执行 show databases 验证基础功能。

Web 控制台访问

浏览器访问 http://localhost:8181，使用默认账号 root/root 登录。可查看数据写入、监控指标及执行 SQL。

数据写入测试

通过 CLI 或 REST API 插入测试数据：

CREATE DATABASE root.test;
INSERT INTO root.test(time, s1) VALUES (1, 10.5);

查询验证数据：

SELECT * FROM root.test;

日志与问题排查

查看容器日志定位异常：

docker logs iotdb

常见问题包括端口冲突或资源不足，需调整容器配置或主机资源。

停止与清理容器

停止服务：

docker stop iotdb

删除容器（可选）：

docker rm iotdb

配置持久化存储

为避免数据丢失，启动时挂载宿主目录：

docker run -d -v /path/on/host:/iotdb/data -p 6667:6667 \
--name iotdb apache/iotdb:latest

确保宿主机目录权限正确。

性能优化建议

• 调整 JVM 参数：修改 conf/iotdb-env.sh 中的 MAX_HEAP_SIZE
• 关闭调试日志：编辑 conf/logback.xml 降低日志级别
• 数据分区：根据业务需求规划存储组与时间分区策略

---

以上步骤覆盖从部署到验证的全流程，适用于开发测试环境。生产环境需结合集群部署与安全配置。