WebSocket 協(xié)議是實(shí)現(xiàn)實(shí)時(shí)通信的關(guān)鍵技術(shù)。相比于傳統(tǒng)的 HTTP 請(qǐng)求-響應(yīng)模式，WebSocket 提供了雙向、持久化的通信方式。

Nginx 作為一個(gè)高性能的反向代理服務(wù)器，可以非常有效地處理 WebSocket 連接，但要正確處理 WebSocket 長(zhǎng)連接和傳輸大數(shù)據(jù)，必須進(jìn)行一些特定的配置。

1.WebSocket 連接的基本概念

WebSocket 協(xié)議是基于 HTTP 協(xié)議的，它在客戶端和服務(wù)器之間建立了一條持久化的、全雙工的通信通道。在 WebSocket 建立連接后，客戶端和服務(wù)器可以隨時(shí)向?qū)Ψ桨l(fā)送消息，而不需要像傳統(tǒng)的 HTTP 請(qǐng)求那樣重復(fù)建立連接。

Nginx 的作用通常是充當(dāng)反向代理，它將 WebSocket 請(qǐng)求轉(zhuǎn)發(fā)給后端應(yīng)用服務(wù)器。因此，在配置 WebSocket 時(shí)，需要特別注意以下幾點(diǎn)：

• WebSocket 的連接是持久化的，可能會(huì)存在較長(zhǎng)的生命周期。
• WebSocket 數(shù)據(jù)傳輸速度可能較快，傳輸?shù)臄?shù)據(jù)包可能比較大。
• 默認(rèn)的 Nginx 配置不一定適合 WebSocket 長(zhǎng)連接，因此需要進(jìn)行相應(yīng)的優(yōu)化。

2.Nginx 配置 WebSocket 代理

Nginx 本身并不直接支持 WebSocket 協(xié)議，但它可以通過 HTTP 代理將 WebSocket 請(qǐng)求轉(zhuǎn)發(fā)到后端應(yīng)用服務(wù)器。要使 Nginx 支持 WebSocket，關(guān)鍵是配置反向代理時(shí)保持 HTTP 協(xié)議升級(jí)（Upgrade）和連接（Connection）的頭部。

以下是配置 Nginx 作為 WebSocket 代理的基本步驟。

2.1 配置 WebSocket 代理

在 Nginx 中，要支持 WebSocket，最重要的配置是正確設(shè)置 Upgrade和 Connection請(qǐng)求頭，確保 WebSocket 協(xié)議的握手能夠正常進(jìn)行。你可以在 nginx.conf中的 location塊中添加以下配置：

server {

 listen 80;


server_name your-domain.com;
	location /ws/ {

	proxy_pass http://your_backend_server; ?# 后端 WebSocket 服務(wù)地址

	proxy_http_version 1.1; ?# 使用 HTTP/1.1 協(xié)議，WebSocket 需要支持 HTTP/1.1

	proxy_set_header Upgrade $http_upgrade; ?# WebSocket 升級(jí)頭部

	proxy_set_header Connection 'upgrade'; ?# 保持連接活躍

	proxy_set_header Host $host; ?# 轉(zhuǎn)發(fā)原始 Host 頭

	proxy_cache_bypass $http_upgrade; ?# 避免緩存 WebSocket 請(qǐng)求

	}

}

2.2 解釋配置項(xiàng)

• proxy_http_version 1.1;：WebSocket 協(xié)議需要基于 HTTP/1.1，因此需要顯式指定 HTTP 版本為 1.1。
• proxy_set_header Upgrade $http_upgrade;：WebSocket 握手需要進(jìn)行協(xié)議升級(jí)（Upgrade）。通過此配置將客戶端請(qǐng)求中的 Upgrade頭部轉(zhuǎn)發(fā)給后端應(yīng)用服務(wù)器。
• proxy_set_header Connection ‘upgrade’;：指定連接升級(jí)，確保 WebSocket 連接正常建立。
• proxy_set_header Host $host;：傳遞客戶端的 Host 頭，保持請(qǐng)求的原始主機(jī)頭信息。
• proxy_cache_bypass $http_upgrade;：避免緩存 WebSocket 請(qǐng)求，因?yàn)?WebSocket 是一個(gè)持久連接，不能被緩存。

3.配置 WebSocket 長(zhǎng)連接

WebSocket 是一個(gè)長(zhǎng)連接，這意味著客戶端和服務(wù)器之間的連接會(huì)保持較長(zhǎng)時(shí)間，甚至是一直持續(xù)下去。為了確保 WebSocket 長(zhǎng)連接的穩(wěn)定性和性能，Nginx 需要處理一些與連接生命周期相關(guān)的配置。

3.1 調(diào)整 proxy_read_timeout和** proxy_send_timeout**

由于 WebSocket 長(zhǎng)連接會(huì)在較長(zhǎng)時(shí)間內(nèi)保持活躍，因此必須增加 proxy_read_timeout和 proxy_send_timeout的超時(shí)時(shí)間。否則，如果連接空閑時(shí)間較長(zhǎng)，Nginx 會(huì)認(rèn)為連接超時(shí)并關(guān)閉連接。

server {

 listen 80;

 server_name your-domain.com;

	location /ws/ {
	proxy_pass http://your_backend_server;
	proxy_http_version 1.1;
	proxy_set_header Upgrade $http_upgrade;
	proxy_set_header Connection 'upgrade';
	proxy_set_header Host $host;
	proxy_cache_bypass $http_upgrade;

	# 調(diào)整超時(shí)時(shí)間

	proxy_read_timeout 3600s; ?# 設(shè)置為 1 小時(shí)，確保長(zhǎng)連接不被關(guān)閉
	proxy_send_timeout 3600s; ?# 設(shè)置為 1 小時(shí)，允許數(shù)據(jù)發(fā)送較長(zhǎng)時(shí)間
	}

}

