Nginx配置支持WebSocket功能詳解
更新時間：2024年11月18日 16:25:01 作者：浪子塵晨
Nginx配置支持WebSocket功能需要添加特定配置,網(wǎng)上通用配置只能支持ws請求,而既支持http又支持ws的配置中,使用map$http_upgrade$connection_upgrade塊來設置Connection頭的值,并指定使用HTTP/1.1版本以保持連接打開,確保Nginx版本是1.3或更高
Nginx配置支持WebSocket功能
剛部署一個項目需要使用到WebScoket實現(xiàn)。但通過域名指向NG做了反向代理，發(fā)現(xiàn)通過域名訪問不了，通過查找資料后發(fā)現(xiàn)需要在Nginx添加WebSocket的轉(zhuǎn)發(fā)配置。
一、網(wǎng)上通用配置
在網(wǎng)上找到大部分配置如下所示
location /websocket/ {
proxy_pass http://myserver;
proxy_http_version 1.1;
proxy_read_timeout 360s;
proxy_redirect off;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade"; #配置連接為升級連接
proxy_set_header Host $host:$server_port;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header REMOTE-HOST $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}使用如上連接，如果所有的連接僅僅為 "ws" 協(xié)議的請求是沒有問題的
但是如果要及支持 http 請求又支持 ws 請求上述配置就不起作用了
二、既支持http又支持ws的配置
通過nginx官方關于WebSocket的配置得知，可以自定義變量。
故配置如下，就可以做到既支持 ws 請求，又支持 http請求。
http {
#自定義變量 $connection_upgrade
map $http_upgrade $connection_upgrade {
default keep-alive; #默認為keep-alive 可以支持 一般http請求
'websocket' upgrade; #如果為websocket 則為 upgrade 可升級的。
}
server {
...
location /chat/ {
proxy_pass http://backend;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade; #此處配置 上面定義的變量
proxy_set_header Connection $connection_upgrade;
}
}
}在這個配置中：
- map $http_upgrade $connection_upgrade 塊用于根據(jù)客戶端發(fā)送的 Upgrade 頭的值設置 Connection 頭的值。
- proxy_pass 指向WebSocket服務的后端地址。
- proxy_http_version 1.1 指定使用HTTP/1.1版本以保持連接打開。
- proxy_set_header Upgrade $http_upgrade 和 proxy_set_header Connection $connection_upgrade 確保正確的頭被發(fā)送到后端，以便它可以識別WebSocket連接。
確保您的Nginx版本是1.3或更高，以支持WebSocket。
總結
以上為個人經(jīng)驗，希望能給大家一個參考，也希望大家多多支持腳本之家。
相關文章
這篇文章主要介紹了查看nginx配置文件路徑和資源文件路徑,本文給大家介紹的非常詳細，對大家的學習或工作具有一定的參考借鑒價值，需要的朋友可以參考下2020-11-11
本文詳細介紹了在Ubuntu系統(tǒng)中從源碼安裝Nginx的步驟,包括更新系統(tǒng)、安裝依賴、下載源碼、配置編譯選項、編譯安裝、創(chuàng)建專用用戶、配置Systemd服務、調(diào)整防火墻、驗證安裝、管理和維護Nginx等內(nèi)容2026-04-04
本文系統(tǒng)介紹了Nginx實現(xiàn)Web訪問控制的多種方法,包括IP黑白名單、路徑/方法/參數(shù)控制、HTTP基本認證、防盜鏈機制、客戶端證書校驗、限速限流、地理位置控制等基礎防護策略,感興趣的可以了解一下2025-12-12
在當今互聯(lián)網(wǎng)的世界中,實時通信變得越來越重要,WebSocket 作為一種實現(xiàn)實時雙向通信的技術,正被廣泛應用于各種場景,而 Nginx 作為一款高性能的 Web 服務器和反向代理服務器,在處理 WebSocket 連接方面也有著出色的表現(xiàn),本文介紹了Nginx如何處理WebSocket連接2024-07-07
這篇文章主要介紹了Nginx 運維之域名驗證的方法示例，小編覺得挺不錯的，現(xiàn)在分享給大家，也給大家做個參考。一起跟隨小編過來看看吧2018-10-10
Nginx是使用最多的代理服務器之一,本文主要介紹了Nginx配置http和https的實現(xiàn)步驟,具有一定的參考價值,感興趣的可以了解一下2024-03-03
這篇文章主要介紹了Nginx URL重寫（rewrite）機制原理及使用實例,文中通過示例代碼介紹的非常詳細，對大家的學習或者工作具有一定的參考學習價值,需要的朋友可以參考下2020-08-08
在Linux系統(tǒng)中,NGINX作為高性能的Web服務器和反向代理服務器,廣泛應用于各類生產(chǎn)環(huán)境中,然而,作為一款強大而靈活的工具,NGINX也常常面臨一些常見的故障問題,尤其是在重啟過程中遇到錯誤,本文將詳細講解NGINX重啟失敗的排查與解決方案,需要的朋友可以參考下2025-04-04
本文主要介紹了Nginx代理Partainer的具體使用，文中通過示例代碼介紹的非常詳細，對大家的學習或者工作具有一定的參考學習價值，需要的朋友們下面隨著小編來一起學習學習吧2023-03-03
nginx 配置代理服務地址最后多加反斜杠和不加反斜杠的區(qū)別小結
在使用Nginx配置代理服務時,地址最后是否添加反斜杠（/）會對代理的URL處理產(chǎn)生影響,下面就來具體介紹一下,感興趣的可以了解一下2024-08-08