news 2026/7/24 19:38:24

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/7/24 8:18:42

66_Spring AI 干货笔记之工具调用(工具执行与解析)

一、工具执行 工具执行是使用提供的输入参数调用工具并返回结果的过程。工具执行由ToolCallingManager接口处理,该接口负责管理工具执行生命周期。 public interface ToolCallingManager {/*** 从模型的工具调用选项中解析工具定义。*/List<ToolDefinition> resolveTo…

作者头像 李华
网站建设 2026/7/24 6:45:15

Nginx中$http_host、$host、$proxy_host的区别

知识巩固&#xff01; 网上看到这篇文章&#xff0c;这里转载记录一下。 简介 变量 是否显示端口 值是否存在 host 浏览器请求的ip&#xff0c;不显示端口 否 "Host:value"显示 值为a:b的时候&#xff0c;只显示a http_host 浏览器请求的ip和端口号 是 “Host:value”…

作者头像 李华
网站建设 2026/7/24 11:05:12

【2026亲测】彻底禁止Windows 10/11自动更新,让电脑暂停更新10年!

你是否厌倦了Windows系统在工作或游戏时突然弹出的“正在更新”提示&#xff1f;虽然微软推送更新是为了安全&#xff0c;但在实际体验中&#xff0c;频繁的强制重启、更新后的驱动不兼容、甚至突如其来的“蓝屏死机”&#xff0c;让无数用户头疼不已。 更让人无奈的是&#xf…

作者头像 李华
网站建设 2026/7/24 6:45:20

STM32使用HAL库实现I2C通信完整指南

STM32 HAL库I2C通信实战指南&#xff1a;从协议到代码的完整闭环你有没有遇到过这样的场景&#xff1f;明明按照例程配置了STM32的I2C&#xff0c;可HAL_I2C_Master_Transmit()就是返回HAL_ERROR&#xff1b;逻辑分析仪抓出来一看&#xff0c;SDA线卡在低电平不动——总线“挂死…

作者头像 李华
网站建设 2026/7/24 16:08:34

和谐哈希(Harmonious Hashing)编码过程详解

和谐哈希(Harmonious Hashing,简称HamH)是一种经典的无监督线性哈希方法,其核心设计在于通过主成分分析(PCA)降维后引入一个正交旋转矩阵,使最终的投影方向尽可能均衡地分布在各维度上。这种“和谐”特性能够有效避免某些比特位信息冗余或失效,从而提升二进制码的整体区…

作者头像 李华