rocketchat/presence-service

Rocket.Chat Presence 微服务镜像

概述

Rocket.Chat Presence 微服务是 Rocket.Chat 生态的核心组件之一，专门负责用户在线状态管理，包括状态追踪、实时同步及相关事件通知。该服务通过独立部署的方式，优化 Rocket.Chat 主服务的状态处理逻辑，提升系统在大规模用户场景下的性能与可靠性。

核心功能

用户状态管理

• 实时追踪用户连接状态（在线、离线、离开、忙碌等）
• 支持自定义状态及状态过期策略
• 提供状态变更历史记录查询接口

实时同步机制

• 跨服务节点状态数据同步（适用于集群部署）
• 低延迟状态更新通知（通过 WebSocket 或 HTTP 回调）
• 状态一致性校验与冲突解决

高可用支持

• 无状态设计，支持水平扩展
• 故障自动恢复与状态数据持久化
• 与 Rocket.Chat 主服务松耦合，独立部署与升级

性能优化

• 轻量级架构，降低主服务资源占用
• 批量状态更新处理，减少数据库交互
• 可配置的缓存策略，提升查询效率

使用场景

基础部署增强

• 单节点 Rocket.Chat 实例中，独立管理用户状态，减轻主服务负载

集群环境状态同步

• 多节点 Rocket.Chat 集群部署时，确保跨节点用户状态一致性
• 支持跨数据中心部署场景下的状态数据同步

大规模用户场景

• 适用于 thousands 级以上并发用户的企业部署，保障状态更新实时性
• 优化高并发场景下的数据库读写性能

集成扩展

• 作为独立服务为第三方应用提供用户状态查询接口
• 与监控系统集成，实现用户活跃度分析

使用方法

前置要求

• Rocket.Chat 主服务版本 ≥ 6.0.0（需与微服务版本匹配）
• MongoDB 数据库（与 Rocket.Chat 主服务共享或独立部署，版本 ≥ 5.0）
• 网络连通性：微服务需能访问 Rocket.Chat 主服务 API 及 MongoDB

获取镜像

bash
docker pull rocket.chat/presence-service:latest
# 建议使用具体版本号而非 latest，如 rocket.chat/presence-service:1.2.0

Docker Run 示例

bash
docker run -d \
  --name rocket-chat-presence \
  -p 3005:3005 \
  -e PORT=3005 \
  -e MONGO_URL=mongodb://mongo:27017/rocketchat \
  -e ROCKETCHAT_URL=http://rocket-chat:3000 \
  -e LOG_LEVEL=info \
  -e INSTANCE_ID=presence-service-01 \
  rocket.chat/presence-service:latest

Docker Compose 示例

yaml
version: '3.8'

services:
  presence-service:
    image: rocket.chat/presence-service:latest
    container_name: rocket-chat-presence
    restart: unless-stopped
    ports:
      - "3005:3005"
    environment:
      - PORT=3005
      - MONGO_URL=mongodb://mongo:27017/rocketchat
      - ROCKETCHAT_URL=http://rocket-chat:3000
      - ROCKETCHAT_USERNAME=presence-service-user
      - ROCKETCHAT_PASSWORD=service-password
      - LOG_LEVEL=info
      - CACHE_TTL=300
      - SYNC_INTERVAL=5000
    depends_on:
      - rocket-chat
      - mongo

  rocket-chat:
    image: rocket.chat/rocket.chat:latest
    # Rocket.Chat 主服务配置...

  mongo:
    image: mongo:5.0
    # MongoDB 配置...

配置参数

环境变量

注意事项

1. 版本兼容性：需确保微服务版本与 Rocket.Chat 主服务版本匹配（可通过 Rocket.Chat 官方文档 查询版本对应关系）。

2. 服务账号权限：ROCKETCHAT_USERNAME 需配置为 Rocket.Chat 中的管理员或拥有 "presence" 权限的专用服务账号。

3. 数据库性能：大规模部署时建议为 MongoDB 配置独立索引（针对 presence 集合），并监控数据库连接数。

4. 网络安全：生产环境中需通过环境变量或配置文件加密敏感信息（如数据库密码、服务账号密码），避免明文配置。

5. 资源配置：根据用户规模调整容器资源（CPU/内存），建议起步配置：2 CPU 核心，4GB 内存。