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

第7章 macOS 系统下安装与配置 MongoDB 指南

macOS 所需软件 首先,安装以下程序:

http://nodejs.org/ http://brew.sh/

安装 NodeBB 使用 MongoDB 以下是官方 MongoDB macOS 安装指南的简写版本。如果遇到问题,请直接参考完整指南。 Homebrew 依赖 Apple Xcode 的命令行工具。 在 macOS 终端中运行以下命令来安装 Xcode 命令行工具: xcode-select --install

使用 Homebrew 安装 MongoDB,在终端中依次执行以下命令: brew tap mongodb/brew

brew update

brew install [email protected]

验证 MongoDB 安装是否成功。你应该看到版本号为 7.0: mongod --version

启动 MongoDB 服务器,在终端中执行: brew services start [email protected]

配置 MongoDB MongoDB 的一般管理操作通过 MongoDB Shell(mongo)完成。默认安装的 MongoDB 监听 27017 端口,并允许本地访问。进入 shell: mongosh

切换到内置的 admin 数据库: use admin

创建一个管理员用户(这与稍后创建的 nodebb 用户不同)。将占位符 替换为你设置的密码。请注意,< 和 > 符号也不要保留。 db.createUser( { user: "admin", pwd: "", roles: [ { role: "root", db: "admin" } ] } )

该用户的作用范围限定在 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()

通过在 /usr/local/etc/mongod.conf 配置文件中追加以下行来启用数据库认证: security: authorization: enabled

(提示:要在 Finder 中找到该文件,请导航至根文件夹并按下 shift + cmd + .. 这会显示隐藏的系统文件夹,此时 /usr 应该会出现在列表中。) 重启 MongoDB 并验证之前创建的管理员用户能否连接: brew services restart mongodb/brew/[email protected] mongosh "mongodb://localhost:27017" --username admin --authenticationDatabase admin

如果配置正确,Mongo Shell 将成功连接。退出 shell。 或者使用 redis 服务器 使用 Homebrew 安装 redis: brew install redis

启动 redis 服务器,在终端中执行: redis-server

安装 NodeBB 安装好 MongoDB 后,我们可以继续安装 NodeBB。将 NodeBB 克隆到合适的位置。 这里使用本地的 nodebb 目录,但你可以使用任何目标位置: git clone -b v3.x https://github.com/NodeBB/NodeBB.git nodebb cd nodebb

这会从 v3.x 分支将 NodeBB 仓库克隆到 nodebb 目录。NodeBB 分支的 GitHub 页面列出了其他可用分支,但只有带版本号的分支是稳定的。 NodeBB 附带了一个命令行工具,支持多种功能。我们先使用它来初始化 NodeBB。 这将从 npm 安装模块,然后进入设置工具。 ./nodebb setup

如果你使用 mongodb 进行设置: 系统会提出一系列问题,括号内为默认值。默认设置适用于本地服务器,监听默认端口 4567,并使用监听 27017 端口的 MongoDB 实例。当提示输入 mongodb 用户名和密码时,输入 nodebb 以及你之前配置的密码。一旦确认数据库连接正常,设置过程将提示正在运行初始用户设置。由于这是全新的 NodeBB 安装,必须配置一名论坛管理员。 输入所需的管理员信息。完成后,将显示 NodeBB 设置已完成的消息。 如果你使用 redis 服务器进行设置: 除了 "Which database to use (mongo)"(使用哪个数据库)这一项应回答 "redis" 外,其余所有选项可保持默认。一旦确认数据库连接正常,设置过程将提示正在运行初始用户设置。由于这是全新的 NodeBB 安装,必须配置一名论坛管理员。 输入所需的管理员信息。完成后,将显示 NodeBB 设置已完成的消息。 最后,你可以使用 cli 工具启动 NodeBB: ./nodebb start

你可以在 http://localhost:4567/ 访问你的论坛

评论 (0)