进阶 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,下次用户访问未运行的论坛时,就会看到你的自定义页面。

评论 (0)