• proxy_read_timeout：設(shè)置 Nginx 等待后端服務(wù)器響應(yīng)的時(shí)間。在 WebSocket 中，連接可能處于空閑狀態(tài)，因此需要一個(gè)較長(zhǎng)的超時(shí)時(shí)間。
• proxy_send_timeout：設(shè)置 Nginx 向后端服務(wù)器發(fā)送數(shù)據(jù)的超時(shí)時(shí)間。如果你的應(yīng)用有長(zhǎng)時(shí)間的數(shù)據(jù)傳輸需求，調(diào)整此配置可以避免因超時(shí)而斷開連接。

3.2 調(diào)整 keepalive_timeout

在 Nginx 中，keepalive_timeout配置指定了 Nginx 在與客戶端建立連接后保持連接空閑的時(shí)間。WebSocket 長(zhǎng)連接需要足夠的 keepalive_timeout時(shí)間，以便與客戶端保持持續(xù)的連接。

server {

	listen 80;
	server_name your-domain.com;
	keepalive_timeout 65s; ?# 設(shè)置為 65 秒，以確保 WebSocket 長(zhǎng)連接穩(wěn)定

}

通過調(diào)整 keepalive_timeout，你可以控制 Nginx 和客戶端之間保持空閑連接的時(shí)間。為了避免 WebSocket 連接被意外關(guān)閉，可以適當(dāng)增加該值。

4.配置 WebSocket 數(shù)據(jù)大小限制

WebSocket 數(shù)據(jù)傳輸?shù)拇笮】赡軙?huì)較大，特別是在視頻流、文件傳輸?shù)葓?chǎng)景中。Nginx 默認(rèn)對(duì)請(qǐng)求體大小有限制，如果 WebSocket 消息的大小超過默認(rèn)值，可能會(huì)導(dǎo)致連接失敗或消息丟失。因此，需要調(diào)整 Nginx 的數(shù)據(jù)傳輸大小限制。

4.1 調(diào)整 client_max_body_size

client_max_body_size配置控制客戶端請(qǐng)求的最大允許大小。對(duì)于 WebSocket 長(zhǎng)連接，特別是涉及大數(shù)據(jù)傳輸?shù)膽?yīng)用，可能需要調(diào)整此限制。

server {

	listen 80;

	server_name your-domain.com;

	location /ws/ {

	proxy_pass http://your_backend_server;

	proxy_http_version 1.1;

	proxy_set_header Upgrade $http_upgrade;

	proxy_set_header Connection 'upgrade';

	proxy_set_header Host $host;

	proxy_cache_bypass $http_upgrade;



	# 調(diào)整請(qǐng)求體大小限制

	client_max_body_size 50M; ?# 設(shè)置最大請(qǐng)求體為 50MB

	}

}

• client_max_body_size：此設(shè)置指定 Nginx 接收客戶端請(qǐng)求的最大體積。WebSocket 通常用來傳輸小型消息，但在某些應(yīng)用場(chǎng)景下（如視頻、文件傳輸），消息體積可能會(huì)較大。因此，適當(dāng)增加該值，以便處理大數(shù)據(jù)傳輸。

4.2 調(diào)整 proxy_max_temp_file_size

Nginx 還會(huì)將大數(shù)據(jù)緩存到臨時(shí)文件中，proxy_max_temp_file_size配置項(xiàng)可以控制緩存文件的大小。

server {

	listen 80;
	server_name your-domain.com;

	location /ws/ {

	proxy_pass http://your_backend_server;

	proxy_http_version 1.1;

	proxy_set_header Upgrade $http_upgrade;

	proxy_set_header Connection 'upgrade';

	proxy_set_header Host $host;

	proxy_cache_bypass $http_upgrade;



	# 調(diào)整最大臨時(shí)文件大小

	proxy_max_temp_file_size 1024m; ?# 設(shè)置臨時(shí)文件最大為 1GB

	}

}

5.總結(jié)

WebSocket 提供了高效的實(shí)時(shí)通信能力，但在實(shí)際部署中，尤其是當(dāng)涉及長(zhǎng)連接和大數(shù)據(jù)傳輸時(shí)，必須對(duì) Nginx 進(jìn)行一些優(yōu)化配置以確保連接的穩(wěn)定性和高效性。

• 通過設(shè)置合適的 proxy_read_timeout、proxy_send_timeout和 keepalive_timeout，可以確保 WebSocket 長(zhǎng)連接在長(zhǎng)時(shí)間沒有活動(dòng)的情況下仍然保持打開狀態(tài)。
• 調(diào)整 client_max_body_size和 proxy_max_temp_file_size配置，可以確保 WebSocket 能夠傳輸大數(shù)據(jù)。
• 保證 WebSocket 連接的升級(jí)（Upgrade）和連接保持（Connection）頭部正確轉(zhuǎn)發(fā)，確保 WebSocket 協(xié)議能夠正常工作。

通過這些配置，你可以確保 Nginx 能夠高效、穩(wěn)定地代理 WebSocket 長(zhǎng)連接，支持大數(shù)據(jù)傳輸，滿足實(shí)時(shí)通信應(yīng)用的需求。

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

最新評(píng)論