NodeBB：Node.js 现代实时论坛搭建与使用指南
一、项目官方信息
| 项目 | 信息 |
|---|---|
| GitHub 仓库 | https://github.com/NodeBB/NodeBB |
| 官方网站 | https://nodebb.org |
| 开源协议 | GPL-3.0 |
| 主要语言 | JavaScript（约 87.6%） |
| Star 数 | 约 15k |
| 默认端口 | 4567 |
NodeBB Forum Software 是一个由 Node.js 驱动的现代论坛，支持 Redis、MongoDB 或 PostgreSQL 作为数据库。它使用 WebSocket 实现即时交互与实时通知，吸收了现代 Web 的优点：实时流式讨论、移动端响应式、丰富的 RESTful 读写 API，同时保持经典论坛的形态——分类层级、本地账号、异步消息。
NodeBB 自身只包含一个“通用核心”，额外功能与集成都通过第三方插件开启。它自带极简的 “Harmony” 主题，开箱即用，无需写代码；主题系统基于 Bootstrap 5，可用 SCSS/CSS 深度定制。
二、官方图片
上图为 NodeBB 官方 Logo。它的主题引擎非常灵活，不限制设计选择；安装完成后可在浏览器中访问 http://服务器IP:4567 看到默认 Harmony 主题。
三、环境要求
按 README 的 Requirements：
- Node.js 22 或更高版本（必须，NodeBB 不支持更老的大版本）。
- 数据库三选一：MongoDB 5+，或 Redis 7.2+；若用集群（clustering）则需要 Redis。
- 可选：nginx 1.3.13+（用于反向代理到 NodeBB）。
- 可选：Docker（容器化部署）。
- 内存建议 1GB 以上。
四、完整部署步骤
1. 准备数据库
以 Redis 为例（需先安装并运行 Redis）：
# Ubuntu 安装 Redis
sudo apt update && sudo apt install -y redis-server
sudo systemctl enable --now redis-server
2. 克隆源码
git clone https://github.com/NodeBB/NodeBB.git
cd NodeBB
3. 运行初始化向导
NodeBB 使用基于 CLI 的安装方式，不通过 npm start 运行：
./nodebb setup
向导会交互式询问并配置：
- 数据库类型（MongoDB / Redis / PostgreSQL）与连接信息；
- 服务器 URL 与端口（默认 4567）；
- 管理员账号（邮箱、用户名、密码）。
期间会自动 npm install 安装依赖。
4. 启动
./nodebb start
其他常用命令：
./nodebb stop # 停止
./nodebb restart # 重启
./nodebb log # 查看日志
./nodebb status # 查看运行状态
5. 配置反向代理（可选但推荐）
生产建议在前面套 nginx，把 80/443 转发到 127.0.0.1:4567：
server {
listen 80;
server_name bbs.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 $host;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_pass http://127.0.0.1:4567;
}
}
6. 验证
浏览器打开 http://服务器IP:4567（或绑定的域名），看到 NodeBB 首页，用 setup 时创建的管理员账号登录，进入管理后台 /admin 即部署成功。
五、使用方法
- 分类管理：在
/admin→ 分类（Categories）中新建分类，用户在分类下发帖。 - 用户与权限：后台管理用户、用户组（Groups）与各分类的访问/发帖权限。
- 插件体系：NodeBB 核心只做基础，功能全靠插件。在
/admin/extend/plugins里搜索并安装插件（如表情、社交登录、SEO、积分等），安装后重启生效。 - 主题定制：
/admin/appearance切换主题、定制颜色与布局；开发者可基于 Bootstrap 5 用 SCSS 做子主题。 - 实时能力：借助 WebSocket，新帖、新回复、通知可实时推送到在线用户。
- API 与集成：提供 RESTful 读写 API，可与外部系统打通。
- 多语言：通过 Transifex 提供国际化，后台可切换语言。
六、常见问题 FAQ
-
为什么我用
npm start起不来？ README 明确 NodeBB 用 CLI 管理，不通过npm start。请用./nodebb setup初始化、./nodebb start启动。 -
Node.js 版本要求？ 必须 Node.js 22 或更高。版本过低会在依赖安装或启动时报错，请先升级 Node 再 setup。
-
数据库选 Redis 还是 MongoDB？ 两者都支持。Redis 还能在你用 clustering 集群时充当必要组件；按熟悉度选择即可。PostgreSQL 也是官方支持选项。
-
4567 端口怎么改？ 重新运行
./nodebb setup或在配置里修改端口；改完./nodebb restart。生产建议保持本机 4567，前面用 nginx 反代 80/443。 -
插件装在哪里、怎么生效？ 在
/admin/extend/plugins在线安装，或把插件放到 node_modules 后在后台激活。装完通常需要./nodebb restart才生效。 -
想后台常驻运行怎么办？
./nodebb start会以守护方式运行；也可以用 systemd 或 Docker 方式托管，具体见官方文档的 cloud/Docker 安装章节。