SCGI#
Permite passar requisições para um servidor SCGI. Faz com que conexões de saída para um servidor SCGI se originem do endereço IP local especificado com uma porta opcional. O valor do parâmetro pode conter variáveis. O valor especial O parâmetro Para que este parâmetro funcione, geralmente é necessário executar os processos worker do Angie com privilégios de superusuário. No Linux isso não é necessário, pois se o parâmetro Nota É necessário configurar a tabela de roteamento do kernel para interceptar o tráfego de rede do servidor SCGI. Define o tamanho do buffer usado para ler a primeira parte da resposta recebida do servidor SCGI. Esta parte geralmente contém um pequeno cabeçalho de resposta. Por padrão, o tamanho do buffer é igual a uma página de memória. Isso é 4K ou 8K, dependendo da plataforma. Pode ser feito menor, no entanto. Habilita ou desabilita o buffering de respostas do servidor SCGI. O Angie recebe uma resposta do servidor SCGI o mais rápido possível, salvando-a nos buffers definidos pelas diretivas scgi_buffer_size e scgi_buffers. Se toda a resposta não couber na memória, uma parte dela pode ser salva em um arquivo temporário no disco. A escrita em arquivos temporários é controlada pelas diretivas scgi_max_temp_file_size e scgi_temp_file_write_size. A resposta é passada para um cliente de forma síncrona, imediatamente conforme é recebida. O Angie não tentará ler toda a resposta do servidor SCGI. O tamanho máximo dos dados que o Angie pode receber do servidor de uma vez é definido pela diretiva scgi_buffer_size. O buffering também pode ser habilitado ou desabilitado passando "yes" ou "no" no campo de cabeçalho de resposta Define o número e tamanho dos buffers usados para ler uma resposta do servidor SCGI, para uma única conexão. Por padrão, o tamanho do buffer é igual a uma página de memória. Isso é 4K ou 8K, dependendo da plataforma. Padrão http, server, location Quando o buffering de respostas do servidor SCGI está habilitado, limita o tamanho total dos buffers que podem estar ocupados enviando uma resposta para o cliente enquanto a resposta ainda não foi totalmente lida. Enquanto isso, o resto dos buffers pode ser usado para ler a resposta e, se necessário, fazer buffer de parte da resposta em um arquivo temporário. Por padrão, o tamanho é limitado pelo tamanho de dois buffers definidos pelas diretivas scgi_buffer_size e scgi_buffers. Define uma zona de memória compartilhada usada para cache. A mesma zona pode ser usada em vários lugares. O valor do parâmetro pode conter variáveis. desabilita o cache herdado do nível de configuração anterior. Padrão http, server, location Permite iniciar uma sub-requisição em segundo plano para atualizar um item de cache expirado, enquanto uma resposta em cache obsoleta é retornada ao cliente. Aviso Note que é necessário permitir o uso de uma resposta em cache obsoleta quando ela está sendo atualizada. Define condições sob as quais a resposta não será obtida de um cache. Se pelo menos um valor dos parâmetros de string não estiver vazio e não for igual a "0", então a resposta não será obtida do cache: Pode ser usado junto com a diretiva scgi_no_cache. Define uma chave para cache, por exemplo Quando habilitado, apenas uma requisição por vez será permitida para popular um novo elemento de cache identificado de acordo com a diretiva scgi_cache_key passando uma requisição para um servidor SCGI. Outras requisições do mesmo elemento de cache irão aguardar uma resposta aparecer no cache ou o bloqueio de cache para este elemento ser liberado, até o tempo definido pela diretiva scgi_cache_lock_timeout. Se a última requisição passada para o servidor SCGI para popular um novo elemento de cache não foi completada pelo tempo especificado, mais uma requisição pode ser passada para o servidor SCGI. Define um timeout para scgi_cache_lock. Quando o tempo expira, a requisição será passada para o servidor SCGI, porém, a resposta não será armazenada em cache. Define um deslocamento em bytes para requisições de intervalo de bytes. Se o intervalo estiver além do deslocamento, a requisição de intervalo será passada para o servidor SCGI e a resposta não será armazenada em cache. Padrão http, server, location Se o método de requisição do cliente estiver listado nesta diretiva, então a resposta será armazenada em cache. Os métodos "GET" e "HEAD" são sempre adicionados à lista, embora seja recomendado especificá-los explicitamente. Veja também a diretiva scgi_no_cache. Define o número de requisições após as quais a resposta será armazenada em cache. Padrão — http Define o caminho e outros parâmetros de um cache. Os dados do cache são armazenados em arquivos. O nome do arquivo em um cache é resultado da aplicação da função MD5 à chave de cache. O parâmetro os nomes de arquivo em um cache ficarão assim: Uma resposta em cache é primeiro escrita em um arquivo temporário, e então o arquivo é renomeado. Arquivos temporários e o cache podem ser colocados em sistemas de arquivos diferentes. Porém, esteja ciente de que neste caso um arquivo é copiado entre dois sistemas de arquivos ao invés da operação barata de renomeação. É assim recomendado que para qualquer localização dada tanto o cache quanto um diretório contendo arquivos temporários sejam colocados no mesmo sistema de arquivos. O diretório para arquivos temporários é definido baseado no parâmetro Se este parâmetro for omitido ou definido para o valor on, o diretório definido pela diretiva scgi_temp_path para a localização dada será usado. Arquivos temporários serão colocados diretamente no diretório de cache. Além disso, todas as chaves ativas e informações sobre dados são armazenadas em uma zona de memória compartilhada, cujo nome e tamanho são configurados pelo parâmetro Dados em cache que não são acessados durante o tempo especificado pelo parâmetro Por padrão, Um processo especial gerenciador de cache monitora o tamanho máximo do cache e a quantidade mínima de espaço livre no sistema de arquivos com cache e quando o tamanho é excedido ou não há espaço livre suficiente, ele remove os dados usados menos recentemente. Os dados são removidos em iterações. tamanho máximo do cache quantidade mínima de espaço livre no sistema de arquivos com cache limita o número de itens a serem excluídos durante uma iteração Por padrão, limita a duração de uma iteração Por padrão, configura uma pausa entre iterações Por padrão, Um minuto após o Angie iniciar, o processo especial carregador de cache é ativado. Ele carrega informações sobre dados previamente armazenados em cache no sistema de arquivos em uma zona de cache. O carregamento também é feito em iterações. limita o número de itens a carregar durante uma iteração Por padrão, limita a duração de uma iteração Por padrão, configura uma pausa entre iterações Por padrão, Padrão http, server, location Habilita a revalidação de itens de cache expirados usando requisições condicionais com os campos de cabeçalho Padrão http, server, location Determina em quais casos uma resposta em cache desatualizada pode ser usada. Os parâmetros da diretiva correspondem aos parâmetros da diretiva scgi_next_upstream. permite usar uma resposta em cache desatualizada se um servidor SCGI para processar uma requisição não puder ser selecionado. parâmetro adicional, permite usar uma resposta em cache desatualizada se ela estiver sendo atualizada no momento. Isso permite minimizar o número de acessos aos servidores SCGI ao atualizar dados em cache. O uso de uma resposta em cache desatualizada também pode ser habilitado diretamente no cabeçalho de resposta por um número especificado de segundos após a resposta ter se tornado desatualizada: A extensão stale-while-revalidate do campo de cabeçalho A extensão stale-if-error do campo de cabeçalho Nota Isso tem prioridade menor que usar os parâmetros da diretiva. Para minimizar o número de acessos aos servidores SCGI ao popular um novo elemento de cache, a diretiva scgi_cache_lock pode ser usada. Define o tempo de cache para diferentes códigos de resposta. Por exemplo, as seguintes diretivas definem 10 minutos de cache para respostas com códigos 200 e 302 e 1 minuto para respostas com código 404. Se apenas o tempo de cache for especificado então apenas respostas 200, 301 e 302 são armazenadas em cache. Além disso, o parâmetro Nota Parâmetros de cache também podem ser definidos diretamente no cabeçalho de resposta. Isso tem prioridade maior que a definição do tempo de cache usando a diretiva. O campo de cabeçalho Se o cabeçalho não incluir o campo Se o cabeçalho incluir o campo Se o cabeçalho incluir o campo O processamento de um ou mais desses campos de cabeçalho de resposta pode ser desabilitado usando a diretiva scgi_ignore_headers. Define um timeout para estabelecer uma conexão com um servidor SCGI. Deve-se notar que este timeout geralmente não pode exceder 75 segundos. Padrão http, server, location Habilita o encerramento de todas as conexões com o servidor proxy após ele ter sido
removido do grupo ou marcado como permanentemente indisponível por um processo de reresolve ou o comando da API
Uma conexão é encerrada quando o próximo evento de leitura ou escrita é processado para
o cliente ou o servidor proxy. Definir time habilita um timeout de encerramento de conexão;
com Habilita o suporte a byte-range tanto para respostas em cache quanto não armazenadas em cache do servidor SCGI, independentemente do campo Por padrão, o Angie não passa os campos de cabeçalho Padrão http, server, location Determina se a conexão com um servidor SCGI deve ser fechada quando um cliente fecha a conexão sem aguardar uma resposta. Desabilita o processamento de certos campos de cabeçalho de resposta do servidor SCGI. Os seguintes campos podem ser ignorados: Se não desabilitado, o processamento desses campos de cabeçalho tem o seguinte efeito: Padrão http, server, location Determina se as respostas do servidor SCGI com códigos maiores ou iguais a 300 devem ser passadas para um cliente ou serem interceptadas e redirecionadas para o Angie para processamento com a diretiva error_page. Limita a velocidade de leitura da resposta do servidor SCGI.
A taxa é especificada em bytes por segundo e pode conter variáveis. desabilita a limitação de taxa Nota O limite é definido por requisição, e assim se o Angie abrir simultaneamente duas conexões para o servidor SCGI, a taxa geral será duas vezes maior que o limite especificado. A limitação funciona apenas se o buffering de respostas do servidor SCGI estiver habilitado. Padrão http, server, location Quando o buffering de respostas do servidor SCGI está habilitado, e toda a resposta não cabe nos buffers definidos pelas diretivas scgi_buffer_size e scgi_buffers, uma parte da resposta pode ser salva em um arquivo temporário. Esta diretiva define o tamanho máximo do arquivo temporário. O tamanho dos dados escritos no arquivo temporário por vez é definido pela diretiva scgi_temp_file_write_size. desabilita o buffering de respostas para arquivos temporários Nota Esta restrição não se aplica a respostas que serão cacheadas ou armazenadas em disco. Padrão http, server, location Especifica em quais casos uma requisição deve ser passada para o próximo servidor: ocorreu um erro ao estabelecer uma conexão com o servidor, passar uma requisição para ele, ou ler o cabeçalho da resposta; ocorreu um timeout ao estabelecer uma conexão com o servidor, passar uma requisição para ele, ou ler o cabeçalho da resposta; um servidor retornou uma resposta vazia ou inválida; um servidor retornou uma resposta com o código 500; um servidor retornou uma resposta com o código 503; um servidor retornou uma resposta com o código 403; um servidor retornou uma resposta com o código 404; um servidor retornou uma resposta com o código 429; normalmente, requisições com um método não-idempotente
( desabilita passar uma requisição para o próximo servidor. Nota Deve-se ter em mente que passar uma requisição para o próximo servidor só é possível se nada foi enviado para um cliente ainda. Ou seja, se um erro ou timeout ocorre no meio da transferência de uma resposta, corrigir isso é impossível. A diretiva também define o que é considerado uma tentativa mal-sucedida de comunicação com um servidor. são sempre consideradas tentativas mal-sucedidas, mesmo se não estão especificadas na diretiva são consideradas tentativas mal-sucedidas apenas se estão especificadas na diretiva nunca são consideradas tentativas mal-sucedidas Passar uma requisição para o próximo servidor pode ser limitado pelo número de tentativas e por tempo. Padrão http, server, location Limita o tempo durante o qual uma requisição pode ser passada para o próximo servidor. desativa esta limitação Padrão http, server, location Limita o número de tentativas possíveis para passar uma requisição para o próximo servidor. desativa esta limitação Define condições sob as quais a resposta não será salva em cache. Se pelo menos um valor dos parâmetros string não estiver vazio e não for igual a "0", então a resposta não será salva: Pode ser usado junto com a diretiva scgi_cache_bypass. Define um parâmetro que deve ser passado para o servidor SCGI. O valor pode conter texto, variáveis e sua combinação. Essas diretivas são herdadas do nível de configuração anterior se e somente se não houver diretivas scgi_param definidas no nível atual. As variáveis de ambiente CGI padrão devem ser fornecidas como cabeçalhos SCGI, veja o arquivo scgi_params fornecido na distribuição: Se a diretiva for especificada com Define o endereço de um servidor SCGI. O endereço pode ser especificado como um nome de domínio ou endereço IP, e uma porta opcional: ou como um caminho de socket de domínio UNIX: Se um nome de domínio resolver para vários endereços, todos eles serão usados em modo round-robin. Além disso, um endereço pode ser especificado como um grupo de servidores. O valor do parâmetro pode conter variáveis. Neste caso, se um endereço for especificado como um nome de domínio, o nome é procurado entre os grupos de servidores descritos e, se não for encontrado, é determinado usando um resolver. Permite passar campos de cabeçalho normalmente desabilitados de um servidor SCGI para um cliente. Padrão http, server, location Indica se o corpo da requisição original é passado para o servidor SCGI. Veja também a diretiva scgi_pass_request_headers. Padrão http, server, location Indica se os campos de cabeçalho da requisição original são passados para o servidor SCGI. Veja também a diretiva scgi_pass_request_body. Define um timeout para ler uma resposta do servidor SCGI. O timeout é definido apenas entre duas operações de leitura sucessivas, não para a transmissão de toda a resposta. Se o servidor SCGI não transmitir nada dentro deste tempo, a conexão é fechada. Padrão http, server, location Habilita ou desabilita o buffering do corpo da requisição do cliente. todo o corpo da requisição é lido do cliente antes de enviar a requisição para um servidor SCGI. o corpo da requisição é enviado para o servidor SCGI imediatamente conforme é recebido. Neste caso, a requisição não pode ser passada para o próximo servidor se o Angie já começou a enviar o corpo da requisição. Quando a codificação de transferência HTTP/1.1 chunked é usada para enviar o corpo da requisição original, o corpo da requisição será armazenado em buffer independentemente do valor da diretiva. Define um timeout para transmitir uma requisição para o servidor SCGI. O timeout é definido apenas entre duas operações de escrita sucessivas, não para a transmissão de toda a requisição. Se o servidor SCGI não receber nada dentro deste tempo, a conexão é fechada. Padrão http, server, location Configura o comportamento "TCP keepalive" para conexões de saída para um servidor SCGI. Por padrão, as configurações do sistema operacional estão em vigor para o socket. A opção de socket SO_KEEPALIVE é ativada para o socket. Habilita o salvamento de arquivos em disco. salva arquivos com caminhos correspondentes às diretivas alias ou root desabilita o salvamento de arquivos O nome do arquivo pode ser definido explicitamente usando a string com variáveis: O tempo de modificação dos arquivos é definido de acordo com o campo de cabeçalho de resposta Esta diretiva pode ser usada para criar cópias locais de arquivos estáticos imutáveis, por exemplo: Padrão http, server, location Define permissões de acesso para arquivos e diretórios recém-criados, por exemplo: Se quaisquer permissões de acesso Padrão http, server, location Limita o tamanho dos dados escritos em um arquivo temporário por vez, quando o buffering de respostas do servidor SCGI para arquivos temporários está habilitado. Por padrão, o tamanho é limitado por dois buffers definidos pelas diretivas scgi_buffer_size e scgi_buffers. O tamanho máximo de um arquivo temporário é definido pela diretiva scgi_max_temp_file_size. Padrão http, server, location Define um diretório para armazenar arquivos temporários com dados recebidos de servidores SCGI. Até três níveis de hierarquia de subdiretórios podem ser usados abaixo do diretório especificado. Por exemplo, na seguinte configuração um arquivo temporário pode parecer com isto: Veja também o parâmetro Exemplo de Configuração#
location / {
include scgi_params;
scgi_pass localhost:9000;
}
Diretivas#
scgi_bind#
off cancela o efeito da diretiva scgi_bind herdada do nível de configuração anterior, o que permite ao sistema atribuir automaticamente o endereço IP local e a porta.transparent permite que conexões de saída para um servidor SCGI se originem de um endereço IP não-local, por exemplo, de um endereço IP real de um cliente:scgi_bind $remote_addr transparent;
transparent for especificado, os processos worker herdam a capacidade CAP_NET_RAW do processo mestre.scgi_buffer_size#
scgi_buffering#
onoffX-Accel-Buffering. Esta capacidade pode ser desabilitada usando a diretiva scgi_ignore_headers.scgi_buffers#
scgi_busy_buffers_size#
scgi_busy_buffers_size size;scgi_busy_buffers_size 8k | 16k;scgi_cache#
offscgi_cache_background_update#
scgi_cache_background_update on | off;scgi_cache_background_update off;scgi_cache_bypass#
scgi_cache_bypass $cookie_nocache $arg_nocache$arg_comment;
scgi_cache_bypass $http_pragma $http_authorization;
scgi_cache_key#
scgi_cache_key localhost:9000$request_uri;
scgi_cache_lock#
scgi_cache_lock_age#
scgi_cache_lock_timeout#
scgi_cache_max_range_offset#
scgi_cache_methods#
scgi_cache_methods GET | HEAD | POST ...;scgi_cache_methods GET HEAD;scgi_cache_min_uses#
scgi_cache_path#
scgi_cache_path path [levels=levels] [use_temp_path=on | off] keys_zone=name:size [inactive=time] [max_size=size] [min_free=size] [manager_files=number] [manager_sleep=time] [manager_threshold=time] [loader_files=number] [loader_sleep=time] [loader_threshold=time];levels define níveis de hierarquia de um cache: de 1 a 3, cada nível aceita valores 1 ou 2. Por exemplo, na seguinte configuração:scgi_cache_path /data/angie/cache levels=1:2 keys_zone=one:10m;
/data/angie/cache/c/29/b7f54b2df7773722d382f4809d65029c
use_temp_path.onoffkeys_zone. Uma zona de um megabyte pode armazenar cerca de 8 mil chaves.inactive são removidos do cache independentemente de sua atualidade.inactive é definido para 10 minutos.max_sizemin_freemanager_files100manager_threshold200 milissegundosmanager_sleep50 milissegundosloader_files100loader_threshold200 milissegundosloader_sleep50 milissegundosscgi_cache_revalidate#
scgi_cache_revalidate on | off;scgi_cache_revalidate off;If-Modified-Since e If-None-Match.scgi_cache_use_stale#
scgi_cache_use_stale error | timeout | invalid_header | updating | http_500 | http_503 | http_403 | http_404 | http_429 | off ...;scgi_cache_use_stale off;errorupdatingCache-Control permite usar uma resposta em cache desatualizada se ela estiver sendo atualizada no momento.Cache-Control permite usar uma resposta em cache desatualizada em caso de erro.scgi_cache_valid#
scgi_cache_valid 200 302 10m;
scgi_cache_valid 404 1m;
scgi_cache_valid 5m;
any pode ser especificado para armazenar em cache qualquer resposta:scgi_cache_valid 200 302 10m;
scgi_cache_valid 301 1h;
scgi_cache_valid any 1m;
X-Accel-Expires define o tempo de cache de uma resposta em segundos. O valor zero desabilita o cache para uma resposta. Se o valor começar com o prefixo @, ele define um tempo absoluto em segundos desde a Época, até o qual a resposta pode ser armazenada em cache.X-Accel-Expires, parâmetros de cache podem ser definidos nos campos de cabeçalho Expires ou Cache-Control.Set-Cookie, tal resposta não será armazenada em cache.Vary com o valor especial "*", tal resposta não será armazenada em cache. Se o cabeçalho incluir o campo Vary com outro valor, tal resposta será armazenada em cache levando em conta os campos de cabeçalho de requisição correspondentes.scgi_connect_timeout#
scgi_connection_drop#
scgi_connection_drop time | on | off;scgi_connection_drop off;DELETE.on definido, as conexões são descartadas imediatamente.scgi_force_ranges#
Accept-Ranges nessas respostas.scgi_hide_header#
Status e X-Accel-... da resposta de um servidor SCGI para um cliente. A diretiva scgi_hide_header define campos adicionais que não serão passados. Se, ao contrário, a passagem de campos deve ser permitida, a diretiva scgi_pass_header pode ser usada.scgi_ignore_client_abort#
scgi_ignore_client_abort on | off;scgi_ignore_client_abort off;scgi_ignore_headers#
X-Accel-Redirect, X-Accel-Expires, X-Accel-Limit-Rate, X-Accel-Buffering, X-Accel-Charset, Expires, Cache-Control, Set-Cookie e Vary.X-Accel-Expires, Expires, Cache-Control, Set-Cookie e Vary definem os parâmetros de cache da resposta;X-Accel-Redirect executa um redirecionamento interno para o URI especificado;X-Accel-Limit-Rate define o limite de taxa para transmissão de uma resposta para um cliente;X-Accel-Buffering habilita ou desabilita o buffering de uma resposta;X-Accel-Charset define o charset desejado de uma resposta.scgi_intercept_errors#
scgi_intercept_errors on | off;scgi_intercept_errors off;scgi_limit_rate#
0scgi_max_temp_file_size#
scgi_max_temp_file_size tamanho;scgi_max_temp_file_size 1024m;0scgi_next_upstream#
scgi_next_upstream error | timeout | invalid_header | http_500 | http_503 | http_403 | http_404 | http_429 | non_idempotent | off ...;scgi_next_upstream error timeout;errortimeoutinvalid_headerhttp_500http_503http_403http_404http_429non_idempotentPOST, LOCK, PATCH) não são passadas para o
próximo servidor se uma requisição foi enviada para um servidor upstream;
habilitar esta opção permite explicitamente tentar novamente tais requisições;offerrortimeoutinvalid_headerhttp_500http_503http_429http_403http_404scgi_next_upstream_timeout#
scgi_next_upstream_timeout tempo;scgi_next_upstream_timeout 0;0scgi_next_upstream_tries#
scgi_next_upstream_tries número;scgi_next_upstream_tries 0;0scgi_no_cache#
scgi_no_cache $cookie_nocache $arg_nocache$arg_comment;
scgi_no_cache $http_pragma $http_authorization;
scgi_param#
location / {
include scgi_params;
# ...
}
if_not_empty, então tal parâmetro será passado para o servidor apenas se seu valor não estiver vazio:scgi_param HTTPS $https if_not_empty;
scgi_pass#
scgi_pass localhost:9000;
scgi_pass unix:/tmp/scgi.socket;
scgi_pass_header#
scgi_pass_request_body#
scgi_pass_request_body on | off;scgi_pass_request_body on;scgi_pass_request_headers#
scgi_pass_request_headers on | off;scgi_pass_request_headers on;scgi_read_timeout#
scgi_request_buffering#
scgi_request_buffering on | off;scgi_request_buffering on;onoffscgi_send_timeout#
scgi_socket_keepalive#
scgi_socket_keepalive on | off;scgi_socket_keepalive off;ofonscgi_store#
onoffscgi_store /data/www$original_uri;
Last-Modified recebido. A resposta é primeiro escrita em um arquivo temporário, e então o arquivo é renomeado. Arquivos temporários e o armazenamento persistente podem ser colocados em sistemas de arquivos diferentes. No entanto, esteja ciente de que neste caso um arquivo é copiado entre dois sistemas de arquivos em vez da operação barata de renomeação. É, portanto, recomendado que para qualquer localização dada, tanto os arquivos salvos quanto um diretório contendo arquivos temporários, definido pela diretiva scgi_temp_path, sejam colocados no mesmo sistema de arquivos.location /images/ {
root /data/www;
error_page 404 = /fetch$uri;
}
location /fetch/ {
internal;
scgi_pass backend:9000;
...
scgi_store on;
scgi_store_access user:rw group:rw all:r;
scgi_temp_path /data/temp;
alias /data/www/;
}
scgi_store_access#
scgi_store_access users:permissions ...;scgi_store_access user:rw;scgi_store_access user:rw group:rw all:r;
group ou all forem especificadas, então as
permissões de usuário podem ser omitidas:scgi_store_access group:rw all:r;
scgi_temp_file_write_size#
scgi_temp_file_write_size size;scgi_temp_file_write_size 8k|16k;scgi_temp_path#
scgi_temp_path path [level1 [level2 [level3]]]`;scgi_temp_path scgi_temp;
(o caminho depende da --http-scgi-temp-path opção de build)scgi_temp_path /spool/angie/scgi_temp 1 2;
/spool/angie/scgi_temp/7/45/00000123457
use_temp_path da diretiva scgi_cache_path.
Conteúdo