news 2026/2/7 9:48:33

Nginx中如何配置WebSocket代理?

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
Nginx中如何配置WebSocket代理?

Nginx 可以配置为 WebSocket 代理,将 WebSocket 连接从客户端转发到后端服务器。以下是如何在 Nginx 中配置 WebSocket 代理的详细步骤和示例配置。

1. 安装 Nginx

确保你已经安装了 Nginx。如果没有安装,可以使用以下命令进行安装:

sudo apt-get update sudo apt-get install nginx
2. 配置 WebSocket 代理

编辑 Nginx 配置文件,通常位于/etc/nginx/nginx.conf/etc/nginx/sites-available/default。以下是一个示例配置,展示了如何配置 WebSocket 代理。

示例配置:
http { # 定义 upstream 块,指定后端 WebSocket 服务器 upstream websocket_backend { server backend1.example.com:8080; server backend2.example.com:8080; } server { listen 80; server_name example.com; # 配置 WebSocket 代理 location /ws { proxy_pass http://websocket_backend; proxy_http_version 1.1; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection "upgrade"; proxy_set_header Host $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; # 可选:设置超时时间 proxy_read_timeout 86400s; } # 配置静态文件或其他路径 location / { root /var/www/html; index index.html index.htm; } } }
3. 参数解释
  • proxy_pass:指定后端 WebSocket 服务器的地址。
  • proxy_http_version 1.1:设置 HTTP 版本为 1.1,WebSocket 协议需要 HTTP/1.1。
  • proxy_set_header Upgrade $http_upgrade:传递客户端的Upgrade头部。
  • proxy_set_header Connection "upgrade":传递客户端的Connection头部,指示这是一个 WebSocket 升级请求。
  • proxy_set_header Host $host:传递客户端的Host头部。
  • proxy_set_header X-Real-IP $remote_addr:传递客户端的真实 IP 地址。
  • proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for:传递客户端的X-Forwarded-For头部。
  • proxy_set_header X-Forwarded-Proto $scheme:传递客户端的协议(HTTP 或 HTTPS)。
  • proxy_read_timeout 86400s:设置读取超时时间,WebSocket 连接通常是长连接,因此需要设置较长的超时时间。
4. 测试配置

在重新加载 Nginx 之前,先测试配置文件是否有语法错误。

sudo nginx -t
5. 重新加载 Nginx

如果配置文件没有问题,重新加载 Nginx 使配置生效。

sudo systemctl reload nginx
6. 验证配置

确保 WebSocket 连接可以正常建立和通信。可以在前端使用 WebSocket 客户端进行测试。

示例前端代码:
<!DOCTYPE html> <html> <head> <title>WebSocket Test</title> </head> <body> <script> var socket = new WebSocket('ws://example.com/ws'); socket.onopen = function() { console.log('WebSocket connection opened'); socket.send('Hello, WebSocket!'); }; socket.onmessage = function(event) { console.log('Message from server:', event.data); }; socket.onclose = function() { console.log('WebSocket connection closed'); }; socket.onerror = function(error) { console.error('WebSocket error:', error); }; </script> </body> </html>
总结

通过上述配置,Nginx 可以作为 WebSocket 代理,将客户端的 WebSocket 连接转发到后端服务器。这些配置确保了 WebSocket 连接的正确性和稳定性。如果你有更具体的问题或需要进一步的技术细节,请随时告诉我。

版权声明: 本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若内容造成侵权/违法违规/事实不符,请联系邮箱:809451989@qq.com进行投诉反馈,一经查实,立即删除!
网站建设 2026/2/3 1:12:54

从STM32视角看CANFD和CAN的区别:通俗解释带宽差异

从STM32视角看CAN FD与经典CAN的差异&#xff1a;一场关于带宽、效率和未来的对话 你有没有遇到过这样的场景&#xff1f; 在调试一个基于STM32的电池管理系统时&#xff0c;主控MCU需要从多个从节点读取电压、温度和SOC数据。每帧只有8字节的经典CAN协议&#xff0c;逼得你不…

作者头像 李华
网站建设 2026/2/6 12:52:37

[特殊字符]_可扩展性架构设计:从单体到微服务的性能演进[20260110164857]

作为一名经历过多次系统架构演进的老兵&#xff0c;我深知可扩展性对Web应用的重要性。从单体架构到微服务&#xff0c;我见证了无数系统在扩展性上的成败。今天我要分享的是基于真实项目经验的Web框架可扩展性设计实战。 &#x1f4a1; 可扩展性的核心挑战 在系统架构演进过…

作者头像 李华
网站建设 2026/2/4 2:43:08

C++ 变量作用域

局部变量局部变量在函数或代码块内部声明&#xff0c;仅在该函数或代码块内有效。生命周期从声明开始到代码块结束。例如&#xff1a;void func() {int x 10; // 局部变量cout << x; // 有效 } // cout << x; // 错误&#xff1a;x在此处不可见全局变量全局变量…

作者头像 李华
网站建设 2026/2/4 16:25:34

人类有史以来最伟大的10大壮举与天问一号

文章目录1. 人类有史以来最伟大的10大壮举&#xff08;按影响与突破排序&#xff09;2. 天问一号时间线&#xff08;含关键节点&#xff09;1. 人类有史以来最伟大的10大壮举&#xff08;按影响与突破排序&#xff09; 生命科学&#xff1a;人类基因组计划&#xff08;2003&…

作者头像 李华
网站建设 2026/2/3 13:30:32

S32DS使用一文说清:S32K GPIO外设初始化步骤

S32DS实战指南&#xff1a;从零搞懂S32K GPIO初始化全流程你有没有遇到过这样的情况——代码烧进去&#xff0c;LED就是不亮&#xff1f;按键按烂了也没反应&#xff1f;调试半天才发现&#xff0c;原来是某个时钟没开、引脚复用配错了&#xff0c;或者方向寄存器写反了。这种低…

作者头像 李华
网站建设 2026/2/6 1:36:12

一文说清STM32F4串口通信的STM32CubeMX教程配置步骤

手把手教你用STM32CubeMX配置STM32F4串口通信&#xff1a;从零开始的实战指南你有没有遇到过这种情况&#xff1f;刚焊好一块STM32F4开发板&#xff0c;想通过串口打印“Hello World”验证一下基本功能&#xff0c;结果打开串口助手却一片漆黑——没输出。反复检查代码、波特率…

作者头像 李华