wils@web ~ $ cat ~/ajuda/como-configurar-o-nginx-1-24-para-suportar-websockets-com-seguranca.md

Servidores

Como configurar o Nginx 1.24 para suportar WebSockets com segurança

atualizado em 02/08/2026

O Nginx é um servidor web de alto desempenho que pode ser configurado para suportar WebSockets de forma segura. Este manual irá guiá-lo na configuração do Nginx 1.24 para habilitar WebSockets com segurança.

Pré-requisitos

  • Servidor Linux com Nginx 1.24 instalado
  • Conhecimento básico de linha de comando
  • Certificado SSL (opcional, mas recomendado)

Passo a Passo

1. Instalar o Nginx

sudo apt update
sudo apt install nginx

2. Habilitar WebSockets

WebSockets requerem algumas configurações específicas no Nginx. Edite o arquivo de configuração do seu site:

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

Adicione as seguintes linhas dentro do bloco server {}:

location /ws {
    proxy_pass http://localhost:3000; # Altere para o seu backend
    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;
}

3. Configurar SSL (opcional, mas recomendado)

Para garantir a segurança, é recomendável usar HTTPS. Se você já possui um certificado SSL, adicione as seguintes linhas:

server {
    listen 443 ssl;
    server_name seu_dominio.com;
    ssl_certificate /caminho/para/certificado.crt;
    ssl_certificate_key /caminho/para/chave.key;

    location /ws {
        # Configurações de WebSocket aqui
    }
}

4. Testar a configuração

Após realizar as alterações, teste a configuração do Nginx:

sudo nginx -t

5. Reiniciar o Nginx

Se não houver erros, reinicie o Nginx para aplicar as alterações:

sudo systemctl restart nginx

Conclusão

Agora você configurou o Nginx 1.24 para suportar WebSockets com segurança. Certifique-se de monitorar os logs do Nginx para verificar se há problemas de conexão. Uma dica importante é sempre manter seu Nginx atualizado para garantir a segurança e o desempenho.

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.