先说清楚:为什么要自建聊天服务器
团队群聊、家庭沟通、朋友之间传文件,日常用的都是别人的平台:聊天记录存在对方服务器上,账号说封就封,文件链接过段时间就失效。自建聊天服务器解决的就是这件事——数据在自己的 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卷存用户上传的文件附件,这是核心数据的一部分,备份时不能漏。
启动:
mkdir -p ~/rocketchat && cd ~/rocketchatdocker compose up -ddocker compose logs -f rocketchat第一次启动要等 MongoDB 选出主节点、Rocket.Chat 跑完数据库迁移,日志里出现 SERVER RUNNING 才算就绪,一般需要一两分钟。
反向代理与首次设置
在 Nginx Proxy Manager 里新增一条 Proxy Host(具体操作见 Nginx Proxy Manager:所有自建服务的统一入口):
| 配置项 | 值 |
|---|---|
| Domain Names | chat.example.com |
| Forward Hostname | 127.0.0.1 |
| Forward Port | 3000 |
| 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 就能发消息。脚本示例:
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 一次填对、注册入口第一时间关紧。剩下的频道、权限、客户端都是水到渠成的配置。自建聊天是所有自建服务里「存在感」最强的一个,搭好之后记得把它纳入例行备份,别让聊天记录只剩一份。