news 2026/5/8 2:58:46

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/4/28 13:43:33

Nginx之rewrite重写功能

目录 一、rewrite概述 1、rewrite功能 2、跳转场景 二、标准配置指令 1、rewrite日志记录指令 2、未初始化变量告警日志记录指令 3、rewrite 指令 3.1 正则表达式 三、rewrite模块使用实例 1.基于域名的跳转 2.基于客户端 IP 访问跳转 3.?基于旧域名跳转到新域名后…

作者头像 李华
网站建设 2026/5/4 17:46:20

arduino寻迹小车小白指南:轻松融入机器人课堂

从零开始做一辆“会思考”的小车&#xff1a;Arduino寻迹项目实战教学你有没有试过&#xff0c;写几行代码&#xff0c;就能让一个小车自己沿着黑线跑起来&#xff1f;不是遥控&#xff0c;也不是预设轨道——它真的能“看”路、“判断”方向&#xff0c;甚至在转弯时微微调整速…

作者头像 李华
网站建设 2026/5/7 23:14:04

【MiniMax】基于FastAPI + LangGraph + LLM大语言模型的通用Agent多智能体系统

基于 FastAPI + LangGraph + LLM 大语言模型的通用 Agent 多智能体系统架构设计与开发实战、产业应用 文章目录 基于 FastAPI + LangGraph + LLM 大语言模型的通用 Agent 多智能体系统架构设计与开发实战、产业应用 内容简介 第一部分:理论基础与技术栈概览 第1章 从大语言模型…

作者头像 李华
网站建设 2026/5/4 19:55:23

vivado2022.2安装全流程图文并茂的系统学习资料

Vivado 2022.2 安装实战全攻略&#xff1a;从零搭建高效 FPGA 开发环境 你是否曾因为 Vivado 安装失败而耽误项目进度&#xff1f;是否在下载器卡在 0% 时束手无策&#xff1f;又或者&#xff0c;好不容易装上了却提示“License Checkout Failed”&#xff1f; 别担心&#x…

作者头像 李华
网站建设 2026/5/4 8:13:27

STM32 GPIO控制有源蜂鸣器操作指南

蜂鸣器也能玩出花&#xff1f;用STM32一个GPIO口搞定报警提示音你有没有遇到过这样的场景&#xff1a;调试一块新板子&#xff0c;上电后啥反应都没有——LED不闪、屏幕不亮、串口没输出。这时候要是有个“滴”一声的启动音&#xff0c;至少能告诉你&#xff1a;芯片是活的&…

作者头像 李华
网站建设 2026/5/5 19:50:26

核谱回归(Kernel Spectral Regression)算法详解与MATLAB实现

核谱回归(Kernel Spectral Regression)算法详解与MATLAB实现 在机器学习和数据降维领域,谱回归(Spectral Regression, SR)是一种高效的子空间学习方法,它通过将传统的谱嵌入问题转化为一系列回归问题,大大降低了计算复杂度。当数据分布复杂、呈现非线性结构时,我们常常…

作者头像 李华