networkcloudmanager/influxdb-relay

appcelerator/influxdb-relay（冻结版本）镜像文档

1. 镜像概述

本镜像为appcelerator/influxdb-relay的冻结版本，基于原始InfluxDB中继服务构建，提供固定版本的稳定运行环境。通过冻结版本，确保服务行为一致性，避免因上游版本更新导致的兼容性问题，适用于对版本稳定性有严格要求的生产环境。

2. 核心功能与特性

• 数据中继转发：支持将InfluxDB写入请求转发至一个或多个后端InfluxDB实例，实现数据复制与分发
• 高可用支持：通过多目标实例配置，确保写入请求不丢失，提升InfluxDB集群可用性
• 轻量级设计：基于Go语言开发，资源占用低，转发性能高效
• 配置灵活：支持通过配置文件自定义监听端口、目标实例、数据库及保留策略等参数
• 版本稳定性：冻结版本机制，固定功能集，避免自动更新带来的部署风险

3. 使用场景与适用范围

• 固定版本依赖场景：需要长期维持特定中继服务版本，避免更新影响现有业务的部署
• InfluxDB高可用架构：作为写入层中继，将数据同步至多个InfluxDB实例，实现读写分离或灾备
• 数据多副本存储：需将同一份时序数据分发至不同环境（如生产/测试库、本地/云端实例）的场景
• 生产环境稳定部署：对服务版本变更敏感，要求功能行为可预测的企业级应用

4. 使用方法与配置说明

4.1 基础部署（Docker Run）

通过docker run命令快速启动，需挂载配置文件指定转发规则：

bash
docker run -d \
  --name influxdb-relay \
  --restart always \
  -p 9096:9096 \  # 映射中继服务监听端口
  -v /host/path/to/relay.conf:/etc/influxdb-relay/relay.conf \  # 挂载本地配置文件
  appcelerator/influxdb-relay:frozen

4.2 配置文件格式说明

中继服务通过relay.conf配置文件定义转发规则，采用TOML格式，示例如下：

toml
# HTTP中继配置
[[http]]
name = "primary-relay"          # 中继名称（自定义标识）
bind-addr = "0.0.0.0:9096"      # 服务监听地址与端口
database = "metrics"            # 目标数据库名称（可选，优先级低于写入请求中的数据库）
retention-policy = "autogen"    # 目标保留策略（可选，优先级低于写入请求中的策略）

  # 后端目标InfluxDB实例配置（可配置多个）
  [[http.targets]]
  name = "influxdb-node-1"      # 目标实例名称
  url = "http://192.168.1.100:8086"  # 目标实例HTTP API地址
  timeout = "10s"               # 超时时间（默认5s）
  skip-tls-verification = false # 是否跳过TLS证书验证（默认false）

  [[http.targets]]
  name = "influxdb-node-2"
  url = "http://192.168.1.101:8086"

4.3 Docker Compose部署示例

通过docker-compose.yml整合中继服务与InfluxDB集群，示例配置：

yaml
version: '3.8'
services:
  influxdb-relay:
    image: appcelerator/influxdb-relay:frozen
    ports:
      - "9096:9096"
    volumes:
      - ./relay.conf:/etc/influxdb-relay/relay.conf
    depends_on:
      - influxdb-1
      - influxdb-2
    restart: unless-stopped

  influxdb-1:
    image: influxdb:1.8
    volumes:
      - influxdb-data-1:/var/lib/influxdb
    environment:
      - INFLUXDB_DB=metrics
    restart: unless-stopped

  influxdb-2:
    image: influxdb:1.8
    volumes:
      - influxdb-data-2:/var/lib/influxdb
    environment:
      - INFLUXDB_DB=metrics
    restart: unless-stopped

volumes:
  influxdb-data-1:
  influxdb-data-2:

4.4 关键配置参数说明

5. 注意事项

• 版本冻结限制：本镜像为功能冻结版本，不提供上游安全更新与功能迭代，使用前需评估原始版本安全基线
• 配置文件权限：宿主机挂载的配置文件需确保容器内进程可读（建议权限设置为644）
• 网络连通性：需确保容器与所有目标InfluxDB实例之间网络通畅，防火墙需开放对应端口
• 资源配置：根据转发流量规模调整容器CPU/内存资源，建议监控中继服务响应延迟与错误率
• 数据一致性：中继服务仅转发写入请求，不处理查询请求，需通过其他机制（如InfluxDB集群）保证查询一致性