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

第17章 NodeBB 部署指南:systemd 与 Upstart 服务管理

运行 NodeBB

启动和停止 NodeBB 的推荐方式是调用它的可执行文件:

./nodebb start 启动 NodeBB 服务器 ./nodebb stop 停止 NodeBB 服务器 你也可以用 npm start 和 npm stop 达到同样效果。

不过,通过 ./nodebb start 启动的 NodeBB 在系统重启后不会自动恢复运行。下面列出的方法可以作为通过可执行文件启动的替代方案。

systemd

Ubuntu/CentOS/Debian/OpenSuse 的新标准是用 systemd 管理系统服务。下面是一个可用的 systemd 服务示例,但前提是:

MongoDB 通过包管理器安装,并由 systemd 管理 Node.js 通过包管理器安装,可通过 env 可执行文件调用 NodeBB 以非特权用户 nodebb 运行 你将使用 systemd journal 管理 NodeBB 的日志

[Unit] Description=NodeBB Documentation=https://docs.nodebb.org After=system.slice multi-user.target mongod.service

[Service] Type=forking User=nodebb

WorkingDirectory=/path/to/nodebb PIDFile=/path/to/nodebb/pidfile ExecStart=/usr/bin/env node loader.js --no-silent Restart=always

[Install] WantedBy=multi-user.target

把 User 的值(上面设为 nodebb)改成你希望运行 NodeBB 的系统用户,并把 NodeBB 的路径(/path/to/nodebb)改成实际路径。

建议把 User 设置为权限尽可能低的系统用户。

把文件保存到 /etc/systemd/system/nodebb.service。

之后就可以这样启动和停止 NodeBB: $ systemctl start nodebb $ systemctl stop nodebb

如果希望 NodeBB 在系统启动时自动运行: $ systemctl enable mongod $ systemctl enable nodebb

如果不想用 journalctl 查看 NodeBB 日志,可以从 ExecStart 指令中删掉 --no-silent,让日志重新追加到 logs/output.log。

更多 systemd 配置细节,请参考 systemd service 的 manpage。

Upstart

较旧版本的 Ubuntu 可能使用 Upstart 在开机时管理进程,并在脚本崩溃时自动重启。你可以用 Upstart 来启动、停止、重启 NodeBB。

注意:NodeBB v0.7.0 之前,Upstart 无法正确跟踪 pid,导致无法停止 NodeBB 进程。v0.7.0 做了一些改动,使 Upstart 能更有效地控制 NodeBB。

以下 Upstart 配置可作为管理 NodeBB 的模板: start on startup stop on runlevel [016] respawn setuid someuser setgid someuser script cd /path/to/nodebb node loader.js --no-silent --no-daemon end script

之后就能以 root 用户启动、停止、重启 NodeBB:start nodebb、stop nodebb、restart nodebb(假设 Upstart 配置文件名为 nodebb.conf)。

注意事项

- 服务报告为已启动(如 mongod.service)并不意味着启动流程已完成。需要通过 journalctl 监控才能确认。启动服务后,请等待一两分钟(取决于服务器配置)。 - 在 After= 字段中加入 mongod.service 或其他 AnyOther.service,表示会在该服务报告为已启动时尝试启动,但不会检查该服务是否真正可用(例如 network.service 可以是已启动状态,但不会检查你是否已连上网络)。如果该服务已通过 systemctl enable SERVICENAME 启用,则会不断重试,直到自身启动成功或依赖的服务启动成功,或按服务文件中的其他说明执行。

Supervisor Process

使用 supervisor 包,可以让 NodeBB 在崩溃后自动重启: $ npm install -g supervisor $ supervisor app

由于 supervisor 默认会把输出持续写到 stdout,所以更适合开发环境。

Forever Daemon

另一种保持 NodeBB 运行的方式是通过命令行使用 forever 包,它可以监控 NodeBB 并在必要时重新启动: $ npm install -g forever $ forever start app.js

你可以使用 forever start 和 forever stop app.js,但 ACP 中内置的 Reload/Restart 工具将无法使用。

Grunt Development

我们可以用 grunt 启动 NodeBB,并在文件变更时重新编译资源。由于只编译有改动的资源,启动速度会更快。

安装 Grunt: $ npm install -g grunt-cli

运行 grunt 即可启动 NodeBB 并监听代码变更。 $ grunt

评论 (0)