O que esta ferramenta faz
O Gerador de .htaccess escreve um arquivo de configuração do Apache para as tarefas mais comuns: forçar HTTPS, escolher entre www.example.com e example.com, redirecionamentos permanentes 301, página 404 personalizada, compressão gzip, cache do navegador, cabeçalhos de segurança, CORS, proteção contra hotlink de imagens e um fallback para single-page apps.
Cada recurso é uma chave. O arquivo é atualizado conforme você muda as opções, vem com comentários curtos explicando cada bloco e envolve as regras específicas de módulos em <IfModule>, para que o site continue funcionando quando algum módulo não estiver disponível.
Como usar
- Informe o seu Domínio (necessário para as regras de www e de hotlink).
- Ative os recursos que você quer. Forçar HTTPS e Prefixo www são combinados em um único redirecionamento, para que os visitantes nunca sejam redirecionados duas vezes.
- Adicione Redirecionamentos 301 como pares
old newseparados por;, por exemplo/old-page /new-page; /blog https://blog.example.com. - Copie o resultado ou clique em Baixar para salvá-lo como
.htaccess. - Envie-o para a raiz de documentos do seu site e teste algumas URLs, de preferência primeiro em um servidor de homologação.
Exemplo
Forçar HTTPS e remover o www para example.com gera:
<IfModule mod_rewrite.c>
RewriteEngine On
# Force HTTPS and remove www
RewriteCond %{HTTPS} off [OR]
RewriteCond %{HTTP_HOST} !^example\.com$ [NC]
RewriteRule ^ https://example.com%{REQUEST_URI} [L,R=301]
</IfModule>
Dicas
- Redirecionamentos 301 ficam em cache no navegador. Durante os testes, use uma janela anônima ou limpe o cache.
- Ative o HSTS (parte dos cabeçalhos de segurança quando o HTTPS é forçado) só depois que o HTTPS funcionar em todos os subdomínios.
- Use o fallback para single-page app em aplicações React, Vue ou Angular com roteamento no lado do cliente.
Perguntas frequentes
› Onde coloco o arquivo .htaccess?
Na raiz de documentos do seu site (a pasta que contém o index.html ou index.php) em um servidor Apache. As regras também valem para todas as pastas abaixo dela.
› Isso funciona no Nginx?
Não. O .htaccess só é lido pelo Apache e por servidores compatíveis, como o LiteSpeed. O Nginx precisa das mesmas regras escritas na sua própria configuração de servidor.
› Por que recebo um erro 500 depois de enviar o arquivo?
Geralmente algum módulo usado pelo arquivo não está habilitado. Cada bloco fica dentro de <IfModule>, mas regras do mod_rewrite e Options -Indexes ainda podem falhar quando a hospedagem as proíbe via AllowOverride. Remova as seções uma a uma para encontrar o culpado.
› Como escrevo os redirecionamentos?
Informe pares de caminho antigo e URL nova separados por ponto e vírgula, por exemplo /old /new; /blog https://blog.example.com. Cada par vira um redirecionamento permanente 301.