第29章 升级 NodeBB
升级 NodeBB
NodeBB 的定期发布版本位于 Releases 页面。这些版本通常包含最无 Bug 的代码,专为生产级 NodeBB 实例设计。
你可以利用 `git` 安装特定版本的 NodeBB,并在新版本发布时定期升级。
若要获取最新的修复和新特性,也可以直接从仓库的 `master` 分支(`git clone` 最新代码)进行安装,但请注意其稳定性无法保证。核心开发者会尽量确保每次提交都能生成可运行的客户端,尽管个别功能可能尚未 100% 完善。
一如既往,NodeBB 团队不对因升级失败导致的任何意外、数据丢失、数据损坏或其他问题负责——因此,请务必在开始操作前进行备份!
升级路径
NodeBB 的升级路径旨在让版本间的升级变得简单直接。
升级步骤
1. 停止论坛 虽然理论上可以在 NodeBB 运行时进行升级,但这强烈不推荐,尤其是对于活跃的论坛: ``` cd /path/to/nodebb ./nodebb stop ```
2. 备份数据
备份 Redis
与所有升级操作一样,第一步都是备份数据!没人喜欢数据库损坏或数据丢失。
NodeBB 存储的所有文本数据都位于 `.rdb` 文件中。在典型的 Redis 安装中,主数据库通常位于 `/var/lib/redis/dump.rdb`。 请将此文件存放在安全的地方。
备份 MongoDB
要备份完整的 MongoDB,可以简单地运行: ``` mongodump ``` 这将创建一个目录结构,可通过 `mongorestore` 命令进行恢复。
建议先停止数据库服务。在 Debian / Ubuntu 系统中,命令可能是: ``` sudo service mongodb stop ``` 请将此文件存放在安全的地方。
上传文件
上传的图片和文件存储在 `/public/uploads` 目录中。建议也备份此文件夹: ``` cd /path/to/nodebb/public tar -czf ~/nodebb_assets.tar.gz ./uploads ```
3. 获取最新代码
在升级 NodeBB 之前,请确保已安装所需的 `nodejs` 版本。NodeBB 支持最新的稳定版 `nodejs`(如 v18 等)。要升级 `nodejs`,请运行: ``` curl -sL https://deb.nodesource.com/setup_lts.x | sudo -E bash - sudo apt-get install -y nodejs ```
进入你的 NodeBB 目录:`cd /path/to/nodebb`。
NodeBB 有多种安装方式。你当前可能处于主分支(`master`)、发布分支(例如 `v2.x`),或者使用来自 NodeBB 仓库的归档下载版本。
不知道当前处于哪个分支?请执行 `git rev-parse --abbrev-ref HEAD` 查看。
通过主分支升级 ``` git fetch # 从 NodeBB 仓库获取最新代码 git reset --hard v2.2.5 # 将此替换为你要升级到的版本 ``` 这将获取仓库中最新(且最佳)版本的 NodeBB。
通过发布分支升级 如果你是从较低版本分支升级到较高版本分支,请按需切换分支。确保你当前分支的代码已是最新!
例如,从 `v1.19.8` 升级到 `v2.2.5` 时: ``` git fetch # 从 NodeBB 仓库获取最新代码 git checkout v2.x # 切换到 v2.x 分支,因为我们要升级到 NodeBB 2 版本 git reset --hard origin/v2.x ```
如果是在同一分支内升级(例如从 `v2.2.4` 升级到 `v2.2.5`),只需运行以下命令: ``` git fetch git reset --hard origin/v2.x ``` 这将获取仓库中最新(且最佳)版本的 NodeBB。
通过归档发布版本升级 或者,你可以从 Releases Page 下载并解压最新带版本号的代码包。 按需覆盖文件。此方法不受官方支持。
4. 运行 NodeBB 升级脚本
该脚本将安装缺失的依赖项,升级任何可用的插件或主题,并在必要时迁移数据库。 ``` ./nodebb upgrade ```
5. 启动 NodeBB 并测试! ``` ./nodebb start -l ``` 现在你应该正在运行最新版本的 NodeBB。