2606 字
13 分钟
Rocket.Chat:私有聊天服务器部署
2026-11-15

先说清楚:为什么要自建聊天服务器#

团队群聊、家庭沟通、朋友之间传文件,日常用的都是别人的平台:聊天记录存在对方服务器上,账号说封就封,文件链接过段时间就失效。自建聊天服务器解决的就是这件事——数据在自己的 VPS 上,规则自己定,想留多久留多久。

Rocket.Chat 是自建聊天里最成熟的开源方案之一:频道、私聊、文件传输、音视频通话(通过集成)、多端客户端一应俱全,界面接近 Slack,用起来没有学习成本。这一篇我们用 Docker Compose 把它完整搭起来:Rocket.Chat 本体加 MongoDB 数据库,再通过前面部署的反向代理对外提供 HTTPS 访问。

整篇的主线是:准备 Compose → 初始化 MongoDB 副本集 → 启动并完成管理员设置 → 关紧注册入口 → 客户端接入 → 日常维护与排障。

部署架构与资源要求#

Rocket.Chat 不是单容器能跑起来的,它强依赖 MongoDB,而且新版本要求 MongoDB 以**副本集(Replica Set)**模式运行——这是很多人第一次部署时踩的坑:直接套个单机 MongoDB,容器能启动,但日志里会反复报 oplog 相关错误,消息实时推送也不正常。所以 Compose 里要多一个初始化容器,专门负责把副本集拉起来。

组件作用说明
rocket.chat聊天服务本体监听 3000 端口,只对内
mongo数据库副本集模式,存全部消息与用户数据
mongo-init一次性初始化容器执行 rs.initiate 后自动退出
Nginx Proxy Manager反向代理统一入口与 HTTPS,见系列第 2 篇

资源方面,Rocket.Chat 是这批自建服务里偏重的一个:

使用规模建议配置备注
个人/家庭(<10 人)2 核 2 GB空载内存约 800 MB
小团队(10–50 人)2 核 4 GB建议预留 Swap
50 人以上4 核 8 GB 起另考虑对象存储存附件

域名提前解析好一个子域名,例如 chat.example.com,解析方法在系列第 1 篇 自建服务入门:从一台 VPS 开始的完整规划 里已经交代过。

编写 Compose 并启动#

在服务器上新建目录并写入 docker-compose.yml:

services:
mongo:
image: mongo:6.0
container_name: rocketchat-mongo
restart: unless-stopped
command: mongod --replSet rs0 --bind_ip_all
volumes:
- ./mongo-data:/data/db
environment:
TZ: Asia/Shanghai
mongo-init:
image: mongo:6.0
container_name: rocketchat-mongo-init
depends_on:
- mongo
entrypoint: >
bash -c "
until mongosh --host mongo:27017 --eval 'rs.status()'; do sleep 2; done;
mongosh --host mongo:27017 --eval 'rs.initiate({_id: \"rs0\", members: [{_id: 0, host: \"mongo:27017\"}]})'
"
rocketchat:
image: rocketchat/rocket.chat:latest
container_name: rocketchat
restart: unless-stopped
depends_on:
- mongo
environment:
ROOT_URL: https://chat.example.com
MONGO_URL: mongodb://mongo:27017/rocketchat?replicaSet=rs0
MONGO_OPLOG_URL: mongodb://mongo:27017/local?replicaSet=rs0
PORT: 3000
TZ: Asia/Shanghai
ports:
- "127.0.0.1:3000:3000"
volumes:
- ./uploads:/app/uploads

