第8章 macOS Big Sur (Intel) 环境下部署 NodeBB 指南
macOS BigSur (Intel) 本指南在基于 Intel 的 Mac 上的 macOS 11.6 BigSur 中测试通过。 虽然未在其他环境测试,但理论上也适用于其他 macOS 版本以及 Apple Silicon Mac。 接下来我们将在 Mac 上安装运行 NodeBB 所需的全部环境。
准备工作 安装 NodeBB 需要 Brew、Xcode Command-Line Tools,以及一个具有管理员权限的用户。 Brew 是 macOS 的包管理器,可以方便地安装各类软件。 安装方法请参考官方页面 brew.sh。 Xcode Command-Line Tools 包含安装 MongoDB 所需的常用工具,可通过以下命令安装: xcode-select --install
安装 Node.js NodeBB 基于 Node.js 运行,因此必须先安装它。 Node.js 迭代很快,建议安装当前的 LTS 版本,这样后续升级会更顺畅。Node.js LTS Plan 中详细列出了 LTS 的发布计划及预计的生命周期结束时间。 撰写本文时,Node.js 16 是 Active LTS 版本,我们就安装它: brew install node@16 brew link node@16 # 由于安装的是非默认版本,需要手动 link
验证 Node.js 和 npm 是否安装成功。Node.js 应为 16 版本,npm 应为 6 版本: node -v # v16.x.x npm -v # 6.x.x
数据库 安装 MongoDB 如果想深入了解以下命令的具体作用,请查阅 MongoDB 官方文档。 brew tap mongodb/brew brew install [email protected] brew link [email protected]
验证 MongoDB 是否安装成功,版本应为 4.0: 示例输出: db version v4.0.27 git version: d47b151b55f286546e7c7c98888ae0577856ca20 allocator: system modules: none build environment: distarch: x86_64 target_arch: x86_64
启动 MongoDB 服务并设置开机自启: brew services start mongodb/brew/[email protected]
配置 MongoDB MongoDB 的常规管理通过 MongoDB Shell(mongo)完成。默认安装的 MongoDB 监听 27017 端口,且仅允许本地访问。进入 shell: mongo
切换到内置的 admin 数据库: use admin
创建管理员用户(与我们稍后创建的 nodebb 用户不同)。将占位符
该用户绑定于 admin 数据库,在启用授权后用于管理 MongoDB。 要创建一个尚不存在的数据库,直接 use 它即可。下面新建一个名为 nodebb 的数据库: use nodebb
数据库会被创建,并且上下文会切换到 nodebb。接着创建具有相应权限的 nodebb 用户:
db.createUser( { user: "nodebb", pwd: "
readWrite 权限允许 NodeBB 在 nodebb 数据库中读写数据。clusterMonitor 权限则让 NodeBB 可以只读查询数据库服务器统计信息,并在 NodeBB 管理后台(ACP)中展示。 退出 Mongo Shell: quit()
在 MongoDB 配置文件 /usr/local/etc/mongod.conf 中追加以下内容,启用数据库授权: security: authorization: enabled
重启 MongoDB,并验证之前创建的管理员用户能否连接: brew services restart mongodb/brew/[email protected] mongo -u admin -p your_password --authenticationDatabase=admin
如果配置正确,Mongo Shell 将成功连接,然后退出 shell 即可。
安装 NodeBB MongoDB 装好后,就可以继续安装 NodeBB 了。将 NodeBB 克隆到一个合适的位置。 这里使用本地 nodebb 目录,你也可以选择任意路径: git clone -b v2.x https://github.com/NodeBB/NodeBB.git nodebb cd nodebb
这条命令会把 NodeBB 仓库的 v2.x 分支克隆到 nodebb 目录。其他可选分支可在 NodeBB Branches GitHub 页面查看,但只有带版本号的分支才是稳定版。 NodeBB 自带一个命令行工具,支持多种功能。我们先用它来完成 NodeBB 的初始化,它会从 npm 安装依赖模块,然后进入安装向导。 ./nodebb setup
接下来会依次出现一系列问题,括号中是默认值。默认配置适用于本地服务器:NodeBB 监听默认端口 4567,MongoDB 实例监听 27017 端口。当提示输入 mongodb 用户名和密码时,填入 nodebb 以及你之前设置的密码。数据库连接确认后,安装程序会提示开始初始化管理员账户。由于这是全新安装,必须配置一个论坛管理员。 输入管理员的相关信息,最后会看到 NodeBB Setup Completed 的提示。
注意 填写站点 URL 时,务必确保与你实际访问站点的方式完全一致。 例如你打算通过 http://example.org 访问论坛,就填写 http://example.org。
配置完成后,nodebb 目录根下会生成一个 config.json 文件。 如果之后需要修改数据库地址或访问凭据等,直接编辑该文件即可。 最后,用命令行工具启动 NodeBB: ./nodebb start
将 NGINX 配置为反向代理 NodeBB 默认运行在 4567 端口,也就是说默认情况下访问时必须在主机名后加端口号(例如 http://example.org:4567)。 若想不带端口访问 NodeBB,可以配置 nginx,将某个主机名(或子域名)的所有请求代理到运行在任意端口的上游 NodeBB 服务。 此外,还可以通过 NGINX 配置 SSL,以及缓存等其他实用功能。 安装 NGINX 非常简单: brew install nginx brew services start nginx # 设置为开机自启
检查版本: nginx -v # ~> nginx version: nginx/1.21.3 (或类似输出)
修改 NGINX 配置 NGINX 默认监听 8080 端口,但我们希望它运行在 80 端口。修改配置: nano /usr/local/etc/nginx/nginx.conf
这会在终端中打开一个文本编辑器,用键盘方向键即可移动光标。一直往下滚动找到这一行: listen 8080;
把 8080 改成 80。然后通过 brew 重启 nginx: brew services restart nginx
打开浏览器访问 http://localhost,你应该能看到 NGINX 的默认欢迎页面。 接下来配置 NGINX 代理 NodeBB。 NGINX 提供服务的站点配置放在 server 块中,通常存放在独立文件里,而不是直接改主配置文件(主配置文件很少需要改动)。 通过 brew 安装的 NGINX,添加新配置的最佳方式是在 /usr/local/etc/nginx/servers 目录下新建文件(例如 /usr/local/etc/nginx/servers/forum.example.org.conf)。 创建一个新配置文件并用 nano 编辑: nano /usr/local/etc/nginx/servers/forum.example.com.conf # 把 forum.example.com 改成你的域名或其他名称
直接复制以下配置即可,它提供了基础的代理设置。 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; # 如果 NodeBB 监听其他端口,请修改这里 proxy_redirect off;
# Socket.IO Support proxy_http_version 1.1; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection "upgrade"; } }
如果想从 www.forum.example.com 重定向到 forum.example.com,请添加以下内容
server { server_name www.forum.example.com; listen 80; return 301 https://forum.example.com$request_uri; }
再次重启 NGINX... brew services restart nginx
...然后刷新浏览器窗口,你应该就能看到自己的 NodeBB 实例了。如果想深入了解 NGINX,请参考 configuring NGINX 页面。 大功告成! 恭喜,NodeBB 已经安装并运行起来了。现在你应该可以访问 http://forum.example.com 并使用你的论坛了。 如果配置了重定向,也可以测试一下从 http://www.forum.example.com 的跳转是否正常。 建议再做一个额外验证:重启机器(或注销后重新登录),检查各项服务是否能正常启动。