Apache IoTDB 在 Windows Docker Desktop 下的单机部署指南

Apache IoTDB 是一款高性能的时序数据库，专为物联网场景设计。以下是在 Windows Docker Desktop 环境下部署 IoTDB 单机版的详细步骤。

环境准备

确保已安装 Docker Desktop 并启动服务。Docker Desktop 支持 Windows 10/11 专业版或企业版，需启用 WSL 2 或 Hyper-V 后端。

验证 Docker 是否正常运行：

docker --version

拉取 IoTDB 镜像

从 Docker Hub 获取官方镜像：

docker pull apache/iotdb:latest

如需特定版本，可替换 latest 为版本号（如 1.2.0）。

启动容器

运行以下命令启动单机模式容器：

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

参数说明：

• -p 6667:6667：默认客户端端口
• -p 31999:31999：RPC 服务端口
• -p 8181:8181：Web 管理界面端口

验证部署

通过 CLI 工具连接数据库：

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

成功连接后，执行测试命令：

SHOW DATABASES;

Web 控制台访问

浏览器打开 http://localhost:8181，使用默认账号（root/root）登录。控制台提供数据管理、监控和 SQL 查询等功能。

数据持久化配置

为避免容器销毁时数据丢失，可挂载本地目录：

docker run -d -v C:/iotdb/data:/iotdb/data -v C:/iotdb/logs:/iotdb/logs --restart=always [其他参数同上]

常见问题处理

端口冲突时修改映射端口：

-p 6668:6667

内存调整通过环境变量：

-e MAX_HEAP_SIZE="2G"

日志查看命令：

docker logs iotdb-single

性能优化建议

对于生产环境：

• 调整 iotdb-engine.properties 配置文件
• 根据硬件资源设置合适的 JVM 参数
• 启用 TSFile 压缩功能

通过以上步骤，可在 Windows Docker Desktop 环境下快速搭建 IoTDB 单机服务，适用于开发测试和小规模生产场景。