第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 用户不同)。将占位符
该用户的作用范围限定在 admin 数据库,以便在启用认证后管理 MongoDB。 若要创建一个尚不存在的数据库,直接使用该数据库即可。添加一个名为 nodebb 的新数据库: use nodebb
此时数据库会被创建,且上下文切换至 nodebb。接下来创建具有相应权限的 nodebb 用户:
db.createUser( { user: "nodebb", pwd: "
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/ 访问你的论坛