wils@web ~ $ cat ~/ajuda/como-configurar-o-nginx-1-22-para-suporte-a-websocket-em-aplicacoes-em-tempo-real.md

Servidores

Como configurar o Nginx 1.22 para suporte a WebSocket em aplicações em tempo real

atualizado em 21/07/2026

Introdução

O Nginx é um servidor web altamente eficiente que pode ser configurado para suportar WebSockets, permitindo a comunicação em tempo real entre clientes e servidores. Este manual fornece um passo a passo para configurar o Nginx 1.22 para aplicações que utilizam WebSocket.

Passo a Passo

1. Instalação do Nginx

Se você ainda não tem o Nginx instalado, utilize os seguintes comandos:

sudo apt update
sudo apt install nginx

2. Verificação da Instalação

Verifique se o Nginx está instalado corretamente e em execução:

systemctl status nginx

3. Configuração do Nginx para WebSocket

Abra o arquivo de configuração do Nginx para edição:

sudo nano /etc/nginx/sites-available/default

Adicione a seguinte configuração ao bloco server { ... }:

location /ws/ {
    proxy_pass http://localhost:3000;
    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;
}

4. Teste de Configuração

Após editar a configuração, teste se não há erros de sintaxe:

sudo nginx -t

5. Reinicie o Nginx

Reinicie o Nginx para aplicar as novas configurações:

sudo systemctl restart nginx

Conclusão

Agora, o Nginx está configurado para suportar WebSockets. Lembre-se de verificar a documentação da sua aplicação para garantir que o endpoint WebSocket está correto. Dica: Monitore os logs do Nginx para identificar possíveis problemas de conexão.

Precisa de ajuda com isso no seu servidor? A gente resolve pra você.

falar no WhatsApp

// deu erro ou não funcionou?

Achou algo errado neste manual?

Conta pra gente o que deu errado ou qual erro apareceu — a gente corrige. Se quiser retorno, deixe seu contato.