第30章 NodeBB 性能扩展:使用 Nginx 与集群
第30章:扩展 NodeBB 的性能
当面临大量并发连接或高浏览量时,可以采取特定措施来优化 NodeBB 的性能。
本文旨在梳理相关策略,帮助那些发现 NodeBB 在满载状态下运行未达预期速度的用户。
使用代理服务器分发静态资源
Nginx 非常擅长处理静态资源(如 JavaScript、CSS、图片等)。将这部分任务交给 Nginx 直接服务给最终用户,NodeBB 进程就可以专注于处理 API 请求,从而大幅降低 NodeBB 的负载并提升吞吐量。
你需要修改 Nginx 配置,添加以下 location 块:
```nginx location @nodebb { proxy_pass http://127.0.0.1:4567; }
location ~ ^/assets/(.*) { root /path/to/nodebb/; try_files /build/public/$1 /public/$1 @nodebb; }
location / { proxy_pass http://127.0.0.1:4567; } ```
此外,你还可以指示 Nginx 对这些资源进行压缩传输:
```nginx gzip on; gzip_min_length 1000; gzip_proxied off; gzip_types text/plain application/xml text/javascript application/javascript application/x-javascript text/css application/json; ```
利用集群(Clustering)
默认情况下,NodeBB 只运行在单个进程中。由于某些请求耗时较长,可能导致同一类资源出现延迟或排队现象。
为了解决这个问题,你可以在 `config.json` 中添加 `port` 属性,让 NodeBB 运行在多个进程中:
```json { "port": ["4567", "4568", "4569"] // 这将启动三个进程 } ```
请注意,你需要通过 `node loader.js` 或 `./nodebb start` 来启动 NodeBB,以便生成 3 个 worker。如果使用 `node app.js`,则只会使用数组中的第一个端口。
必须使用如 Nginx 这样的代理服务器,在所有服务器之间进行负载均衡。在配置中添加了 `upstream` 块:
```nginx upstream io_nodes { ip_hash; server 127.0.0.1:4567; server 127.0.0.1:4568; server 127.0.0.1:4569; } ```
... 并将 `location /` 块中的 `proxy_pass` 指令改为:`proxy_pass http://io_nodes;`
应用上述所有配置后的 Nginx 示例配置
```nginx upstream io_nodes { ip_hash; server 127.0.0.1:4567; server 127.0.0.1:4568; server 127.0.0.1:4569; }
server { listen 80;
server_name community.nodebb.org;
proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header Host $http_host; proxy_set_header X-NginX-Proxy true; proxy_redirect off;
# Socket.io 支持 proxy_http_version 1.1; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection "upgrade";
gzip on; gzip_min_length 1000; gzip_proxied off; gzip_types text/plain application/xml text/javascript application/javascript application/x-javascript text/css application/json;
location @nodebb { proxy_pass http://io_nodes; }
location ~ ^/assets/(.*) { root /path/to/nodebb/; try_files /build/public/$1 /public/$1 @nodebb; }
location / { proxy_pass http://io_nodes; } } ```
配置 Redis
当你配置 NodeBB 运行多个进程时,需要与主数据存储一起配置 Redis。每个 NodeBB 进程可以通过 Redis 发布/订阅(pub-sub)机制与其他进程通信。请在服务器上安装 Redis,并在 `config.json` 中添加 `redis` 块。以下是一个示例 `config.json`,其中使用 MongoDB 作为数据存储,Redis 作为 pubsub:
```json { "url": "http://example.org", "secret": "your-secret-goes-here", "database": "mongo", "port": [4567, 4568, 4569], "mongo": { "host": "127.0.0.1", "port": "27017", "database": "0" }, "redis": { "host":"127.0.0.1", "port":"6379", "database": 0 } } ```
按此配置后,Redis 还将作为会话存储使用。除了用户会话数据和进程间消息传递外,其他数据不会存储在 Redis 中,因此无需对 Redis 进行备份。如果 Redis 数据丢失,现有的用户会话将失效,用户需要重新登录。
处理重复摘要等任务
默认情况下,每个 NodeBB 实例都假设自己是独立运行的,并执行计划任务,如修剪通知和发送电子邮件摘要。NodeBB 会检测自己是否属于本地集群(即在 `config.json` 中配置了多个端口),并相应调整行为;但如果它是横向扩展部署的一部分,它不会主动与邻居通信以选举主服务器。
在这种情况下,除了一个服务器外,其他所有服务器都应更新其 `config.json`,添加配置项 `jobsDisabled`。将其设置为 `true` 将禁用这些任务,从而确保它们只在其中一个服务器上运行。
注意 如果你的部署由多台机器组成,每台机器运行单个 NodeBB 实例(一个端口),则还需要将 `isCluster` 设置为 `true`。
更多信息请参阅我们关于 config.json 的文章。