Nginx配置WebSocket代理詳解：實現實時通信支持

M66 2025-07-09

什麼是WebSocket協議

WebSocket是一種基於TCP的全雙工通信協議，它允許客戶端和服務器之間建立持久連接，實現實時數據的雙向傳輸。相比傳統的HTTP輪詢，WebSocket在即時通信、實時推送等場景中具有更高的效率和更低的延遲。

為什麼使用Nginx代理WebSocket

在實際部署中，我們往往需要使用Nginx作為前端代理服務器，用於處理負載均衡、安全訪問控制、路徑轉發等功能。為了支持WebSocket協議，需要對Nginx進行額外的配置，以保證連接能夠穩定、持續地傳遞到後端服務。

安裝Nginx

首先，請確保您的服務器上已安裝Nginx。可以通過包管理工具進行安裝：

sudo apt install nginx # Debian/Ubuntu 系統sudo yum install nginx # CentOS 系統

安裝完成後，可使用nginx -v查看版本，確保安裝成功。

配置Nginx支持WebSocket

接下來，需要修改Nginx的配置文件，通常是/etc/nginx/nginx.conf或某個sites-enabled中的配置文件。

配置map 和upstream

map $http_upgrade $connection_upgrade {
    default upgrade;
    &#39;&#39; close;
}

upstream backend {
    server 127.0.0.1:8080;
}

這段配置的作用是為WebSocket連接的Upgrade頭設置映射，並指定後端應用的地址。

配置server 區塊中的location

location /websocket {
    proxy_pass http://backend;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection $connection_upgrade;
}

該配置會將訪問/websocket路徑的請求轉發給後端，並攜帶必要的頭信息，使WebSocket握手過程能夠順利完成。

重啟Nginx使配置生效

配置完成後，執行以下命令重啟Nginx服務：

sudo service nginx restart

如配置無誤，Nginx將支持WebSocket連接的轉發。

測試WebSocket連接

可以通過瀏覽器或其他客戶端工具測試WebSocket是否連接成功。以下是一個基本的JavaScript示例：

var ws = new WebSocket("ws://your_domain/websocket");

ws.onopen = function() {
    console.log("Connected to WebSocket");
};

ws.onmessage = function(event) {
    console.log("Received message: " + event.data);
};

ws.onclose = function() {
    console.log("Disconnected from WebSocket");
};

將上述代碼嵌入到HTML中，在瀏覽器中打開後，觀察控制台是否能顯示連接狀態即可。

總結

通過配置Nginx代理WebSocket，我們可以實現高性能、穩定的實時通信支持。 Nginx本身並不處理WebSocket邏輯，僅負責轉發連接和處理協議相關頭部，後端仍需具備WebSocket服務能力。在部署現代Web應用時，結合Nginx的代理功能與後端WebSocket服務，是實現實時數據交互的理想選擇。