第4章 在 Debian 上安装 NodeBB
安装到 Debian 本安装指南针对 Debian 10 进行了优化,将安装 NodeBB 并使用 MongoDB 作为数据库。全程假定并使用了软件经过完全修补的 LTS 版本及等效的生产版本。
困惑中?– 可以在 NodeBB 博客找到一份针对 Ubuntu 20.04 的更简单指南,其中包含大量截图。
系统需求
内存:安装 NodeBB 的依赖项可能需要超过 512 MB 的系统内存。如果您的 Linux 系统内存不足,建议启用交换分区来补偿。
安装 Node.js 理所当然,NodeBB 由 Node.js 驱动,因此需要安装它。由于 Node.js 是一个快速演变的平台,建议安装当前 LTS 版本的 Node.js,以便未来更新更加顺畅。Node.js LTS 计划详细列出了 LTS 发布时间表,包括预计的生命周期结束时间。 可以在 NodeSource 的 Debian 二进制软件包存储库中获取 Node.js。
下载并导入 Nodesource GPG 密钥
sudo apt-get update sudo apt-get install -y ca-certificates curl gnupg sudo mkdir -p /etc/apt/keyrings curl -fsSL https://deb.nodesource.com/gpgkey/nodesource-repo.gpg.key | sudo gpg --dearmor -o /etc/apt/keyrings/nodesource.gpg
创建 deb 仓库
echo "deb [signed-by=/etc/apt/keyrings/nodesource.gpg] https://deb.nodesource.com/node_22.x nodistro main" | sudo tee /etc/apt/sources.list.d/nodesource.list
运行更新并安装
sudo apt-get update sudo apt-get install nodejs -y
验证 Node.js 和 npm 的安装。截至 2024 年 10 月 29 日,应已安装 Node.js 版本 22,以及 npm 版本 10:
```bash node -v npm -v (应输出 "10.8.2" 或类似结果)
数据库 安装 MongoDB MongoDB 是 NodeBB 的默认数据库。根据 MongoDB 支持政策,4.4 之前的版本已于 2024 年 2 月正式结束生命周期。 本指南假定安装版本 8.0。如果希望使用除 MongoDB 以外的其他数据库,请参考“配置数据库”部分获取更多信息。 官方的详细安装说明可在 MongoDB 手册中找到。虽然超出本指南的范围,但出于高可用性和性能原因,某些 MongoDB 生产部署会利用集群、分片和复制。请参阅 MongoDB 复制与分片相关主题以获取更多阅读材料。请记住,NodeBB 不需要这些高级配置,使用它们反而可能使安装变得复杂。保持简单通常是最好的选择。 以下是 Debian 官方 MongoDB 安装指南的简化版。如果遇到问题,请回退到使用那份完整指南。 sudo apt-get install gnupg curl curl -fsSL https://pgp.mongodb.com/server-8.0.asc | \ sudo gpg -o /usr/share/keyrings/mongodb-server-8.0.gpg \ --dearmor echo "deb [ signed-by=/usr/share/keyrings/mongodb-server-8.0.gpg ] http://repo.mongodb.org/apt/debian bullseye/mongodb-org/8.0 main" | 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 应该处于活动(运行)状态: sudo systemctl start mongod sudo systemctl status mongod
配置 MongoDB MongoDB 的一般管理是通过 MongoDB Shell mongosh 完成的。默认安装的 MongoDB 监听 27017 端口,并可在本地访问。访问 Shell: mongosh
切换到内置的管理员数据库: > use admin
创建一个管理员用户(这与我们将要创建的 nodebb 用户不同)。将占位符
这应该输出 { 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 服务器上。 sudo apt-get install -y nginx
验证 nginx 的安装 nginx -v
并确保服务能够运行 sudo systemctl start nginx sudo systemctl status nginx
配置 nginx 由 nginx 提供服务的站点包含在一个 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
以下是 NodeBB 运行在 4567 端口上的配置示例。请记得将 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 并与您的论坛进行交互。