Como Reescrever URLs no NGINX: Guia Completo

Publicado em 1 de Março, 20251 de Março, 2025 por Spo_oky

Quer aprender a reescrever URLs no NGINX? Então, este guia completo é perfeito para si! Reescrever URLs é uma técnica poderosa que permite alterar ou redirecionar endereços web no NGINX, tornando os seus sites mais amigáveis para utilizadores e motores de busca. Assim, neste tutorial, vamos explorar tudo o que precisa: desde o que significa reescrever URLs, os passos para configurá-las, até testar e otimizar as suas regras. O NGINX, conhecido pela sua eficiência e flexibilidade, torna este processo simples, mesmo para iniciantes. Além disso, se já configurou o NGINX ou geriu hosts virtuais, esta é uma habilidade natural para expandir o seu conhecimento. Porquê reescrever URLs? Porque melhora a experiência do utilizador, otimiza SEO e corrige links antigos. Portanto, prepare-se para mergulhar neste guia prático e descubra como reescrever URLs no NGINX de forma clara e eficaz. Vamos começar?

O que Significa Reescrever URLs no NGINX e Porquê Fazê-lo?

Antes de mais, o que significa reescrever URLs no NGINX? Em termos simples, é o processo de alterar ou redirecionar um URL pedido pelo utilizador para outro destino no servidor. Por exemplo, pode transformar site.com/produtos/antigo em site.com/loja/novo ou redirecionar permanentemente um link quebrado. O NGINX faz isso usando diretivas como rewrite ou return, ajustadas nos ficheiros de configuração.

Então, porquê reescrever URLs no NGINX? Primeiro, melhora a usabilidade. URLs curtas e legíveis, como site.com/blog em vez de site.com/index.php?page=blog, são mais fáceis de lembrar e partilhar. Segundo, é ótimo para SEO. Motores de busca, como o Google, preferem URLs limpas e consistentes, o que pode aumentar o ranking do seu site. Além disso, permite corrigir links antigos ou migrar conteúdo sem perder tráfego – imagine mudar de uma plataforma para outra e manter os visitantes.

Outro motivo é a flexibilidade do NGINX. Desde 2004, este servidor web destaca-se por configurações poderosas, como vimos em Como entender e editar os ficheiros de configuração do NGINX. Por fim, é essencial para manutenção: pode esconder detalhes técnicos (ex.: remover extensões .php) ou gerir múltiplos projetos num só servidor. Assim, reescrever URLs no NGINX é uma ferramenta valiosa para tornar os seus sites mais eficientes e acessíveis.

Pré-requisitos para Reescrever URLs no NGINX

Antes de começar a reescrever URLs no NGINX, precisa de garantir que tem tudo pronto. Felizmente, os pré-requisitos são básicos e fáceis de cumprir. Vamos por partes:

NGINX Instalado e Funcional

Primeiramente, o NGINX deve estar instalado e ativo no seu sistema. Se ainda não o fez, consulte os nossos guias: Como instalar NGINX no Ubuntu, Como instalar NGINX no Windows ou Como instalar NGINX no macOS. Teste com nginx -v para confirmar a versão e sudo systemctl status nginx (ou equivalente) para verificar se está a correr.

Acesso aos Ficheiros de Configuração

Em seguida, precisa de aceder aos ficheiros de configuração. No Ubuntu, estão em /etc/nginx/, no Windows em C:\nginx\conf\, e no macOS (via Homebrew) em /usr/local/etc/nginx/. Um editor como Nano (sudo nano), Vim ou VS Code será necessário – mais sobre isso em Como entender e editar os ficheiros de configuração do NGINX.

Conhecimento Básico de URLs

Além disso, ter uma ideia de como funcionam URLs ajuda. Por exemplo, saber que site.com/pagina é um pedido que o NGINX pode redirecionar ou reescrever. Não precisa de ser especialista, mas isto facilita.

Permissões Adequadas

No Linux ou macOS, assegure-se de ter permissões de administrador para editar ficheiros (use sudo). No Windows, execute o editor como administrador.

Website de Teste

Por fim, ter um site simples (estático ou dinâmico) pronto para experimentar é útil. Pode usar ficheiros em /var/www/ ou outra pasta.

Portanto, com o NGINX ativo e acesso às configurações, está preparado para configuração URLs NGINX.

Passo a Passo: Como Reescrever URLs no NGINX

Agora, vamos reescrever URLs no NGINX na prática. Este processo é simples, mas requer atenção aos detalhes. Aqui está o guia passo a passo:

Passo 1: Escolher o Ficheiro de Configuração

Primeiro, decida onde aplicar as regras. Se no Ubuntu, edite /etc/nginx/sites-available/seusite.conf (crie um se necessário):

sudo nano /etc/nginx/sites-available/seusite.conf

Ou Windows, use C:\nginx\conf\nginx.conf. No macOS, ajuste /usr/local/etc/nginx/nginx.conf.

Passo 2: Adicionar uma Regra de Redirecionamento Permanente

Em seguida, vamos redirecionar /antigo para /novo permanentemente (código 301). Adicione ao bloco server {}:

server {
    listen 80;
    server_name seusite.local;
    root /var/www/seusite;
    index index.html;

    rewrite ^/antigo$ /novo permanent;
}

^/antigo$: Corresponde exatamente a /antigo.
/novo: Novo destino.
permanent: Indica um redirecionamento 301.

