进阶 docs.nodebb.org 2026-10-13 15:07:09 · 36 阅读
第24章 配置 Nginx 作为 NodeBB 反向代理
将 nginx 配置为反向代理
NodeBB 默认运行在 4567 端口,因此通常需要通过「主机名 + 端口号」的方式访问(例如 http://example.org:4567)。
如果希望不带端口号直接访问 NodeBB,可以配置 nginx,把发往某个主机名(或子域名)的所有请求代理到运行在任意端口上的 NodeBB 实例。
环境要求
NGINX 版本需为 v1.3.13 或更高
包管理器自带的版本可能偏旧。要获取最新版本,可以自行编译;Ubuntu 用户可使用 NGINX Stable 或 NGINX Development PPA 源,Debian 用户可通过 DotDeb 仓库安装最新版 Nginx。
在 shell 中执行 nginx -V 可查看当前 nginx 版本
配置
由 NGINX 提供服务的站点都包含在一个 server 块中。该配置块应放在哪里,取决于 nginx 的安装和配置方式:
/path/to/nginx/sites-available/* —— 此目录下的文件需软链接到 ../sites-enabled
/path/to/nginx/conf.d/*.conf —— 文件名必须以 .conf 结尾
/path/to/nginx/httpd.conf —— 实在不行就放这里
配置示例
基础配置
针对运行在 4567 端口的 NodeBB 的基础 nginx 配置:
server {
listen 80;
server_name forum.example.org;
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;
proxy_redirect off;
# Socket.IO Support
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
}
}
基础配置(子目录安装)
此配置适用于 NodeBB 的 url 值中包含子目录的情况,例如 /forum。
server {
listen 80;
server_name forum.example.org; # 注意这里没有定义子目录
location /forum/ { # 子目录定义在这里
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; # 这里也不需要子目录
proxy_redirect off;
# Socket.IO Support
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
}
}
基础配置(多端口)
适用于运行在两个端口上的 NodeBB。此时该 NodeBB 的 config.json 中 port 应设置为:["4567","4568"]。
server {
listen 80;
server_name forum.example.org;
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://io_nodes;
proxy_redirect off;
# Socket.IO Support
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
}
}
upstream io_nodes {
ip_hash;
server 127.0.0.1:4567;
server 127.0.0.1:4568;
}
基础配置(SSL)
启用 SSL 的配置。
### 将 http 请求重定向到 https
server {
listen 80;
server_name forum.example.org;
return 302 https://$server_name$request_uri;
}
### https 服务器
server {
# 监听 ssl,并尽可能启用 spdy 加速
listen 443 ssl spdy;
server_name forum.example.org;
# 记得修改这些路径!
ssl_certificate /path/to/cert/bundle.crt;
ssl_certificate_key /path/to/cert/forum.example.org.key;
# 启用所有版本的 TLS,但不启用已被淘汰的不安全的 SSLv2 和 SSLv3
ssl_protocols TLSv1 TLSv1.1 TLSv1.2;
# 禁用所有弱加密算法
ssl_ciphers 'AES128+EECDH:AES128+EDH';
ssl_prefer_server_ciphers on;
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; # 末尾不要加斜杠
proxy_redirect off;
# Socket.IO Support
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
}
}
注意事项
如果 NodeBB 和 nginx 部署在同一台服务器上,proxy_pass 的 IP 应为 127.0.0.1。必要时请把端口改成与你 NodeBB 实际一致的端口。
绝大多数情况下,proxy_pass 末尾都不应带路径。也就是说,值应为 http://127.0.0.1:4567(必要时替换 IP),不要带末尾斜杠或路径。
这份配置只是让 nginx 监听发往 forum.example.org 的请求,并不会自动把互联网流量引导过来,所以你还需要更新 DNS,把 forum.example.org 的请求解析到运行 nginx 的那台机器上!
在 CentOS 7 上可能会遇到 "Bad Gateway" 错误,执行 setsebool -P httpd_can_network_connect on 即可解决。
将 Nginx 配置为使用自定义错误页
下面的示例演示如何配置 Nginx,在论坛未运行时显示自定义的 502 错误页。
创建自定义错误页
新建一个 502.html 文件,放到 /usr/share/nginx/html 目录下。这是 Nginx 默认的文档根目录。记得在 502.html 中填入内容,以下示例可直接复制使用:
在这里填写页面标题
在这里填写页面内容。
让 Nginx 使用你的自定义错误页面 现在需要告诉 Nginx 在发生相应错误时使用我们的页面。打开你的服务器块文件 `/etc/nginx/sites-available/default`。如果你使用的是非默认的服务器块文件,记得把 default 替换成你的文件。 server { # Config will be here. error_page 502 /502.html; location = /502.html { root /usr/share/nginx/html; internal; } } 这里使用 `error_page` 指令,以便在发生 502 错误时提供你创建的自定义页面。`location` 块确保 `root` 指向我们文件系统中的位置,且该文件仅能通过 Nginx 的内部重定向访问。 运行 `sudo service nginx restart` 重启 Nginx,下次用户访问未运行的论坛时,就会看到你的自定义页面。