innovarhealthcare/bridgelink

Innovar BridgeLink Docker镜像文档

1. 镜像概述

Innovar BridgeLink Docker镜像是一款轻量级容器化解决方案，专为跨系统、跨服务集成设计。其核心目标是简化不同应用系统间的通信流程，提供高效、可靠的数据传输与协议转换能力，帮助用户快速实现异构系统的无缝连接。

主要用途

• 实现不同协议间的转换（如HTTP、MQTT、TCP/UDP等）
• 支持跨平台应用系统的数据同步与交互
• 简化分布式架构中服务间的通信链路管理

2. 核心功能与特性

2.1 核心功能

• 多协议支持：兼容HTTP、HTTPS、MQTT、TCP、UDP等主流通信协议
• 数据转换：内置数据格式转换模块，支持JSON、XML、CSV等格式互转
• 流量控制：提供请求限流、带宽控制功能，保障系统稳定性
• 安全传输：支持TLS/SSL加密通信，确保数据传输安全性

2.2 产品特性

• 轻量化设计：基于Alpine Linux构建，镜像体积小（<50MB），资源占用低
• 高可用性：内置故障自动恢复机制，支持服务健康检查与自动重启
• 灵活配置：支持环境变量、配置文件及API动态配置，适配多样化场景
• 监控集成：提供Prometheus metrics接口，支持主流监控系统接入

3. 使用场景

3.1 适用范围

• 企业级系统集成（如ERP、CRM系统间数据同步）
• 物联网（IoT）设备数据汇聚与转发
• 微服务架构中跨服务通信桥接
• 云边协同场景下的数据传输通道

3.2 典型场景示例

• 将IoT设备的MQTT协议数据转换为HTTP协议转发至云端服务
• 实现 legacy 系统（TCP协议）与现代微服务（HTTP协议）的双向通信
• 在跨区域部署中作为数据转发节点，优化传输路径

4. 使用方法

4.1 获取镜像

bash
docker pull docker.xuanyuan.run/innovar/bridgelink:latest

4.2 基本运行命令

bash
docker run -d \
  --name bridgelink \
  -p 8080:8080 \
  -e PROTOCOL_IN=MQTT \
  -e PROTOCOL_OUT=HTTP \
  -e MQTT_BROKER=mqtt://broker.example.com:1883 \
  -e HTTP_TARGET=https://api.example.com/data \
  docker.xuanyuan.run/innovar/bridgelink:latest

4.3 Docker Compose配置示例

yaml
version: '3.8'
services:
  bridgelink:
    image: docker.xuanyuan.run/innovar/bridgelink:latest
    container_name: bridgelink
    restart: unless-stopped
    ports:
      - "8080:8080"  # 主服务端口
      - "9090:9090"  # 监控指标端口
    environment:
      - LOG_LEVEL=info  # 日志级别：debug/info/warn/error
      - PROTOCOL_IN=MQTT  # 输入协议
      - PROTOCOL_OUT=HTTP  # 输出协议
      - MQTT_BROKER=mqtt://broker.example.com:1883  # MQTT broker地址
      - MQTT_TOPIC=devices/#  # MQTT订阅主题
      - HTTP_TARGET=https://api.example.com/data  # HTTP目标服务地址
      - HTTP_METHOD=POST  # HTTP请求方法
      - RETRY_DELAY=3s  # 重试延迟时间
      - MAX_RETRIES=5  # 最大重试次数
    volumes:
      - ./config:/app/config  # 挂载自定义配置文件（可选）

5. 配置说明

5.1 环境变量参数

5.2 协议特定配置

5.2.1 MQTT协议配置

5.2.2 HTTP协议配置

6. 日志与监控

6.1 日志输出

容器日志可通过docker logs bridgelink命令查看，默认包含：

• 连接状态变更日志
• 数据传输统计信息
• 错误与异常详情

6.2 监控指标

通过METRICS_PORT暴露Prometheus格式指标，主要指标包括：

• bridgelink_data_transferred_bytes：总传输字节数
• bridgelink_requests_total：总请求数
• bridgelink_requests_failed_total：失败请求数
• bridgelink_connections_active：活跃连接数

7. 常见问题

Q: 如何自定义数据转换规则？

A: 可通过挂载配置文件到/app/config/transform.json，定义字段映射与格式转换逻辑，具体格式参见官方配置手册。

Q: 容器启动后无响应如何排查？

A: 1. 检查日志确认是否有配置错误；2. 验证端口映射是否正确；3. 通过docker exec -it bridgelink /bin/sh进入容器查看运行状态。

Q: 是否支持集群部署？

A: 支持。通过共享配置存储（如NFS、Consul）实现配置同步，结合负载均衡器可构建高可用集群。