centrifugo/centrifugo-pro

Centrifugo PRO 镜像文档

概述

Centrifugo PRO 是基于 Centrifugo 社区版构建的企业级实时消息服务器，专注于提供低延迟、高并发的实时数据传输能力。它基于 WebSocket、HTTP Streaming 等多种实时通信协议，支持跨平台客户端集成，适用于构建需要实时交互的各类 Web 应用。PRO 版本在社区版基础上增加了企业级特性，满足生产环境下的高可靠性和扩展性需求。

核心功能与特性

• 增强安全性：提供高级身份验证机制（如 JWT 验证增强、细粒度权限控制）、TLS 加密传输及 IP 访问限制。
• 高性能与可扩展性：支持数万级并发连接，提供自动负载均衡和集群部署能力，轻松应对流量增长。
• 高级消息传递：支持消息持久化、历史消息查询、消息优先级排序及消息投递确认机制。
• 企业级支持：包含专属技术支持、定期安全更新及定制化功能开发服务。
• 多协议支持：兼容 WebSocket、Server-Sent Events (SSE)、HTTP Long Polling 等协议，适配不同客户端环境。
• 灵活配置：支持通过环境变量、配置文件或 API 动态调整服务参数，简化部署与维护。

使用场景

Centrifugo PRO 适用于各类需要实时数据交互的场景，包括但不限于：

• 实时聊天应用（如客服系统、团队协作工具）
• 实时监控仪表盘（如系统监控、业务数据实时可视化）
• 协作编辑工具（如多人文档协作、实时画板）
• 实时通知系统（如订单状态更新、社交平台通知）
• 在线教育平台（如实时互动课堂、弹幕系统）

使用方法

快速启动

通过以下命令快速启动 Centrifugo PRO 容器：

bash
docker run -d \
  --name centrifugo-pro \
  -p 8000:8000 \
  -e CENTRIFUGO_PRO_LICENSE_KEY="your-license-key" \
  -e CENTRIFUGO_SECRET="your-secure-secret" \
  -e CENTRIFUGO_LOG_LEVEL="info" \
  docker.xuanyuan.run/centrifugo/centrifugo-pro:latest

Docker Compose 配置示例

创建 docker-compose.yml 文件实现更灵活的部署：

yaml
version: '3.8'
services:
  centrifugo-pro:
    image: docker.xuanyuan.run/centrifugo/centrifugo-pro:latest
    container_name: centrifugo-pro
    ports:
      - "8000:8000"  # 服务端口
      - "8001:8001"  # 管理 API 端口（若启用）
    environment:
      - CENTRIFUGO_PRO_LICENSE_KEY=your-license-key  # 必需：PRO 许可证密钥
      - CENTRIFUGO_SECRET=your-secure-secret          # 用于签名认证令牌的密钥
      - CENTRIFUGO_PORT=8000                          # 服务监听端口
      - CENTRIFUGO_LOG_LEVEL=info                     # 日志级别（debug/info/warn/error）
      - CENTRIFUGO_ENGINE=redis                       # 消息引擎（支持 redis 等持久化存储）
      - CENTRIFUGO_REDIS_ADDRESS=redis:6379           # Redis 地址（若使用 redis 引擎）
    volumes:
      - ./centrifugo-data:/var/lib/centrifugo         # 持久化数据目录
      - ./config:/etc/centrifugo                      # 配置文件目录（可选）
    depends_on:
      - redis
    restart: unless-stopped

  redis:
    image: docker.xuanyuan.run/redis:alpine
    ports:
      - "6379:6379"
    volumes:
      - redis-data:/data
    restart: unless-stopped

volumes:
  redis-data:
  centrifugo-data:

启动服务：

bash
docker-compose up -d

配置参数说明

环境变量

配置文件

如需高级配置，可通过挂载配置文件（如 config.json）自定义服务行为。示例配置：

json
{
  "secret": "your-secure-secret",
  "license_key": "your-license-key",
  "port": 8000,
  "log_level": "info",
  "engine": "redis",
  "redis_address": "redis:6379",
  "max_concurrent": 50000,
  "persistent": true,
  "history_size": 1000,
  "history_lifetime": 3600,
  "tls": {
    "enabled": true,
    "cert_file": "/etc/centrifugo/tls/cert.pem",
    "key_file": "/etc/centrifugo/tls/key.pem"
  }
}

注意事项

• 许可证管理：确保 CENTRIFUGO_PRO_LICENSE_KEY 有效且未过期，否则服务将无法启动。
• 安全建议：生产环境中务必使用强密钥（CENTRIFUGO_SECRET）并启用 TLS 加密。
• 资源配置：根据预期并发量调整容器 CPU/内存限制，建议至少分配 1 CPU 核心和 1GB 内存。
• 持久化存储：高可靠性场景下推荐使用 Redis 或其他分布式存储作为消息引擎，避免内存引擎导致的消息丢失。
• 版本更新：定期更新镜像以获取最新安全补丁和功能优化，更新前建议备份配置和数据。