第1章 在 Ubuntu 上安装 NodeBB
在 Ubuntu 上安装
本安装指南针对 Ubuntu 24.04 进行了优化,将安装使用 MongoDB 作为数据库的 NodeBB。全程假设并使用了软件已完全打补丁的 LTS 版本及等效的生产版本。
感到困惑?——你可以在 NodeBB 博客上找到一份针对 Ubuntu 20.04 的更简单指南,其中包含大量截图。
系统要求
内存:安装 NodeBB 的依赖项可能需要超过 512 MB 的系统内存。如果你的 Linux 系统内存不足,建议启用交换分区以作补充。
安装 Node.js
NodeBB 由 Node.js 驱动,因此必须安装它。Node.js 是一个快速演变的平台,建议安装当前 LTS 版本的 Node.js,以便未来无缝更新。Node.js LTS 计划 详细列出了 LTS 版本的发布时间表,包括预计的生命周期结束时间。
Node.js 可以从 NodeSource Ubuntu 二进制发行版仓库获取。下载安装脚本:
sudo apt-get update sudo apt-get install -y ca-certificates curl gnupg curl -fsSL https://deb.nodesource.com/setup_lts.x -o nodesource_setup.sh
运行该脚本并安装 Node.js:
sudo -E bash nodesource_setup.sh sudo apt-get install -y nodejs
验证 Node.js 和 npm 的安装。截至 2024 年 10 月 29 日,你应该已安装 Node.js 22 版本和 npm 10 版本:
node -v npm -v (应输出 "10.8.2" 或类似版本)
数据库
安装 MongoDB
MongoDB 是 NodeBB 的默认数据库。正如 MongoDB 支持策略 中所述,4.4 以下版本已于 2024 年 2 月正式停止支持(End of Life)。
本指南假设安装 8.0 版本。如果你希望使用其他数据库代替 MongoDB,请参阅 配置数据库 部分获取更多信息。
MongoDB 手册 中提供了详细的官方安装说明。虽然本指南不涵盖这些内容,但某些 MongoDB 生产环境部署会利用集群、分片和复制机制来保证高可用性和性能。请查阅 MongoDB 复制与分片 主题以获取更多阅读材料。请记住,NodeBB 不需要这些高级配置,实施它们可能会使安装过程复杂化。保持简单通常是最好的选择。
以下是 Ubuntu 官方 MongoDB 安装指南的简化版。如果遇到任何问题,请回退使用官方指南。
sudo apt-get install gnupg curl curl -fsSL https://www.mongodb.org/static/pgp/server-8.0.asc | \ sudo gpg -o /usr/share/keyrings/mongodb-server-8.0.gpg \ --dearmor echo "deb [ arch=amd64,arm64 signed-by=/usr/share/keyrings/mongodb-server-8.0.gpg ] https://repo.mongodb.org/apt/ubuntu noble/mongodb-org/8.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-8.0.list sudo apt-get update sudo apt-get install -y mongodb-org
验证 MongoDB 的安装。你应该拥有 8.0 版本:
mongod --version db version v8.0
启动 mongod 服务并检查服务状态。MongoDB 应为活动状态(running):
sudo systemctl start mongod sudo systemctl status mongod
配置 MongoDB
MongoDB 的日常管理通过 MongoDB Shell (mongosh) 进行。默认的 MongoDB 安装监听 27017 端口,并允许本地访问。进入 shell:
mongosh
切换到内置的 admin 数据库:
> use admin
创建一个管理员用户(注意:这与稍后创建的 nodebb 用户不同)。将占位符 `
> db.createUser( { user: "admin", pwd: "
这应输出 `{ ok: 1 }`。该用户的作用域限定在 admin 数据库中,用于在启用授权后管理 MongoDB。
若要创建一个原本不存在的数据库,只需使用它即可。添加一个名为 nodebb 的新数据库:
> use nodebb
数据库将被创建,上下文切换到 nodebb。接下来,创建具有适当权限的 nodebb 用户:
> db.createUser( { user: "nodebb", pwd: "
readWrite 权限允许 NodeBB 从 nodebb 数据库存储和检索数据。clusterMonitor 权限为 NodeBB 提供对数据库服务器统计信息的只读访问权限,这些统计信息随后会在 NodeBB 管理控制面板 (ACP) 中显示。
退出 Mongo Shell:
> quit()
通过在 MongoDB 配置文件 /etc/mongod.conf 中追加以下内容来启用数据库授权:
security: authorization: enabled
重启 MongoDB 并验证之前创建的管理员用户能够连接:
sudo systemctl restart mongod
要连接到需要身份验证的 MongoDB 部署,请使用 `--username` 和 `--authenticationDatabase` 选项。mongosh 会提示输入密码,输入时密码将被隐藏。
mongosh "mongodb://localhost:27017" --username admin --authenticationDatabase admin
如果配置正确,Mongo Shell 将成功连接。使用 quit() 退出 shell。
安装 NodeBB
首先,必须安装 git,因为它是用于分发 NodeBB 的工具:
sudo apt-get install -y git
注意:诸如 `git` 和 `./nodebb` 等命令不应使用 root 权限(sudo 或提升权限)运行。这会导致 NodeBB 需要访问的文件所有权出现问题。在运行这些命令之前,请切换到非特权用户。
接下来,将 NodeBB 克隆到合适的位置。这里使用了本地的 nodebb 目录,但任何目标位置都可以:
git clone -b v4.x https://github.com/NodeBB/NodeBB.git nodebb cd nodebb
这会将 NodeBB 仓库从 v4.x 分支克隆到 nodebb 目录。NodeBB 分支 GitHub 页面 列出了其他可用分支,但只有带版本号的分支是稳定的。
NodeBB 附带一个命令行实用程序,可实现多种功能。我们首先使用它来设置 NodeBB。这将安装来自 npm 的模块,然后进入设置实用程序。
./nodebb setup
系统会提示一系列问题,默认值用括号标出。默认设置为本地服务器监听默认端口 4567,MongoDB 实例监听端口 27017。当提示输入 mongodb 用户名和密码时,请输入 nodebb 以及你之前配置的密码。一旦确认与数据库的连接,设置过程将提示正在运行初始用户设置。由于这是全新的 NodeBB 安装,必须配置论坛管理员。输入所需的管理员信息(这将是你登录论坛的凭证)。最终会出现 NodeBB 设置完成 的消息。
注意:输入网站 URL 时,请确保它与你计划访问网站的方式完全一致。如果你计划访问 http://example.org 打开论坛,那么请确切输入 http://example.org。
在 nodebb 目录的根目录下将创建配置文件 config.json。如果需要更改数据库位置或访问数据库的凭证等设置,可以修改此文件。
最后,你可以使用 cli 实用程序启动 NodeBB:
./nodebb start
安装 nginx
NodeBB 默认运行在 4567 端口,这意味着默认情况下你必须使用端口号连同主机名来访问它(例如 http://example.org:4567)。
为了让 NodeBB 无需端口即可提供服务,可以配置 nginx 将特定主机名(或子域名)的所有请求代理到运行在任意端口的上游 NodeBB 服务器。
在继续之前,运行 exit 切回 root 用户。
sudo apt-get install -y nginx
验证 nginx 的安装:
nginx -v
并验证服务能够运行:
sudo systemctl start nginx sudo systemctl status nginx
配置 nginx
由 nginx 提供的站点包含在 server 块中,这些 server 块通常存储在与主 nginx 配置(很少编辑)分开的文件中。
在使用上述 ppa 安装时,安装新 nginx 配置的最佳方法是在 /etc/nginx/sites-available 中添加新文件(例如 /etc/nginx/sites-available/forum.example.org)。然后必须将这些文件从 sites-available 链接到 sites-enabled。
以下演示了创建新 nginx 配置时通常使用的一系列命令:
cd /etc/nginx/sites-available sudo nano forum.example.com # 将配置输入文件并保存 cd ../sites-enabled sudo ln -s ../sites-available/forum.example.com
以下是一个针对运行在 4567 端口的 NodeBB 的配置示例。请务必将 forum.example.com 替换为你自己的站点 URL(不带 https://)。
server { listen 80;
server_name forum.example.com;
location / { proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; proxy_set_header Host $http_host; proxy_set_header X-NginX-Proxy true;
proxy_pass http://127.0.0.1:4567; proxy_redirect off;
# Socket.IO Support proxy_http_version 1.1; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection "upgrade"; } }
修改 nginx 配置后,必须重新加载服务以使更改生效:
sudo systemctl reload nginx
更多信息,请访问 配置 nginx 页面。
安装后
很好,你的 NodeBB 已安装并正在运行。你应该能够访问 http://forum.example.com 并与论坛进行交互。