Skip to content
mobius1qwe edited this page Nov 16, 2026 · 1 revision

Home > Colocar no ar > SCGI e uwsgi 🚧

SCGI e uwsgi: o RAL atrás do nginx, protocolos simples

Important

Em desenvolvimento (2.0). Ainda não está numa versão lançada e pode mudar.

Vale para a 2.0 · Delphi XE em diante e Lazarus/FPC 3.2 em diante · Nível: intermediário

Em uma frase: o TRALSCGIServer e o TRALUwsgiServer são motores como o FastCGI: o servidor web cuida do HTTPS, dos arquivos e do HTTP/2 e passa os pedidos ao seu programa, que fica vivo entre um pedido e outro. Mudam só o enquadramento: SCGI e uwsgi são protocolos mais simples, com uma conexão por pedido.

Você vai precisar: os pacotes SCGIRAL (e UwsgiRAL para o uwsgi, que requer o SCGIRAL) e RALNetPackage. Os protocolos são do próprio RAL, os mesmos no Delphi e no Lazarus.

Qual escolher

FastCGI SCGI uwsgi
nginx fastcgi_pass scgi_pass uwsgi_pass
Apache 2.4 mod_proxy_fcgi mod_proxy_scgi mod_proxy_uwsgi
conexão com o servidor web mantida (fastcgi_keep_conn on) uma por pedido uma por pedido
resposta em fluxo ao vivo sim sim sim
porta padrão 9000 4000 3031

Na dúvida, use o FastCGI: a conexão mantida economiza um connect por pedido. SCGI e uwsgi servem a quem já tem a configuração do servidor web pronta para eles.

Código

uses RALSCGIServer, RALUwsgiServer;

Scgi := TRALSCGIServer.Create(Self);
Scgi.Port := 4000;
Scgi.PathBase := '/scgi';                  // o nginx passa o caminho inteiro
Scgi.CreateRoute('clientes', Clientes);    // atende /scgi/clientes
Scgi.Active := True;

Uwsgi := TRALUwsgiServer.Create(Self);
Uwsgi.Port := 3031;
Uwsgi.CreateRoute('clientes', Clientes);
Uwsgi.Active := True;

nginx

location /scgi/ {
  include scgi_params;
  scgi_pass 127.0.0.1:4000;
  scgi_buffering off;      # resposta em fluxo chega ao vivo
}
location /api/ {
  include uwsgi_params;
  uwsgi_pass 127.0.0.1:3031;
  uwsgi_buffering off;
}

O scgi_params e o uwsgi_params vêm com o nginx (pasta /etc/nginx) e já mandam o REQUEST_URI.

O que o motor faz

  • o caminho vem de REQUEST_URI (ou SCRIPT_NAME + PATH_INFO + QUERY_STRING), os cabeçalhos de HTTP_*, o IP de REMOTE_ADDR, HTTPS de HTTPS=on;
  • os plugins de validação julgam o pedido antes de o corpo ser lido: um pedido recusado (tamanho, endereço) não custa a leitura;
  • a resposta inteira sai com Content-Length; uma resposta em fluxo (Send, SendEvent) sai ao vivo, e o fim da conexão marca o fim do corpo;
  • SCGI responde no formato do CGI (Status: 200 OK), uwsgi no do HTTP (HTTP/1.1 200 OK);
  • um cabeçalho malformado (ou maior que MaxHeaderSize, 64 KB) fecha a conexão sem resposta; MaxConnections limita as conexões do servidor web; ReadTimeout é quanto uma conexão pode ficar calada no meio de um pedido.

Só TCP por enquanto (o socket Unix fica para depois). No uwsgi, só o modificador 0 (o pedido com as variáveis CGI): os outros pacotes do protocolo do uWSGI não se aplicam.

Veja também

Começar

Servidor

MQTT 🚧

E-mail 🚧

Chatbot 🚧

Cliente

Motores

Avançado

Ajuda

🚧 = em desenvolvimento, pode mudar

Clone this wiki locally