这份详细的部署教程将指引您安装和运行 Rocket.Chat——一个功能强大的开源团队通讯平台，可作为 Slack 或 Microsoft Teams 的替代方案。它提供实时聊天、视频会议、文件共享等功能，并支持自托管，让您完全掌控数据。

Rocket.Chat 的部署方式非常灵活，从适合个人/小团队的Docker Compose 快速部署，到面向大规模生产的Kubernetes 集群都有覆盖。对于大多数用户，使用官方提供的 Docker Compose 方案是最快捷、最推荐的入门方法。

整个部署流程分为几步：准备服务器、安装 Docker 环境、配置并启动服务、以及完成初始化设置。

📋 部署前准备

系统要求

在开始前，请确保您的服务器满足以下最低要求：

资源 最低配置 (小团队) 推荐配置 (生产环境)
CPU 2 vCPU 4-8 vCPU
内存 (RAM) 2 GB 4-16 GB
存储 10 GB 20-450 GB (SSD)
操作系统 Ubuntu 22.04/24.04, Debian 12, CentOS 8/9 等 -

网络要求

  • 开放端口：确保 80 (HTTP) 和 443 (HTTPS) 端口对公网开放，3000 端口用于内部服务通信。
  • 域名 (推荐)：为 Rocket.Chat 准备一个域名，并解析到您的服务器 IP，以便启用 HTTPS。

🐳 部署方式：使用 Docker Compose (推荐)

这是官方推荐的标准方式，适用于大多数场景。它使用 Docker Compose 编排了 Rocket.Chat 应用、MongoDB 数据库、NATS 消息队列以及可选的 Traefik 反向代理和监控工具。

第一步：安装 Docker 与 Docker Compose

对于 Ubuntu/Debian 系统，您可以使用官方脚本自动化安装：

1
2
3
4
5
# 下载并执行 Docker 安装脚本
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh
sudo systemctl enable --now docker
sudo usermod -aG docker $USER  # 将当前用户加入 docker 组，避免每次使用 sudo

安装完成后，注销并重新登录以使组权限生效。Docker Compose 插件通常会随 Docker Engine 一起安装。

第二步：获取 Docker Compose 文件

克隆官方提供的 Compose 文件仓库，并进入目录：

1
2
git clone --depth 1 https://github.com/RocketChat/rocketchat-compose.git
cd rocketchat-compose

第三步：配置环境变量

  1. 复制示例环境变量文件：

    1
    cp .env.example .env

  2. 编辑 .env 文件，至少修改以下几个关键配置：

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    # 使用您自己的域名或 IP
    DOMAIN=your-domain.com
    ROOT_URL=https://your-domain.com

    # 如果您需要使用 HTTPS，设置以下两项
    TRAEFIK_PROTOCOL=https
    LETSENCRYPT_EMAIL=your-email@example.com
    LETSENCRYPT_ENABLED=true

    # 如果您没有域名，仅在本地网络使用，可暂时保持 HTTP
    # TRAEFIK_PROTOCOL=http
    # ROOT_URL=http://your-server-ip

第四步：启动所有服务

执行以下命令，Docker Compose 会自动拉取镜像并启动 Rocket.Chat、MongoDB、Traefik 等容器：

1
2
3
4
5
6
docker compose -f compose.monitoring.yml \
               -f compose.traefik.yml \
               -f compose.database.yml \
               -f compose.yml \
               -f compose.nats.yml \
               -f docker.yml up -d
  • -f 参数指定了多个 Compose 文件，分别负责监控、反向代理、数据库等不同部分。
  • up -d 表示以后台守护进程模式运行。

第五步：访问并完成初始化

  • 在浏览器中访问您配置的 ROOT_URL（例如 https://your-domain.com 或 http://your-server-ip）。
  • 您会看到 Rocket.Chat 的设置向导。按照提示创建管理员账户、填写组织名称，并完成工作区配置。

💡 其他部署选项

  • 使用独立 Compose 文件快速尝试：如果您只是想快速测试，而不需要 Traefik 和监控，可以使用项目根目录下更简单的 docker-compose.yml 文件，它只包含 Rocket.Chat 和 MongoDB。
  • 无域名部署 (IP 访问)：如果仅在本地网络使用且无域名，可设置 TRAEFIK_PROTOCOL=http 和 ROOT_URL=http://<服务器IP>。此时，您可以通过 http://<服务器IP> 直接访问。
  • ARM 架构：官方镜像可能不直接支持 ARM 设备。社区提供了非官方的 ARM64 镜像（如 p1626/rocketchat-arm64），您可以通过修改 docker-compose.yml 中的 image 字段来使用。
  • 生产环境/大规模部署：对于需要高可用和扩展性的场景，官方推荐使用 Kubernetes 部署。您可以参考官方提供的 Helm Chart 进行配置。

🔧 服务器安全与 HTTPS 配置

Docker Compose 方案默认集成 Traefik 作为反向代理，会自动申请和更新 Let’s Encrypt SSL 证书，为您的站点启用 HTTPS，这是保护数据安全的重要步骤。

📝 总结

总结：部署 Rocket.Chat 的核心步骤是确保服务器满足要求，安装 Docker，然后使用官方 Compose 文件一键启动。对于大多数用户，这是最顺畅的路径。

在配置 .env 文件时，如果准备绑定域名并启用 HTTPS，可以参考上面的配置；如果暂时没有域名，也可以先用 IP 地址和 HTTP 协议测试。