rocketchat/presence-service Docker Image Overview

rocketchat/presence-service

Rocket.Chat的在线状态微服务

1 收藏0 次下载

💣 CI/CD 卡在拉镜像？问题不在代码，在镜像源

中文简介版本下载

💣 CI/CD 卡在拉镜像？问题不在代码，在镜像源

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=[***] \
  -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=[***]
      - 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 配置...

配置参数

环境变量

参数名	描述	默认值	示例值
`PORT`	服务监听端口	`3005`	`3005`
`MONGO_URL`	MongoDB 连接 URL（需包含数据库名）	-	`mongodb://user:pass@mongo:27017/rocketchat`
`MONGO_OPLOG_URL`	MongoDB Oplog 连接 URL（可选，用于同步）	-	`mongodb://user:pass@mongo:27017/local?authSource=admin`
`ROCKETCHAT_URL`	Rocket.Chat 主服务基础 URL	-	`[***]`
`ROCKETCHAT_USERNAME`	访问 Rocket.Chat API 的服务账号用户名	-	`presence-service`
`ROCKETCHAT_PASSWORD`	服务账号密码	-	`secure-password-123`
`LOG_LEVEL`	日志级别（debug/info/warn/error）	`info`	`debug`
`INSTANCE_ID`	服务实例唯一标识（集群部署必填）	自动生成	`presence-node-01`
`CACHE_TTL`	状态缓存过期时间（秒）	`300`	`600`
`SYNC_INTERVAL`	集群状态同步间隔（毫秒）	`5000`	`3000`
`MAX_CONCURRENT_SYNC`	最大并发同步任务数	`10`	`20`
`HEALTH_CHECK_PORT`	健康检查端口	与 `PORT` 一致	`3006`

注意事项

版本兼容性：需确保微服务版本与 Rocket.Chat 主服务版本匹配（可通过 Rocket.Chat 官方文档查询版本对应关系）。
服务账号权限：ROCKETCHAT_USERNAME 需配置为 Rocket.Chat 中的管理员或拥有 "presence" 权限的专用服务账号。
数据库性能：大规模部署时建议为 MongoDB 配置独立索引（针对 presence 集合），并监控数据库连接数。
网络安全：生产环境中需通过环境变量或配置文件加密敏感信息（如数据库密码、服务账号密码），避免明文配置。
资源配置：根据用户规模调整容器资源（CPU/内存），建议起步配置：2 CPU 核心，4GB 内存。