快捷導(dǎo)航

Nginx配置支持WebSocket功能詳解

更新時(shí)間：2024年11月18日 16:25:01 作者：浪子塵晨

Nginx配置支持WebSocket功能需要添加特定配置,網(wǎng)上通用配置只能支持ws請(qǐng)求,而既支持http又支持ws的配置中,使用map$http_upgrade$connection_upgrade塊來設(shè)置Connection頭的值,并指定使用HTTP/1.1版本以保持連接打開,確保Nginx版本是1.3或更高

Nginx配置支持WebSocket功能

剛部署一個(gè)項(xiàng)目需要使用到WebScoket實(shí)現(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";    #配置連接為升級(jí)連接
        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é)議的請(qǐng)求是沒有問題的

但是如果要及支持 http 請(qǐng)求又支持 ws 請(qǐng)求上述配置就不起作用了

二、既支持http又支持ws的配置

通過nginx官方關(guān)于WebSocket的配置得知，可以自定義變量。

故配置如下，就可以做到既支持 ws 請(qǐng)求，又支持 http請(qǐng)求。

http {
 
   #自定義變量 $connection_upgrade
    map $http_upgrade $connection_upgrade { 
        default          keep-alive;  #默認(rèn)為keep-alive 可以支持 一般http請(qǐng)求
        'websocket'      upgrade;     #如果為websocket 則為 upgrade 可升級(jí)的。
    }
 
    server {
        ...
 
        location /chat/ {
            proxy_pass http://backend;
            proxy_http_version 1.1;
            proxy_set_header Upgrade $http_upgrade; #此處配置 上面定義的變量
            proxy_set_header Connection $connection_upgrade;
        }
    }
}

在這個(gè)配置中：

map $http_upgrade $connection_upgrade 塊用于根據(jù)客戶端發(fā)送的 Upgrade 頭的值設(shè)置 Connection 頭的值。
proxy_pass 指向WebSocket服務(wù)的后端地址。
proxy_http_version 1.1 指定使用HTTP/1.1版本以保持連接打開。
proxy_set_header Upgrade $http_upgrade 和 proxy_set_header Connection $connection_upgrade 確保正確的頭被發(fā)送到后端，以便它可以識(shí)別WebSocket連接。

確保您的Nginx版本是1.3或更高，以支持WebSocket。

總結(jié)

以上為個(gè)人經(jīng)驗(yàn)，希望能給大家一個(gè)參考，也希望大家多多支持腳本之家。

您可能感興趣的文章:

相關(guān)文章

查看nginx配置文件路徑和資源文件路徑的方法
這篇文章主要介紹了查看nginx配置文件路徑和資源文件路徑,本文給大家介紹的非常詳細(xì)，對(duì)大家的學(xué)習(xí)或工作具有一定的參考借鑒價(jià)值，需要的朋友可以參考下
2020-11-11
在Ubuntu上安裝Nginx的實(shí)現(xiàn)過程
本文詳細(xì)介紹了在Ubuntu系統(tǒng)中從源碼安裝Nginx的步驟,包括更新系統(tǒng)、安裝依賴、下載源碼、配置編譯選項(xiàng)、編譯安裝、創(chuàng)建專用用戶、配置Systemd服務(wù)、調(diào)整防火墻、驗(yàn)證安裝、管理和維護(hù)Nginx等內(nèi)容
2026-04-04
Nginx 訪問控制的多種方法
本文系統(tǒng)介紹了Nginx實(shí)現(xiàn)Web訪問控制的多種方法,包括IP黑白名單、路徑/方法/參數(shù)控制、HTTP基本認(rèn)證、防盜鏈機(jī)制、客戶端證書校驗(yàn)、限速限流、地理位置控制等基礎(chǔ)防護(hù)策略,感興趣的可以了解一下
2025-12-12
詳解Nginx如何處理WebSocket連接
在當(dāng)今互聯(lián)網(wǎng)的世界中,實(shí)時(shí)通信變得越來越重要,WebSocket 作為一種實(shí)現(xiàn)實(shí)時(shí)雙向通信的技術(shù),正被廣泛應(yīng)用于各種場景,而 Nginx 作為一款高性能的 Web 服務(wù)器和反向代理服務(wù)器,在處理 WebSocket 連接方面也有著出色的表現(xiàn),本文介紹了Nginx如何處理WebSocket連接
2024-07-07
Nginx 運(yùn)維之域名驗(yàn)證的方法示例
這篇文章主要介紹了Nginx 運(yùn)維之域名驗(yàn)證的方法示例，小編覺得挺不錯(cuò)的，現(xiàn)在分享給大家，也給大家做個(gè)參考。一起跟隨小編過來看看吧
2018-10-10
Nginx配置http和https的實(shí)現(xiàn)步驟
Nginx是使用最多的代理服務(wù)器之一,本文主要介紹了Nginx配置http和https的實(shí)現(xiàn)步驟,具有一定的參考價(jià)值,感興趣的可以了解一下
2024-03-03
Nginx URL重寫rewrite機(jī)制原理及使用實(shí)例
這篇文章主要介紹了Nginx URL重寫（rewrite）機(jī)制原理及使用實(shí)例,文中通過示例代碼介紹的非常詳細(xì)，對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值,需要的朋友可以參考下
2020-08-08
Nginx重啟失敗排查與解決方案
在Linux系統(tǒng)中,NGINX作為高性能的Web服務(wù)器和反向代理服務(wù)器,廣泛應(yīng)用于各類生產(chǎn)環(huán)境中,然而,作為一款強(qiáng)大而靈活的工具,NGINX也常常面臨一些常見的故障問題,尤其是在重啟過程中遇到錯(cuò)誤,本文將詳細(xì)講解NGINX重啟失敗的排查與解決方案,需要的朋友可以參考下
2025-04-04
Nginx代理Partainer的具體使用
本文主要介紹了Nginx代理Partainer的具體使用，文中通過示例代碼介紹的非常詳細(xì)，對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值，需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧
2023-03-03
nginx 配置代理服務(wù)地址最后多加反斜杠和不加反斜杠的區(qū)別小結(jié)
在使用Nginx配置代理服務(wù)時(shí),地址最后是否添加反斜杠（/）會(huì)對(duì)代理的URL處理產(chǎn)生影響,下面就來具體介紹一下,感興趣的可以了解一下
2024-08-08