第10章 Windows 10 环境下 NodeBB 安装指南:Node.js 与 MongoDB 配置详解
在 Windows 上安装
本安装指南针对 Windows 10 优化,将使用 MongoDB 作为数据库安装 NodeBB。指南假设并全程使用完全补丁的最新长期支持(LTS)版本及同等生产环境软件。
感到困惑?——NodeBB 博客提供了一份更简洁的 Ubuntu 20.04 指南,包含大量截图。
系统要求
内存:安装 NodeBB 依赖项可能需要超过 512 MB 的系统内存。如果 Linux 系统内存不足,建议启用交换分区(swap)作为补偿。
安装 Node.js
NodeBB 由 Node.js 驱动,因此必须安装它。Node.js 是一个快速演进的 平台,建议安装当前的 LTS 版本,以便未来更新顺畅进行。Node.js LTS 计划 详细说明了 LTS 发布时间表,包括预计的生命终结日期。
下载 Node.js 22.x 执行安装程序
验证 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 月正式结束生命周期。
本指南假设安装 8.0 版本。如果你希望使用除 MongoDB 以外的数据库,请参阅 配置数据库 部分获取更多信息。
官方的详细安装说明可在 MongoDB 手册中找到。虽然本指南不涉及这些内容,但一些 MongoDB 生产环境部署利用集群、分片和复制技术以实现高可用性和高性能。请参阅 MongoDB 复制和分片 主题以了解更多。请注意,NodeBB 不需要这些高级配置,这样做可能会使安装过程复杂化。简单通常最好。
以下是 Windows 官方 MongoDB 安装指南的简要版。
前往 MongoDB 下载中心 并下载适合你的安装文件 找到下载的 .msi 文件并执行以启动安装程序 默认安装位置为 C:\Program Files\MongoDB\Server\8.0 将 MongoDB 二进制文件添加到你的 PATH
找到 MongoDB 安装目录下的 bin 目录 默认路径为 C:\Program Files\MongoDB\Server\8.0\bin 在开始菜单搜索栏中输入 PATH 打开 编辑你账户的环境变量 在 用户变量 下点击 Path 点击 编辑... 按钮 在右侧点击 新建 按钮 输入或粘贴到 bin 目录的完整路径
为 mongod 服务器配置服务
打开管理员命令提示符
为数据库和日志文件创建两个目录。我们将使用 C:\MongoDB\data\db 和 C:\MongoDB\logs
创建一个配置文件(C:\MongoDB\mongod.cfg)以定义这些路径 systemLog: destination: file path: C:\MongoDB\logs\mongod.log storage: dbPath: C:\MongoDB\data\db
安装 MongoDB 服务 mongod.exe --config "C:\MongoDB\mongod.cfg" --install
验证 MongoDB 安装。你应拥有 8.0 版本: mongod --version db version v8.0
启动 mongod 服务并验证服务状态。MongoDB 应处于活动(运行)状态: net start MongoDB sc query "MongoDB" | findstr STATE
配置 MongoDB
MongoDB 的一般管理通过 MongoDB Shell mongosh 完成。默认安装的 MongoDB 监听端口 27017 并可在本地访问。访问 shell: mongosh
切换到内置的 admin 数据库: > 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 配置文件 C:\MongoDB\mongod.cfg 中附加以下行来启用数据库授权: security: authorization: enabled
重启 MongoDB 并验证之前创建的管理用户能够连接: net stop MongoDB net start MongoDB
要连接需要身份验证的 MongoDB 部署,使用 --username 和 --authenticationDatabase 选项。mongosh 会提示输入密码,输入时会隐藏。 mongosh "mongodb://localhost:27017" --username admin --authenticationDatabase admin
如果一切配置正确,Mongo Shell 将建立连接。使用 quit() 退出 shell。 安装 NodeBB
首先,我们必须安装 git,因为它用于分发 NodeBB:
在此 下载适用于 Windows 的 Git 执行该安装文件以安装 Git 在设置过程中,选择 Use Git from the Windows Command Prompt 选项,这将正确配置你的 PATH 环境以使用 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 的本地服务器,以及监听端口 27017 的 MongoDB 实例。当被提示输入 mongodb 用户名和密码时,输入 nodebb 和你之前配置的密码。一旦确认与数据库的连接,设置将提示初始用户设置正在运行。由于这是新的 NodeBB 安装,必须配置一个论坛管理员。输入所需的管理员信息(这将是你登录论坛的凭据)。最终将显示 NodeBB 设置完成 消息。 注意:输入站点 URL 时,确保它恰好是你计划访问站点的 URL。如果你计划访问 http://example.org 来打开你的论坛,那么确切地输入 http://example.org。
配置文件 config.json 将在 nodebb 目录的根目录下创建。如果需要更改数据库位置或用于访问数据库的凭据等设置,可以修改此文件。
最后,你可以使用 cli 实用工具启动 NodeBB: nodebb start
安装 nginx
NodeBB 默认在端口 4567 上运行,这意味着默认情况下你必须在主机名之外使用端口号来访问它(例如 http://example.org:4567)。
为了让 NodeBB 能够不带端口号提供,可以配置 nginx 将特定主机名(或子域名)的所有请求代理到运行在任何端口的上游 NodeBB 服务器。
以下是 Windows nginx 安装说明的简要版。
创建新目录 C:\nginx
下载稳定的 nginx win32 二进制文件
双击打开 .zip 文件
双击打开内部的 nginx-
验证 nginx 安装 nginx -v
并确保服务可以运行 cd C:\nginx start nginx tasklist | findstr nginx.exe
配置 nginx
nginx 提供的站点包含在 server 块中,这些通常与主 nginx 配置(很少编辑)存储在单独的文件中。 然而,使用上述方法安装时,server 块配置嵌入在 C:\nginx\conf\nginx.conf 中。 以下是 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 配置后,必须重新加载服务才能使更改生效: cd C:\nginx nginx -s reload
更多信息请参阅 配置 nginx 页面。 安装完成后
很好,你已成功安装并运行了 NodeBB。你应该能够访问 http://forum.example.com 并与你的论坛互动。