IOTDB Web Workbench Docker镜像文档

镜像概述和主要用途

IOTDB Web Workbench是一个基于Web的可视化工具，专为Apache IoTDB时序数据库设计。该Docker镜像提供了一个便捷的部署方式，使用户能够快速搭建Web界面来管理、查询和可视化IoTDB数据库中的时序数据。

主要用途包括：

• IoTDB数据库的可视化管理
• 时序数据的查询与分析
• 数据导入导出
• 数据库模式设计与维护
• 性能监控与诊断

核心功能和特性

• 直观的Web界面：提供用户友好的图形化操作界面
• 多语言支持：支持SQL和IoTDB特有查询语言
• 数据可视化：多种图表类型展示时序数据趋势
• 批量操作：支持批量导入导出数据
• 元数据管理：方便地创建和管理存储组、时间序列
• 查询历史记录：保存和重用常用查询语句
• 用户权限控制：多用户支持和细粒度权限管理
• 性能优化：查询结果缓存和异步加载
• 实时监控：数据库性能指标实时监控
• 跨平台兼容：通过Docker实现跨平台部署一致性

使用场景和适用范围

适用场景

• IoT设备数据管理与监控系统
• 工业控制系统数据可视化
• 环境监测数据实时分析
• 智能建筑能源消耗监控
• 车联网数据管理平台

适用人群

• 时序数据库管理员
• IoT系统开发人员
• 数据分析师
• DevOps工程师
• 科研人员

使用方法和配置说明

前提条件

• Docker Engine 1.13.0+
• 可访问的Apache IoTDB数据库实例
• 网络连接（用于拉取镜像）

快速启动

使用以下命令快速启动IOTDB Web Workbench：

docker run -d -p 8080:8080 --name iotdb-web-workbench \
  -e IOTDB_HOST=your-iotdb-server-ip \
  -e IOTDB_PORT=6667 \
  -e IOTDB_USER=root \
  -e IOTDB_PASSWORD=root \
  iotdb-web-workbench:latest

启动后，通过访问 http://localhost:8080 即可打开Web界面。

Docker Compose部署

创建docker-compose.yml文件：

version: '3'
services:
  iotdb-web-workbench:
    image: iotdb-web-workbench:latest
    container_name: iotdb-web-workbench
    restart: always
    ports:
      - "8080:8080"
    environment:
      - IOTDB_HOST=iotdb-server
      - IOTDB_PORT=6667
      - IOTDB_USER=root
      - IOTDB_PASSWORD=root
      - SERVER_PORT=8080
      - LOG_LEVEL=INFO
    volumes:
      - iotdb-workbench-data:/app/data
    networks:
      - iotdb-network

  iotdb-server:
    image: apache/iotdb:latest
    container_name: iotdb-server
    restart: always
    ports:
      - "6667:6667"
      - "31999:31999"
    volumes:
      - iotdb-data:/iotdb/data
      - iotdb-log:/iotdb/logs
    networks:
      - iotdb-network

networks:
  iotdb-network:
    driver: bridge

volumes:
  iotdb-workbench-data:
  iotdb-data:
  iotdb-log:

启动服务：

docker-compose up -d

环境变量配置

以下环境变量可用于配置容器：

持久化存储

为确保数据不会因容器重启而丢失，建议挂载数据卷：

docker run -d -p 8080:8080 --name iotdb-web-workbench \
  -v /host/path/to/data:/app/data \
  -e IOTDB_HOST=your-iotdb-server-ip \
  iotdb-web-workbench:latest

挂载的目录将存储：

• 用户配置
• 查询历史记录
• 导入导出的临时文件
• 应用日志

自定义配置

如需高级配置，可通过挂载配置文件实现：

docker run -d -p 8080:8080 --name iotdb-web-workbench \
  -v /host/path/to/application.properties:/app/config/application.properties \
  -e IOTDB_HOST=your-iotdb-server-ip \
  iotdb-web-workbench:latest

配置参数说明

配置文件(application.properties)主要参数说明：

# 服务器配置
server.port=8080
server.servlet.context-path=/

# IoTDB连接配置
iotdb.host=localhost
iotdb.port=6667
iotdb.timeout=30000

# 连接池配置
spring.datasource.hikari.maximum-pool-size=10
spring.datasource.hikari.minimum-idle=5
spring.datasource.hikari.idle-timeout=300000

# 日志配置
logging.level.root=INFO
logging.level.org.apache.iotdb=DEBUG

# 安全配置
security.enable-csrf=false
security.login-attempts=5
security.lock-duration=300

# 缓存配置
cache.enabled=true
cache.max-size=100
cache.ttl=300

常见问题解决

连接IoTDB失败

1. 检查IoTDB服务是否正常运行
2. 验证网络连接和防火墙设置
3. 确认IoTDB主机地址和端口是否正确
4. 检查用户名和密码是否正确

Web界面访问缓慢

1. 检查服务器资源使用情况
2. 尝试调整缓存配置参数
3. 减少单次查询的数据量
4. 检查网络带宽

数据可视化异常

1. 确认查询语句是否正确
2. 检查时间范围是否合理
3. 验证数据格式是否符合要求
4. 清除浏览器缓存

维护和更新

镜像更新

docker pull iotdb-web-workbench:latest

数据备份

docker exec -it iotdb-web-workbench tar -czf /tmp/backup.tar.gz /app/data
docker cp iotdb-web-workbench:/tmp/backup.tar.gz /host/path/backup.tar.gz

查看日志

docker logs -f iotdb-web-workbench

容器状态监控

docker stats iotdb-web-workbench