Ir para o conteúdo

Conversor htaccess para Nginx

Converta regras Apache .htaccess numa configuração Nginx equivalente.

Entrada
Saída

Conversor htaccess para Nginx

Cole o conteúdo de um ficheiro Apache .htaccess e esta ferramenta reescreve as regras para a configuração Nginx mais equivalente. É construída para programadores que estão a migrar um site de Apache para Nginx (ou a configurar um ficheiro Nginx correspondente para desenvolvimento local) que não querem traduzir manualmente cada linha RewriteRule e RewriteCond.

As opções permitem ativar ou desativar cada família de regras independentemente. RewriteRule e RewriteCond tornam-se directivas rewrite com um bloco if para a (única) condição anterior, correspondendo a flags comuns como R=301, L, NC, F e G. Redirect e RedirectMatch tornam-se blocos location que devolvem o código de estado correto. ErrorDocument torna-se error_page, as directivas Header tornam-se add_header, e ExpiresDefault/ExpiresByType tornam-se directivas expires numa localização correspondente à extensão de ficheiro. O controle de acesso (Order, Deny/Allow, Require) torna-se allow/deny, e um bloco AuthType Basic completo torna-se auth_basic mais auth_basic_user_file. Também pode encapsular todo o resultado num bloco server ou location, pronto para colar numa configuração Nginx.

Apache e Nginx não fazem correspondência um-a-um — algumas construções (múltiplas RewriteConds com AND, a flag OR, códigos de redirecionamento personalizados, Header unset, regras Expires por MIME sem extensão correspondente) não têm equivalente direto em Nginx. Quando o conversor encontra uma destas, deixa a linha original no lugar como um aviso comentado em vez de adivinhar, portanto nada é silenciosamente perdido ou fica silenciosamente incorrecto; desative os avisos depois de os ter revisto se quiser um ficheiro limpo.

Tudo é executado localmente no seu navegador — a configuração do seu servidor nunca é enviada para qualquer lugar, o que é importante uma vez que um ficheiro .htaccess pode revelar caminhos internos e regras de acesso. Copie o resultado, transfira-o como ficheiro .txt, ou envie-o directamente para a entrada de outra ferramenta para continuar a refiná-lo.

FAQ

Esta ferramenta produz uma configuração Nginx completa e pronta a usar?
Produz as directivas equivalentes, mas Nginx e Apache não fazem correspondência um-a-um — reveja sempre a saída, especialmente tudo marcado com um comentário de aviso, antes de colocar em produção.
O que acontece às regras sem equivalente direto em Nginx?
São deixadas na saída como uma linha comentada explicando que é necessária revisão manual, em vez de serem silenciosamente descartadas ou convertidas incorretamente. Desative "Mostrar avisos" para as omitir completamente.
Consegue converter cadeias de RewriteRule com múltiplas condições?
Uma única RewriteCond acima de uma RewriteRule é convertida num bloco if. Múltiplas condições com AND ou a flag OR não têm equivalente limpo em Nginx e são sinalizadas como aviso em vez de serem adivinhadas.
Consegue processar autenticação básica?
Sim — um bloco AuthType Basic / AuthName / AuthUserFile / Require valid-user completo converte-se em auth_basic e auth_basic_user_file. AuthType Digest não tem equivalente em Nginx e é sinalizado.
O meu ficheiro .htaccess é carregado para algum lugar?
Não. A conversão é executada inteiramente no seu navegador — a configuração do seu servidor, incluindo quaisquer caminhos ou regras de acesso que revele, nunca sai do seu dispositivo.