进阶 docs.nodebb.org 2026-10-13 15:07:09 · 29 阅读

第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 用户不同)。将占位符 替换为你自己选择的密码。确保删除 < 和 >。 > db.createUser( { user: "admin", pwd: "", roles: [ { role: "root", db: "admin" } ] } )

这应输出 { ok: 1 }。此用户被限定在 admin 数据库范围内,以便在启用授权后管理 MongoDB。

要初始创建一个不存在的数据库,只需使用它即可。添加一个名为 nodebb 的新数据库: > use nodebb

数据库将被创建,上下文切换到 nodebb。接下来创建具有适当权限的 nodebb 用户: > db.createUser( { user: "nodebb", pwd: "", roles: [ { role: "readWrite", db: "nodebb" }, { role: "clusterMonitor", db: "admin" } ] } )

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- 目录 选择内部的所有文件和目录 将它们复制到 C:\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 并与你的论坛互动。

评论 (0)