Rocket.Chat 从 7.2.0 升级到 7.6.0:完整操作流程与注意事项

近期,很多运维和自建聊天服务的爱好者计划将 Rocket.Chat 从 7.2.0 升级到 7.6.0,以获取最新的功能和安全修复。本次升级涉及到 Compose 文件的调整、容器镜像的更新以及一些安全性细节优化。以下为升级全过程及要点总结。 💡 Compose 文件的文件名标准 Docker Compose 文件不仅支持传统的 docker-compose.yml,还支持以下几种命名方式: 新版 Docker 推荐使用更简洁的 compose.yml 或 compose.yaml,与其他 YAML 配置文件区分更清晰,也符合最新 Compose 规范。无论选择哪种命名,Docker Compose 都能自动识别并加载,无需手动指定。 ⚙️ 升级前的准备 在进行版本升级之前,强烈建议对 MongoDB 数据库进行一次备份。尽管 Rocket.Chat 在启动时会自动处理数据库迁移,但保留快照可以在出现异常时快速恢复。 🔧 Compose 文件修改 升级的核心在于更新 Compose 文件中 Rocket.Chat 镜像的版本号。例如,将以下配置: image: registry.rocket.chat/rocketchat/rocket.chat:7.2.0 修改为: image: registry.rocket.chat/rocketchat/rocket.chat:7.6.0 其余环境变量及数据库配置可保持不变。 🚀 升级步骤 …

Rocket.Chat 域名迁移与 Jitsi 配置调整实战总结

在一次 Rocket.Chat 生产环境的维护中,需要将服务域名从旧地址迁移到新的子域名,同时更新文件上传链接和 Jitsi 视频会议配置。这篇文章总结了整个过程中遇到的问题、解决方案以及关键操作步骤,供有类似需求的用户参考。 💡 背景 🟢 域名迁移 修改 docker-compose.yml 首先需要在 docker-compose.yml 中更新 Rocket.Chat 服务的 ROOT_URL 环境变量,例如: environment: ROOT_URL: https://chat.example.com 修改后执行以下命令重新启动容器,使修改生效: docker-compose downdocker-compose up -d 更新数据库中的 Site URL Rocket.Chat 会在数据库中保存一个 Site_Url 配置,优先级高于自动推断。当域名变更时,需要同步更新此值。 进入 MongoDB 容器: docker exec -it <mongodb-container-name> mongosh 切换数据库: use rocketchat 更新 Site_Url: db.rocketchat_settings.updateOne( { _id: “Site_Url” …

Rocket.Chat🚀更换域名操作全记录(Docker + MongoDB 7)

这篇文章分享如何在 Docker 部署环境下,将 Rocket.Chat 的旧域名彻底替换为新域名,包括数据库更新、服务重启和客户端验证等全流程,适用于自己搭建的私有聊天系统。 🧱 部署架构概览 🛡 本文中所有域名、容器名均为示例,实际请根据你的环境替换。 🔍 步骤一:查找并确认含旧域名的数据 进入 MongoDB 容器: bashCopyEditdocker exec -it your-mongo-container-name mongosh 切换到 Rocket.Chat 数据库: jsCopyEdituse rocketchat 检查上传记录中是否包含旧域名: jsCopyEditdb.rocketchat_uploads.countDocuments({ url: { $regex: “localhost|旧域名1|旧域名2|…” } }) 🔄 步骤二:批量替换上传记录中的域名前缀 使用 MongoDB 7 的 $function 方式进行安全、批量替换: jsCopyEditdb.rocketchat_uploads.updateMany( { url: { $regex: “localhost|旧域名1|旧域名2|…” } }, [ { …

Rocket.Chat 7.x 升级后“Workspace in read-only mode”问题完整解决记录(Docker部署 / GFW环境)

本文记录了在中国网络环境中使用 Docker 自托管 Rocket.Chat 升级至 7.x 后,遇到“只读模式”限制的问题。核心原因并非配置错误,而是由于 中国防火墙(GFW)阻断了关键的 DNS 与 API 请求。最终通过 软路由启用全局代理 成功解决,特此记录分享。 🧩 问题现象 升级 Rocket.Chat 到 7.2.0 后,后台出现以下提示: Workspace in read-only mode. Admins can restore full functionality by connecting it to the internet or upgrading to a premium plan. 📖 背景介绍 Rocket.Chat 从 7.0 起更改许可策略: ⚠️ 核心问题并非配置,而是 …