dudanogueira/rocket.connect

Rocket.Chat和Chatwoot通用连接器镜像文档

镜像概述

本镜像为Rocket.Chat和Chatwoot提供通用连接功能，通过Docker Compose实现一站式部署。包含Django Web应用、PostgreSQL数据库、Redis缓存、Celery任务处理及Flower监控等组件，支持两者间的数据同步与交互。

核心功能和特性

• Django应用服务：核心连接器应用，处理Rocket.Chat与Chatwoot的通信逻辑，默认监听5000端口
• PostgreSQL数据库：持久化存储应用数据，使用独立卷确保数据安全
• Redis缓存：提供高效缓存服务，支持Celery任务队列
• Celery Worker：处理异步任务，确保连接器后台任务高效执行
• Celery Beat：定时任务调度器，支持周期性任务执行
• Flower：Celery监控工具，提供任务状态可视化界面，默认监听5555端口

使用场景和适用范围

适用于需要在Rocket.Chat（企业聊天平台）和Chatwoot（客户支持平台）之间建立数据连接的企业或团队，可实现消息同步、用户数据互通、事件触发等场景。

使用方法和配置说明

Docker Compose配置

完整的docker-compose.yml配置如下：

yaml
version: '3'

volumes:
  production_postgres_data: {}
  production_postgres_data_backups: {}

services:
  django: &django
    image: dudanogueira/rocket.connect:latest
    depends_on:
      - postgres
      - redis
    environment:
      DJANGO_SETTINGS_MODULE: config.settings.production
      DJANGO_SECRET_KEY: change_me  # 需替换为安全的随机密钥
      DJANGO_ADMIN_URL: change_me/  # 需替换为自定义管理URL路径
      DJANGO_ALLOWED_HOSTS: "connect.mycompany.com.br"  # 需替换为实际域名
      DJANGO_SECURE_SSL_REDIRECT: "True"  # 是否启用SSL重定向
      DJANGO_ACCOUNT_ALLOW_REGISTRATION: "True"  # 是否允许用户注册
      WEB_CONCURRENCY: 4  # 工作进程数
      REDIS_URL: redis://redis:6379/0  # Redis连接地址
      CELERY_FLOWER_USER: change_me  # Flower监控用户名
      CELERY_FLOWER_PASSWORD: debug  # Flower监控密码，需替换为安全密码
      POSTGRES_HOST: postgres  # PostgreSQL主机名
      POSTGRES_PORT: 5432  # PostgreSQL端口
      POSTGRES_DB: rocket_connect  # 数据库名
      POSTGRES_USER: change_me  # 数据库用户名，需替换
      POSTGRES_PASSWORD: change_me  # 数据库密码，需替换
    command: /start
    ports:
      - "0.0.0.0:5000:5000"  # 映射Django应用端口

  postgres:
    image: postgres
    restart: always
    volumes:
      - production_postgres_data:/var/lib/postgresql/data:Z  # 数据持久化卷
    environment:
      POSTGRES_HOST: postgres
      POSTGRES_PORT: 5432
      POSTGRES_DB: rocket_connect
      POSTGRES_USER: change_me  # 需与django服务中的POSTGRES_USER一致
      POSTGRES_PASSWORD: change_me  # 需与django服务中的POSTGRES_PASSWORD一致

  redis:
    image: redis:5.0  # Redis 5.0镜像

  celeryworker:
    <<: *ols
    command: /start-celeryworker  # 启动Celery Worker
    ports: []  # 不暴露额外端口

  celerybeat:
    <<: *django  # 继承django服务配置
    command: /start-celerybeat  # 启动Celery Beat
    ports: []  # 不暴露额外端口

  flower:
    <<: *django  # 继承django服务配置
    command: /start-flower  # 启动Flower监控
    ports:
        - "0.0.0.0:5555:5555"  # 映射Flower监控端口

环境变量说明

部署步骤

1. 准备配置文件：将上述docker-compose.yml保存到本地目录

2. 修改配置：替换所有标记为change_me的环境变量值，确保安全性

3. 启动服务：在配置文件所在目录执行以下命令启动所有服务

   bash
   docker-compose up -d
   

4. 验证服务：

   • 访问http://<服务器IP>:5000检查Django应用是否正常运行
   • 访问http://<服务器IP>:5555使用Flower用户名和密码登录，验证Celery监控状态

5. 停止服务（如需）：

   bash
   docker-compose down