Como o Nginx escolhe entre locations correspondentes?

Question

IT Interview Practice · Accepted Answer

Uma location escolhe o que o Nginx faz com um caminho. Uma regra que parece mais específica nem sempre vence: correspondências exatas, prefixos e expressões regulares têm prioridades diferentes.

## Comece com três regras

Estas locations são irmãs dentro de um único bloco server:

```nginx
location = /health { return 200 "health"; }
location /images/ { return 200 "images"; }
location ~ \.jpg$ { return 200 "jpg"; }
```

- `/health` retorna `health`: `=` significa correspondência exata, que encerra imediatamente a seleção.
- `/images/cat.png` retorna `images`: o prefixo corresponde, mas a expressão regular não.
- `/images/cat.jpg` retorna `jpg`: a expressão regular tem precedência sobre o prefixo comum.

## Como manter imagens na regra de prefixo

Troque `location /images/` por `location ^~ /images/`. Se este for o maior prefixo correspondente, o Nginx ignora as expressões regulares neste nível; assim, `/images/cat.jpg` passa a retornar `images`.

## Lembre-se da ordem

Nesta configuração plana: primeiro a correspondência exata; caso contrário, guarde o maior prefixo e use a primeira expressão regular correspondente, a menos que `^~` impeça essa verificação. Parâmetros de consulta não participam. Locations aninhadas e redirecionamentos internos acrescentam etapas de seleção; teste-os separadamente.

[Documentação oficial](https://nginx.org/en/docs/http/ngx_http_core_module.html#location).

Comece com três regras

Como manter imagens na regra de prefixo

Lembre-se da ordem

Perguntas relacionadas