Passo 3: Reescrever URLs sem Redirecionamento

Depois, para reescrever sem mudar o URL no navegador (ex.: /blog para /index.php?page=blog):

rewrite ^/blog$ /index.php?page=blog last;

last: Para o processamento após a reescrita.

Passo 4: Ativar a Configuração

No Ubuntu, ative o ficheiro (se novo):

sudo ln -s /etc/nginx/sites-available/seusite.conf /etc/nginx/sites-enabled/

Passo 5: Testar e Aplicar Mudanças

Agora, teste a sintaxe:

sudo nginx -t

Se estiver correto (“syntax is ok”), recarregue:

sudo nginx -s reload

No Windows, use:

nginx -s reload

Exemplo com Expressão Regular

Para algo mais avançado, reescreva URLs dinâmicas (ex.: /produto/123 para /item?id=123):

rewrite ^/produto/([0-9]+)$ /item?id=$1 last;

[0-9]+: Captura números.
$1: Usa o número capturado.

Portanto, com estes passos, conseguiu reescrever URLs NGINX. Vamos verificar se funciona!

Testar e Verificar a Reescrita de URLs no NGINX

Com as regras aplicadas, é essencial testar. Afinal, reescrever URLs no NGINX só faz sentido se funcionar como esperado.

Aceder ao URL no Navegador

Primeiro, abra o navegador e digite o URL original (ex.: http://seusite.local/antigo). Se configurou um 301, será redirecionado para /novo – o endereço na barra mudará. Para reescritas internas (ex.: /blog), verá o conteúdo de /index.php?page=blog sem alteração visível no URL.

Verificar os Registos do NGINX

Depois, confirme nos registos de acesso:

Ubuntu/macOS: sudo tail -f /var/log/nginx/access.log
Windows: Veja C:\nginx\logs\access.log

Procure por entradas como GET /antigo seguida de 301 ou 200, dependendo da regra.

Testar com Ferramentas

Além disso, use ferramentas como curl para detalhes:

curl -I http://seusite.local/antigo

Verá o código de resposta (ex.: 301 Moved Permanently).

Resolver Erros

Se aparecer “404 Not Found”, confirme que o destino (ex.: /novo) existe. Para “500 Internal Server Error”, reveja a sintaxe com nginx -t. Veja Como resolver problemas comuns do NGINX se precisar de ajuda.

Testar Múltiplos Cenários

Experimente URLs adicionais (ex.: /produto/123) para garantir que as expressões regulares funcionam.

Portanto, os seus NGINX redirecionamentos estão ativos. Pode usar hosts virtuais para organizar – veja Como configurar hosts virtuais no NGINX.

Dicas Avançadas para Reescrever URLs no NGINX

Com a reescrita a funcionar, aqui estão dicas para ir além:

Usar Expressões Regulares Complexas

Primeiro, refine as regras. Para remover /old/ de qualquer URL:

rewrite ^/old/(.*)$ /$1 permanent;

(.*): Captura tudo após /old/.

Redirecionar Domínios Inteiros

Depois, redirecione oldsite.com para newsite.com:

server {
    listen 80;
    server_name oldsite.com;
    return 301 $scheme://newsite.com$request_uri;
}

Evitar Loops

Para prevenir redirecionamentos infinitos, use condições:

if ($request_uri !~ "^/novo") {
    rewrite ^/antigo$ /novo permanent;
}

Melhorar SEO

Adicione cabeçalhos personalizados:

return 301 $scheme://seusite.local/novo$request_uri;
add_header X-Robots-Tag "index, follow";

Otimização

Para desempenho, veja Como otimizar o desempenho do NGINX.

Assim, personalizar URLs NGINX fica mais robusto e eficiente.

Perguntas Frequentes Sobre Reescrever URLs no NGINX

Aqui estão respostas a dúvidas comuns sobre reescrever URLs no NGINX:

Qual a diferença entre ‘rewrite’ e ‘return’?

Rewrite reescreve internamente ou redireciona, enquanto return só redireciona (mais rápido para 301/302).

Porquê “500 Internal Server Error”?

Provavelmente, sintaxe errada – teste com nginx -t.

Posso reescrever URLs dinâmicas?

Sim, use expressões regulares como ^/produto/([0-9]+)$.

Afeta o SEO?

Sim, redirecionamentos 301 preservam o ranking – evite 302 para mudanças permanentes.

E se o redirecionamento não funcionar?

Verifique os registos e consulte Como resolver problemas comuns do NGINX.

Portanto, este tutorial reescrever URLs cobre tudo o que precisa.

Conclusão

Reescrever URLs no NGINX é uma habilidade prática e poderosa. Neste guia, descobrimos o que significa, como configurar regras e como testá-las, tudo com exemplos claros para iniciantes. Agora, pode melhorar a usabilidade dos seus sites, otimizar SEO e gerir URLs com confiança. Além disso, as dicas avançadas e links para outros tutoriais, como Como otimizar o desempenho do NGINX ou Como configurar hosts virtuais no NGINX, abrem portas para mais personalizações. Se algo falhar, Como resolver problemas comuns do NGINX está aqui para ajudar. Continue a experimentar e transforme o NGINX numa ferramenta essencial para os seus projetos!

Pode fazer uma doação para ajudar a mater o site, Obrigado!