几个关键点:

  • ROOT_URL 必须填最终对外访问的完整地址(含 https://),后面生成的邮件链接、文件链接、客户端校验都依赖它,填错会导致文件打不开、客户端连不上,改起来还要清缓存,能一次填对就别返工。
  • 端口映射绑在 127.0.0.1,不对公网直接暴露,流量统一从反向代理进。
  • uploads 卷存用户上传的文件附件,这是核心数据的一部分,备份时不能漏。

启动:

Terminal window
mkdir -p ~/rocketchat && cd ~/rocketchat
docker compose up -d
docker compose logs -f rocketchat

第一次启动要等 MongoDB 选出主节点、Rocket.Chat 跑完数据库迁移,日志里出现 SERVER RUNNING 才算就绪,一般需要一两分钟。

反向代理与首次设置#

在 Nginx Proxy Manager 里新增一条 Proxy Host(具体操作见 Nginx Proxy Manager:所有自建服务的统一入口):

配置项值
Domain Nameschat.example.com
Forward Hostname127.0.0.1
Forward Port3000
Websockets Support开启
SSL申请证书并开启 Force SSL

WebSocket 必须开,否则消息不能实时推送,会出现「发出去的消息对方半天才收到」。

浏览器打开 https://chat.example.com,首次访问会进入设置向导:创建管理员账号、设置站点名称、组织信息随便填。管理员账号的邮箱和密码务必记牢,这是整套系统的最高权限。

关紧注册入口#

向导走完之后,第一件事不是拉人,而是关门。进入 管理面板 → 设置 → 常规 → 注册:

  • 「手动批准新用户」打开,或者直接把注册方式改成「私密」/关闭公开注册;
  • 开启「注册时需要验证邮箱」;
  • 在 设置 → 账户 里打开两步验证(TOTP)的支持。
WARNING

绝对不要让自建聊天服务器处于开放注册状态。公网可达的聊天服务一旦开放注册,很快会被批量注册机器人盯上,轻则灌垃圾消息,重则被当成违规内容的中转站,VPS 商家收到投诉可能直接停机。邀请制 + 人工批准是唯一推荐的姿势。

之后加人走「管理面板 → 用户 → 邀请」发邀请链接,或者管理员手动建号。频道方面,建议建一个全员默认加入的公告频道,再按话题拆几个小频道,比所有人挤在一个大群里清爽得多。

客户端接入#

Rocket.Chat 有全平台官方客户端:Windows / macOS / Linux 桌面端,iOS / Android 移动端,应用商店搜 Rocket.Chat 即可。第一次打开客户端会让你填服务器地址,填 https://chat.example.com,再用账号密码登录即可,不需要任何额外配置。

注意移动端推送:自建服务器没有官方的推送网关加持时,App 在后台的消息推送依赖系统级通道,国行 Android 手机上可能收不到实时推送,需要把 App 设为允许自启动和后台运行。这是自建 IM 的通病,先有心理预期。

日常维护#

  • 更新:docker compose pull && docker compose up -d。Rocket.Chat 大版本升级偶尔伴随数据库迁移,升级前务必先备份,备份方法见 自建服务备份与迁移实战。
  • 附件存储:默认附件存在本地 uploads 卷,量大之后可以到「管理面板 → 设置 → 文件上传」切换到 S3 兼容存储。
  • 看日志:docker compose logs --tail 200 rocketchat,排障基本靠它。

安全层面再补一刀:管理面板本身就是高价值目标,建议结合 自建服务安全加固:最小暴露与访问控制 里的方法,给 /admin 路径或整个站点再加一层访问控制。

频道、权限与日常运营细节#

服务跑起来只是开始,真正决定使用体验的是频道结构和权限划分。几个实用的经验:

频道规划:频道分三类就够了——全员公告频道(只读,只有管理员能发言,放重要通知)、按主题分的讨论频道(技术、生活、灌水各一)、临时项目频道(用完归档)。频道一多就没人说话,宁可少建、合并,也不要按一时兴起拆一堆空频道。私密频道适合放敏感话题,加入需要管理员邀请,历史消息对新成员默认不可见,这一点在建频道时要想清楚。

角色与权限:Rocket.Chat 的权限体系很细,在「管理面板 → 权限」里按角色(admin、moderator、user)逐项勾选。日常最值得收紧的三项是:普通用户能不能建频道、能不能邀请新人、能不能删除自己发的消息。团队规模小的时候可以放宽,等人多了再收也不迟,但「谁能批准新用户」这一项从第一天起就只给管理员。

机器人与 Webhook:Rocket.Chat 支持传入/传出 Webhook 和官方机器人框架。比如把服务器监控告警发到一个运维频道:在「管理面板 → 集成」里新建 Incoming Webhook,拿到地址后,监控脚本往这个地址 POST 一段 JSON 就能发消息。脚本示例:

Terminal window
curl -X POST https://chat.example.com/hooks/xxxx/yyyy \
-H 'Content-Type: application/json' \
-d '{"text": "⚠️ 服务器 disk 使用率超过 85%"}'

把告警、备份结果、服务上下线通知都汇到一个频道,运维动态一目了然,这也是自建聊天相比公共平台的一大优势——集成不用看任何人脸色。

消息保留策略:在「管理面板 → 设置 → 常规」里可以设置频道消息的保留与清理规则。聊天记录长期攒下去,MongoDB 体积会稳步膨胀,小团队建议每半年看一次数据库大小:docker exec rocketchat-mongo mongosh --eval 'db.runCommand({dbStats: 1, scale: 1073741824})',超过心理预期就考虑给老频道做归档或给文件附件转对象存储。

常见问题与排障#

1. 反向代理后页面 502 先在服务器上直接验证服务本身:curl -I http://127.0.0.1:3000。有响应说明是代理配置问题,检查 NPM 里转发端口和 WebSocket 开关;没响应就去看容器日志,多半是 MongoDB 还没就绪,Rocket.Chat 连不上数据库会反复重启。

2. 日志报 oplog / replica set 相关错误 说明副本集没初始化成功。执行 docker compose logs mongo-init 看初始化容器输出;手动验证:docker exec -it rocketchat-mongo mongosh --eval 'rs.status()',确认有 PRIMARY 节点。常见原因是第一次启动时 mongo 还没完全起来初始化就失败了,重启一次 mongo-init 即可:docker compose up mongo-init。

3. 文件上传成功但下载 404 / 链接是内网地址 ROOT_URL 配错的典型症状。改成正确的对外地址后重启 rocketchat 容器,并清掉浏览器缓存再试。

4. 内存占用越来越高 Node.js 服务的通病。可以在 Compose 里给 rocketchat 加 mem_limit: 1500m 并配合 NODE_OPTIONS: --max-old-space-size=1024,同时确认系统有 Swap 兜底。

5. 客户端提示服务器版本或地址无效 九成是 HTTPS 证书链不完整或客户端填了 http 地址。确认 NPM 里 Force SSL 已开、证书有效,再让客户端删掉旧服务器重新添加。

小结#

这一篇我们把 Rocket.Chat 用 Compose 完整搭了起来:关键点只有三个——MongoDB 必须跑副本集、ROOT_URL 一次填对、注册入口第一时间关紧。剩下的频道、权限、客户端都是水到渠成的配置。自建聊天是所有自建服务里「存在感」最强的一个,搭好之后记得把它纳入例行备份,别让聊天记录只剩一份。

Rocket.Chat:私有聊天服务器部署
https://www.anexns.cloudns.org/posts/selfhost-rocketchat/
作者
Anexns
发布于
2026-11-15
许可协议
CC BY-NC-SA 4.0