rocketchat/stream-hub-service

Rocket.Chat Stream Hub 微服务镜像

镜像概述

Stream Hub是Rocket.Chat生态系统中的核心微服务之一，专门用于处理实时数据流和消息分发，是支持Rocket.Chat平台实时通信功能的关键组件。该镜像提供了预配置的运行环境，可快速集成到Rocket.Chat部署架构中，确保实时消息的高效处理和分发。

核心功能与特性

• 实时数据流处理：高效处理Rocket.Chat平台的实时消息流，支持高并发场景下的消息传输。
• 消息分发管理：负责将消息路由至目标用户或服务，确保消息的实时性和准确性。
• 与Rocket.Chat核心集成：无缝对接Rocket.Chat核心服务，共享用户数据和消息上下文。
• 可扩展性：支持水平扩展，可通过增加实例数量应对数据流负载增长。
• 轻量级设计：基于优化的基础镜像构建，资源占用低，部署高效。

使用场景与适用范围

• Rocket.Chat平台部署：作为Rocket.Chat完整部署架构的必要组件，需与Rocket.Chat核心服务、数据库等组件配合使用。
• 高并发实时通信场景：适用于企业协作平台、在线社区、客户支持系统等需要处理大量实时消息的场景。
• 分布式部署环境：支持跨节点、跨区域部署，满足分布式架构下的实时数据流同步需求。

使用方法与配置说明

前提条件

• 已部署Rocket.Chat核心服务（版本需与Stream Hub兼容，具体版本要求参考Rocket.Chat官方文档）。
• 已配置Docker环境（Docker 19.03+或兼容版本）。

基本部署（docker run）

bash
docker run -d \
  --name rocketchat-stream-hub \
  -p 3000:3000 \
  -e MONGO_URL=mongodb://mongo:27017/rocketchat \
  -e ROCKETCHAT_URL=http://rocketchat:3000 \
  rocketchat/stream-hub:latest

Docker Compose配置示例

yaml
version: '3'

services:
  stream-hub:
    image: rocketchat/stream-hub:latest
    container_name: rocketchat-stream-hub
    ports:
      - "3000:3000"
    environment:
      - MONGO_URL=mongodb://mongo:27017/rocketchat  # MongoDB数据库连接地址
      - ROCKETCHAT_URL=http://rocketchat:3000        # Rocket.Chat核心服务地址
      - LOG_LEVEL=info                               # 日志级别（debug/info/warn/error）
      - PORT=3000                                    # 服务监听端口
    depends_on:
      - rocketchat
      - mongo
    restart: unless-stopped

  # 其他相关服务（示例）
  rocketchat:
    image: rocketchat/rocket.chat:latest
    # ...（Rocket.Chat核心服务配置）

  mongo:
    image: mongo:latest
    # ...（MongoDB配置）

环境变量配置

验证部署

服务启动后，可通过访问 http://<host>:3000/health 端点验证服务状态，返回 OK 表示服务正常运行。

注意事项

• 确保与Rocket.Chat核心服务版本兼容，版本不匹配可能导致功能异常。
• 生产环境中建议配置持久化日志和监控，以便追踪数据流处理状态。
• 高负载场景下可通过增加实例数量并配置负载均衡提高处理能力。

参考链接

• Rocket.Chat官方文档
• https://hub.docker.com/r/rocketchat/stream-hub