cnosdb/cnosdb Docker 镜像 - 轩辕镜像

开源分布式时间序列数据库 Docker 镜像文档

镜像概述

本镜像基于开源分布式时间序列数据库构建，专注于处理以时间为索引的结构化数据（时间序列数据）。通过分布式架构设计，实现了对海量时序数据的高效存储、快速查询及长期归档，适用于需要处理高写入吞吐量和高查询性能场景的业务需求。

核心功能与特性

分布式架构

• 采用分片与副本机制实现数据分布式存储，支持跨节点数据冗余，保障数据可靠性
• 自动数据分片与负载均衡，避免单点瓶颈，提升集群整体处理能力

高效数据处理

• 针对时间序列数据特性优化的存储引擎，支持高压缩率，降低存储成本
• 支持批量写入与实时写入，单节点写入吞吐量可达数十万点/秒
• 内置时序数据查询优化器，支持按时间范围、标签过滤等高效查询

可扩展性与灵活性

• 支持横向扩展，通过添加节点动态提升集群存储容量与处理能力
• 兼容主流时间序列数据协议（如InfluxDB Line Protocol、Prometheus Remote Write），易于集成现有监控或数据采集系统

高可用性保障

• 支持数据多副本存储，节点故障时自动触发副本切换，保障服务连续性
• 内置数据备份与恢复机制，支持定时快照与时间点恢复

使用场景与适用范围

IT基础设施监控

• 存储服务器、网络设备、应用系统的监控指标（CPU、内存、网络流量等），支持实时查询与历史趋势分析

物联网（IoT）数据存储

• 采集并存储传感器、智能设备产生的时序数据（温度、湿度、设备状态等），支持大规模设备接入场景

工业监控与运维

• 存储工业生产线上的设备运行数据、工艺参数，用于生产过程监控、故障预警及质量分析

***与业务监控

• 记录交易时间序列数据、用户行为时序数据，支持业务指标实时监控与历史数据分析

使用方法与配置说明

基本部署（单节点模式）

通过 docker run 快速启动单节点实例，适用于开发测试或小规模数据场景：

bash
docker run -d \
  --name timeseries-db \
  -p 8086:8086 \  # 默认API端口
  -v /host/path/data:/var/lib/timeseriesdb \  # 挂载数据卷持久化存储
  -e TSDB_DB_NAME=defaultdb \  # 初始化数据库名称
  -e TSDB_RETENTION_POLICY=7d \  # 数据保留策略（默认7天）
  timeseriesdb:latest

分布式集群部署（docker-compose示例）

适用于生产环境，需至少3个节点确保高可用：

yaml
version: '3'
services:
  tsdb-node1:
    image: timeseriesdb:latest
    container_name: tsdb-node1
    ports:
      - "8086:8086"
    volumes:
      - ./node1-data:/var/lib/timeseriesdb
    environment:
      - TSDB_NODE_NAME=node1
      - TSDB_CLUSTER_PEERS=tsdb-node1:8088,tsdb-node2:8088,tsdb-node3:8088  # 集群节点列表（内部通信端口）
      - TSDB_REPLICA_COUNT=2  # 数据副本数
      - TSDB_DB_NAME=prod-db
    restart: always

  tsdb-node2:
    image: timeseriesdb:latest
    container_name: tsdb-node2
    volumes:
      - ./node2-data:/var/lib/timeseriesdb
    environment:
      - TSDB_NODE_NAME=node2
      - TSDB_CLUSTER_PEERS=tsdb-node1:8088,tsdb-node2:8088,tsdb-node3:8088
      - TSDB_REPLICA_COUNT=2
      - TSDB_DB_NAME=prod-db
    restart: always

  tsdb-node3:
    image: timeseriesdb:latest
    container_name: tsdb-node3
    volumes:
      - ./node3-data:/var/lib/timeseriesdb
    environment:
      - TSDB_NODE_NAME=node3
      - TSDB_CLUSTER_PEERS=tsdb-node1:8088,tsdb-node2:8088,tsdb-node3:8088
      - TSDB_REPLICA_COUNT=2
      - TSDB_DB_NAME=prod-db
    restart: always

核心配置参数（环境变量）

数据持久化

通过挂载主机目录或命名卷实现数据持久化，避免容器重启后数据丢失：

• 核心数据目录：/var/lib/timeseriesdb（包含元数据、分片数据、WAL日志等）
• 建议使用命名卷管理：docker volume create tsdb-data && docker run -v tsdb-data:/var/lib/timeseriesdb ...

常用操作示例

写入数据（HTTP API）

bash
curl -X POST "http://localhost:8086/write?db=defaultdb" \
  --data-binary "cpu_usage,host=server01,region=us-west value=23.5 1620000000000000000"

查询数据（HTTP API）

bash
curl -G "http://localhost:8086/query?db=defaultdb&pretty=true" \
  --data-urlencode "q=SELECT mean(value) FROM cpu_usage WHERE host='server01' AND time > now() - 1h GROUP BY time(10m)"