【Nginx】【SSE】【WebSocket】Nginx配置SSE，WebSocket的转发请求

id="article_content" class="article_content clearfix"> id="content_views" class="markdown_views prism-atom-one-dark">

Nginx 配置 SSE 和 WebSocket 转发

一、配置背景（火狐游览器不支持，建议谷歌游览器开发测试）

在使用 Django 框架开发 Web 应用时，为了实现实时通信，可以选择使用以下两种技术：

  • SSE (Server-Sent Events): 适用于服务器向客户端推送单向数据流。
  • WebSocket: 适用于双向通信场景。

为了将 SSE 和 WebSocket 的请求正确转发到后端服务，Nginx 需要根据特定的请求路径进行配置。

二、Nginx 配置示例

（一）基础配置（这是在一个文件内容）

  1. 定义变量用于处理 WebSocket 的 Upgrade 和 Connection 请求头：
map $http_upgrade $connection_upgrade {
    default upgrade;
    ''      close;
}
 class="hljs-button signin active" data-title="登录复制" data-report-click="{"spm":"1001.2101.3001.4334"}">
  • 1
  • 2
  • 3
  • 4
  1. 服务器配置：
server {
    listen 80;
    server_name 192.168.1.9;

    # 处理静态文件的路径
    location /static/ {
        alias /home/lan/backHub/PopSubBack/PopSubBack/staticfiles/;
    }

    # 正常的接口请求转发到 后端
    location / {
        proxy_pass http://127.0.0.1:8000;  # 转发到后端
        proxy_set_header Host $http_host;
        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;
    }

    # 转发 SSE 请求
    location ~ ^/sse/ {  # 匹配以 /sse/ 开头的路径
        proxy_pass http://127.0.0.1:8000;  # 转发到ASGI 后端服务
        proxy_http_version 1.1;
        proxy_set_header Connection '';
        proxy_buffering off;  # 禁用缓冲，确保实时性
        proxy_read_timeout 3600s;  # 设置超时时间
    }

    # 转发 WebSocket 请求
    location ^~ /ws/ {
        proxy_pass http://127.0.0.1:8000;  # 转发到 ASGI 服务器
        # 保证连接不会超时
        proxy_read_timeout 300s;
        proxy_send_timeout 300s;

        # 转发 WebSocket 请求头
        proxy_set_header Host $http_host;
        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;

        # WebSocket 特有配置
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection $connection_upgrade;

        # 可选: 传递 Authorization 头部，如果需要身份验证
        proxy_set_header Authorization $http_authorization;
    }
}
 class="hljs-button signin active" data-title="登录复制" data-report-click="{"spm":"1001.2101.3001.4334"}">
class="hide-preCode-box">
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29
  • 30
  • 31
  • 32
  • 33
  • 34
  • 35
  • 36
  • 37
  • 38
  • 39
  • 40
  • 41
  • 42
  • 43
  • 44
  • 45
  • 46
  • 47
  • 48
  • 49
  1. 打开并编辑 Nginx 配置文件：
sudo nano /etc/nginx/sites-available/your_site_name
 class="hljs-button signin active" data-title="登录复制" data-report-click="{"spm":"1001.2101.3001.4334"}">

然后通过创建符号链接，将配置文件从 sites-available 启用到 sites-enabled 目录：

三、配置说明

（一）SSE 配置

  1. 路径匹配：

    • 使用 location ~ ^/sse/ 匹配所有以 /sse/ 开头的路径。

  2. 实时性优化：

    • proxy_buffering off: 禁用缓冲，确保数据流能及时推送到客户端。
    • proxy_read_timeout 3600s: 设置长时间超时，避免连接因长时间无活动而被关闭。

  3. HTTP 版本：

    • 强制使用 HTTP 1.1，以支持持久连接。

（二）WebSocket 配置

  1. 路径匹配：

    • 使用 location ^~ /ws/ 匹配所有以 /ws/ 开头的路径。

  2. 升级请求：

    • proxy_set_header Upgrade $http_upgrade;
    • proxy_set_header Connection $connection_upgrade;
    • 确保请求头包含 Upgrade 和 Connection 字段，以支持 WebSocket 协议。

  3. 超时设置：

    • proxy_read_timeout 和 proxy_send_timeout 设置为 300 秒，防止因无活动而断开连接。

  4. HTTP 版本：

    • 强制使用 HTTP 1.1，以支持 WebSocket 的双向通信。

四、总结

通过上述配置，Nginx 能够：

在实际部署中，可以根据服务需求进一步调整参数，例如路径规则、超时时间和认证机制。

>>
注：本文转载自blog.csdn.net的患得患失949的文章"https://blog.csdn.net/qq_59344127/article/details/145281602"。版权归原作者所有，此博客不拥有其著作权，亦不承担相应法律责任。如有侵权，请联系我们删除。
复制链接
复制链接
相关推荐
发表评论

评论记录：

未查询到任何数据！