Repository navigation
scgi uwsgi
Home > Colocar no ar > SCGI e uwsgi 🚧
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.
| 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.
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;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 caminho vem de
REQUEST_URI(ouSCRIPT_NAME+PATH_INFO+QUERY_STRING), os cabeçalhos deHTTP_*, o IP deREMOTE_ADDR, HTTPS deHTTPS=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;MaxConnectionslimita 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.
- FastCGI
- Atrás de um proxy
- Exemplo:
GatewayExample(Delphi e Lazarus)
Começar
Servidor
- Rotas e parâmetros
- Rotas avançadas: tipos, grupos, versões 🚧
- Ler o pedido e responder
- Objetos no corpo 🚧
- Resposta em fluxo 🚧
- Plugins 🚧
- Serviços (contêiner de dependências) 🚧
- Barramento de eventos 🚧
- Tarefas em segundo plano 🚧
- Recursos com estado 🚧
- Autenticação
- Banco de dados (DBWare)
- Servir site e arquivos
- JSON-RPC 2.0 🚧
- GraphQL 🚧
- Servidor MCP (IA) 🚧
-
Protocol Buffers 🚧
- gRPC 🚧
- WebSocket 🚧
- Hubs (WebSocket) 🚧
- SignalR 🚧
- Swagger e Postman
- Servidor SOAP 🚧
- WS-Security 🚧
- HTTPS
- Criptografia ponto a ponto
- Segurança para produção
- Colocar no ar
- Desempenho
- Testes em memória 🚧
MQTT 🚧
- O que é e quando usar 🚧
- Cliente MQTT 🚧
- Broker MQTT 🚧
- MQTT-SN 🚧
- Ponte REST 🚧
- Segurança 🚧
- Rede ruim 🚧
E-mail 🚧
- Mensagens 🚧
- Enviar 🚧
- Enviar por REST e ação 🚧
- Receber 🚧
- Ler a caixa postal 🚧
- Verificar o que chega 🚧
- Servir caixas postais 🚧
- S/MIME 🚧
- OpenPGP 🚧
Chatbot 🚧
- O robô e os canais 🚧
- Telegram 🚧
- Gateways REST (WhatsApp não oficial) 🚧
- Discord 🚧
- Slack 🚧
- Microsoft Teams 🚧
- Conversa em etapas 🚧
Cliente
Motores
- Qual motor escolher?
- Compatibilidade
- Recursos
- QUIC
- Motor NgHttp2 (HTTP/2) 🚧
- Motor XSocket 🚧
- Motor AdvancedHTTP (experimental) 🚧
Avançado
Ajuda
- Problemas comuns
- Atualizar o Indy
- Várias versões do Delphi
- Vídeos e guias
- Módulos de terceiros
- Licenças
- Contribuir
- Roadmap e changelog
🚧 = em desenvolvimento, pode mudar